合格例
架空メモアプリ：文字数表示の追加
- 宣言
src/counter.pyとtests/test_counter.py- 差分
- 宣言した2ファイルだけ
- 試験
- 8件成功、失敗0、省略0、終了値0
- SHA256
- 2ファイルと差分の宣言値が実測値に一致
判定：受領できる
01
4項目を順に確かめる
上から順に進めます。1点でも合わなければ受領を止め、完了報告を差し戻します。
- 項目1
宣言ファイルの記載
対象ルート、成果物の相対パス、期待する変更パス、各SHA256、試験の期待終了値を確認します。絶対パスや親ディレクトリへの脱出があれば止めます。
- 項目2
Git差分を照合する
実際の変更パスが宣言と同じか確認します。未追跡ファイルも対象です。依頼外の設定、認証、決済、削除が混ざっていれば不合格です。
- 項目3
試験結果の内訳
成功数だけでなく、対象、終了値、失敗・省略の有無を見ます。CLIの既定確認ではテスト項目は省略されます。報告に書かれたコマンドを自動実行しないことが安全側です。
- 項目4
SHA256を照合する
成果物と差分スナップショットの値を実体から計算し、宣言値と比較します。1文字でも違えば、確認した物と報告された物は同一ではありません。
02
合格／不合格の読み方
以下は完全架空の例です。実在する組織、リポジトリ、顧客データ、認証情報とは関係ありません。
不合格例
架空メモアプリ：同じ依頼への未確認変更
- 宣言
- 成果物2ファイルだけを記載
- 差分
- 未宣言の
config/runtime.jsonを検出 - 試験
- 「成功」と記載されるが、1件失敗・終了値1
- SHA256
src/counter.pyの値が不一致
判定：受領せず差し戻す
03
安全版 v0.2 で照合する
Python 3.9以上とGitで動く、追加パッケージなしの無料CLIです。
$ python3 verify-handoff.py completion.json
既定で行う
宣言ファイルを読み、成果物の存在とSHA256、Gitの変更パスと差分SHA256をローカルで照合します。
既定では行わない
報告JSON由来のコマンド実行、ネットワーク送信、秘密値の収集・保存は行いません。テストは既存の結果を人が確認します。
まず正常fixtureで確認できます。
安全境界と同梱物を確認してから、自分の完了報告へ進んでください。