sweep-verification について
完了や正しさを報告する前に、完全な検証を実行して出力を確認するエージェント向けスキルです。
主な機能
- 01新しい検証結果を必須化
- 02完全な検証コマンドを実行
- 03出力、終了コード、失敗数を確認
- 04テスト、ビルド、要件確認を区別
活用シーン
- 01テストやビルドの状態を報告する前
- 02コミット、プッシュ、PR作成の前
- 03エージェントの完了報告を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ kucherenko/ gangsta --skill sweep-verificationインストール後、Claude Code で/sweep-verificationを入力して読み込まれたか確認します。
詳細
スイープ:完了前の検証
概要
検証せずに作業が完了したと主張するのは、効率的ではなく無効です。
基本原則: 常に、主張より先に証拠を示します。
このルールの文面に違反することは、このルールの精神に違反することです。
鉄則
NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
このメッセージ内で検証コマンドを実行していない場合、合格したと主張することはできません。これは Omerta Law 3 — 真実のルールです。
ゲート
BEFORE claiming any status or expressing satisfaction:
1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
- If NO: State actual status with evidence
- If YES: State claim WITH evidence
5. ONLY THEN: Make the claim
Skip any step = invalid, not verification
よくある失敗
| 主張 | 必要なもの | 不十分なもの |
|---|---|---|
| テストに合格 | テストコマンドの出力:失敗 0 件 | 過去の実行結果、「合格するはず」 |
| リンターに問題なし | リンターの出力:エラー 0 件 | 部分的なチェック、推測 |
| ビルドに成功 | ビルドコマンド:終了コード 0 | リンターの合格、良好に見えるログ |
| バグを修正 | 元の症状を再現するテスト:合格 | コードを変更したこと、修正済みとの思い込み |
| 回帰テストが機能 | Red-Green サイクルの検証 | テストに一度合格したこと |
| エージェントが完了 | VCS の差分で変更を確認 | エージェントの「成功」報告 |
| 要件を満たした | 行ごとのチェックリスト | テストの合格 |
危険信号 — STOP
- 「するはず」「おそらく」「〜のようだ」を使う
- 検証前に満足を表明する(「いいですね!」「完璧です!」「完了です!」など)
- 検証せずにコミット、プッシュ、PR を行おうとしている
- エージェントの成功報告を信頼する
- 部分的な検証に頼る
- 「今回だけなら」と考える
- 検証を実行せずに成功を示唆する表現は、どのようなものでも使用する
合理化の防止
| 言い訳 | 実態 |
|---|---|
| 「これで動くはずです」 | 検証を実行する |
| 「自信があります」 | 自信 ≠ 証拠 |
| 「今回だけなら」 | 例外はありません |
| 「リンターは合格しました」 | リンター ≠ コンパイラー |
| 「エージェントが成功したと言いました」 | 独立して検証する |
| 「部分的なチェックで十分です」 | 部分的なチェックでは何も証明できません |
| 「言い方が違うのでルールは適用されません」 | 文面より精神を重視する |
主要なパターン
テスト:
✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"
回帰テスト(TDD Red-Green):
✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)
ビルド:
✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)
要件:
✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"
エージェントへの委任:
✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report at face value
適用するタイミング
必ず、次の前に適用します:
- 成功または完了を主張する表現のすべて
- 満足を表す表現のすべて
- 作業の状態に関する肯定的な発言のすべて
- コミット、PR の作成、タスクの完了
- 次のタスクへの移行
- エージェントへの委任
このルールの対象:
- 正確な言い回し
- 言い換えや同義語
- 成功を示唆する表現
- 完了または正しさを示唆するあらゆるコミュニケーション
Omerta への準拠
- 真実のルール:すべての主張が最新のコマンド出力で裏付けられている
- 可用性のルール:検証出力が会話内に保持されている
コメント
Markdown 対応