Verification Before Completion Skill logo

Verification Before Completion Skill

開く

Superpowers の完了前検証スキル。証明となるコマンドを実行して出力を読むまで、エージェントに「完了」や「テスト合格」と言わせません。証拠が先、主張は後です。

共有:
代替ツールを見る

Verification Before Completion は Superpowers のスキルです(スキルのソース)。エージェントが作業の完了、修正済み、合格を主張しようとするとき、つまりコミットやプルリクエストの前に起動します。ルールは短く、常に証拠が主張より先です。

鉄則は「新しい検証の証拠なしに完了を主張しない」。このメッセージの中でコマンドを実行していなければ、合格とは言えません。

主な機能

  • ゲート手順:主張を証明するコマンドを特定し、改めて完全に実行し、出力と終了コードを読み、そのうえで証拠付きで結果を述べる。
  • 主張の対応表:「テスト合格」には失敗 0 のテスト実行が必要。「ビルド成功」にはビルドの終了コード 0 が必要で、リンターの合格では不十分。「バグ修正済み」には元の症状の再確認が必要。
  • 回帰テストの証明:テストを書いて実行し、修正を戻して失敗を確認し、元に戻して合格を確認。
  • 委任のルール:サブエージェントが成功を報告しても、報告前に自分で VCS の差分を確認。
  • 危険な言葉:「はず」「たぶん」「ようだ」、早すぎる「完璧!」「完了!」はすべて停止の合図。

使用シナリオ

  • コミット、プルリクエスト、「タスク完了」の前の最後の一歩。
  • 別のエージェントが返した作業の確認。
  • 楽観的な要約が紛れ込みやすい長い自律セッション。

料金

MIT ライセンスの無料オープンソースです。Superpowers を開発する Prime Radiant は企業向けに商用サポートを提供しています。実質的なコストはトークンで、プロセス系スキルは質問、レビュー、サブエージェントの実行を増やします。

はじめに

Superpowers は一つのプラグインとしてインストールされ、このスキルはライブラリ全体(v6.4.1 で 15 スキル)と一緒に入ります。Claude Code では /plugin install superpowers@claude-plugins-official。Cursor は /add-plugin superpowers、Gemini CLI は gemini extensions install https://github.com/obra/superpowers。Codex、GitHub Copilot CLI、OpenCode、Pi などのコマンドは README にあります。スキルは自動で起動し、名前を指定して呼び出すこともできます。 効果はエージェントの最終メッセージに表れます。結果に、それを証明するコマンドと件数が添えられます。

制約:大きなプロジェクトでは主張のたびにテストスイート全体とビルドを走らせるのに時間がかかります。見た目のデザインのように実行できるチェックがないものは検証できません。

よくある質問

TDD とは違いますか?

違います。TDD はコードの書き方を、このスキルは書いた後にエージェントが主張してよいことを縛ります。

途中経過の報告にも適用されますか?

はい。成功をほのめかす言い方はすべて対象です。

代替案

  • Unlazy:受け入れゲートを実行可能なチェックにする。
  • Claude Hooks:指示ではなくシェルフックでチェックを確実に強制。
  • Requesting Code Review:検証の後にもう一人の目を入れる。

まとめ

エージェントに最も多い失敗、終わっていないのに「完了」と言う問題を直す小さなスキルです。詳しくは skills カテゴリ へ。

コメント

まだコメントがありません。最初のコメントを投稿してください!