mcpField
S
sweep-verification

sweep-verification

github.com/kucherenkoテスト・品質8542 回インストール1 日前に更新
リポジトリ

sweep-verification について

完了や正しさを報告する前に、完全な検証を実行して出力を確認するエージェント向けスキルです。

主な機能

  1. 01新しい検証結果を必須化
  2. 02完全な検証コマンドを実行
  3. 03出力、終了コード、失敗数を確認
  4. 04テスト、ビルド、要件確認を区別

活用シーン

  1. 01テストやビルドの状態を報告する前
  2. 02コミット、プッシュ、PR作成の前
  3. 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 への準拠

  • 真実のルール:すべての主張が最新のコマンド出力で裏付けられている
  • 可用性のルール:検証出力が会話内に保持されている

コメント