verification-before-completion

完了前の検証

概要

検証せずに作業が完了したと主張するのは、効率的なのではなく不誠実です。

基本原則： 常に、主張より先に証拠を示します。

このルールの文言に反することは、このルールの精神に反することです。

このスキルは、完了を主張する前に必ず検証することを徹底し、誤検出、ビルドの失敗、信頼の損失を防ぎます。

このスキルを使用するタイミング

次のことを主張する前に、必ず有効にしてください。

• 成功、完了、満足（「完了です！」「修正しました！」「よかったです！」）
• テスト合格、リンターの問題なし、ビルド成功
• コミット、プッシュ、PR の作成
• タスクの完了扱いや、エージェントへの委任

特に次のような場合に使用してください。

• 時間に追われているときや、疲れているとき
• 「簡単な修正」で明らかに思えるときや、自信があるとき
• エージェントが成功を報告したときや、テストが「通るはず」と思うとき

厳格なルール

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

このメッセージにある検証コマンドを実行しなければ、成功を主張することはできません。

基本原則

1. 証拠が必要：すべての主張には裏付けとなる証拠が必要です
2. 新たに検証する：以前の実行結果に頼らず、今すぐ検証する必要があります
3. 完全に検証する：部分的なチェックではなく、コマンド全体を実行します
4. 正直に報告する：期待する状態ではなく、実際の状態を報告します

クイックスタート

5 段階のゲート機能：

1. 特定する：この主張を証明するコマンドは何ですか？
2. 実行する：コマンド全体を実行します（新たに、最後まで）
3. 読む：出力全体を読み、終了コードを確認し、失敗数を数えます
4. 検証する：出力は主張を裏付けていますか？
   • いいえ：証拠とともに実際の状態を述べます
   • はい：証拠とともに主張します
5. その後にのみ：主張します

手順を一つでも省略すれば、検証ではなく嘘になります。

主なパターン

正しいパターン：

✅ [Run pytest] [Output: 34/34 passed] "All tests pass"

誤ったパターン：

❌ "Should pass now"
❌ "Looks correct"
❌ "Tests were passing"
❌ "I'm confident it works"

危険信号 — 直ちに停止してください

次のような場合は停止してください。

• 「はずです」「おそらく」「そう見えます」と言っている
• 検証する前に満足を表明している
• 検証せずにコミット、プッシュ、PR をしようとしている
• エージェントの成功報告を信用している
• 部分的な検証に頼っている

これらはすべて、停止して、まず検証を実行すべきという合図です。

これが重要な理由

実際の失敗事例に基づく統計：

• 検証にかかる時間：2 分
• 復旧にかかる時間：120 分以上（60 倍のコスト）
• 検証されていない「完了」の主張の 40% で、手直しが必要になりました

重大な違反：「嘘をつけば、取って代わられる」

ナビゲーション

詳しくは、以下を参照してください。

• ゲート機能：判断ツリーを含む、5 段階の検証プロセス全体
• 検証パターン：テスト、ビルド、デプロイなどにおける正しい検証パターン
• 危険信号と失敗：よくある失敗の形、危険信号、および所要時間とコストのデータを含む実例
• 統合とワークフロー：他のスキルとの統合、CI/CD パターン、エージェントへの委任ワークフロー

要点

検証に近道はありません。

コマンドを実行します。出力を読みます。その後で、結果を主張します。

これは譲れないルールです。