Community研究&データ分析github.com

mohamedzhioua/agent-done-or-not

AIエージェントが「完了」と嘘をつくのを防止します。Claude Code、Cursor、Codex向けの単一ファイルの証明ゲートです。タスク完了を報告する前に検証を必須化します。

agent-done-or-not とは?

このスキルは、AIエージェントが「タスク完了」と誤って報告するのを防ぐための証明ゲート(proof gate)を提供します。Claude Code、Cursor、Codexなどの主要AIエージェント開発環境に対応しており、エージェントがユーザーに作業完了を報告する前に、実際に検証可能な証拠(テスト、ビルド、型チェック、lint、curlによるエンドポイント確認など)を実行し、その結果を記録することを強制します。`done-gate.sh capture` コマンドを使用して検証コマンドを実行し、終了コードと出力のSHA-256ハッシュを保存します。ゲートは失敗した検証を通過させず、エージェントが「未検証の完了」を報告することを防止します。特に自律型AIエージェントにおいて、不正な完了報告を防ぎ、作業の信頼性を大幅に向上させます。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add mohamedzhioua/agent-done-or-not

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

done-or-not

使用するタイミング

このスキルは、タスク、ビルド、テスト、修正、または検証ステップが完了したとユーザーに伝えようとするときはいつでも使用します。完了の主張には、自信や記憶ではなく、ゲートによる証明が必要です。

使用方法

  1. 作業を証明するコマンドを特定します。主張を実際に検証する最小のチェック(テスト、ビルド、型チェック、lint、実行中のエンドポイントに対する curl、または意味のある成功/失敗の動作を持つその他のコマンド)を選択します。

  2. 検証コマンドを証明ゲートを通じて実行します。

    bash done-gate.sh capture --label check -- <検証コマンド>
    

    ゲートはコマンド、その終了コード、および出力のSHA-256ハッシュを記録します。コマンド自体の終了コードで終了するため、失敗したチェックはキャプチャも失敗します。

  3. 新しく成功した(PASSINGの)レシートが存在する場合にのみ、作業完了を報告します。

  4. チェックが失敗した場合は問題を修正し、再度キャプチャします。赤(失敗)のチェックで成功を報告しないでください。

ストップゲートは、ハーネスがサポートする環境でこのルールを強制します。エージェントがターンを終了するのをブロックし、新しい成功レシートが存在するまで終了を許可しません。ゲートを回避しようとせず、証明を生成してください。

関連スキル