wanshuiyin/HERO-Anti-OverDefense

解決する問題

機能を構築するように依頼された AI コーディングアシスタントは、機能自体ではなく防御的な作業に労力を費やすことがあります。誰も読まないチェックサムを追加したり、ここでは発生しないエッジケースに対する防御を強化したり、判断を採点チェックリストで置き換えたり、誰も求めていない将来のための足場を構築したりします。著者はこれを、エージェントが「仕事が良いこと」ではなく「非難されないこと」を最適化していると説明しています。このプロジェクトは、そのような行動を制限するためにエージェントの設定ファイルに貼り付ける短いルールブロックです。

仕組み

リポジトリには、英語と中国語で提供される 9 つのプレーンテキストルールを含むブロック（RULES.md）が含まれており、エージェントが自動的に読み込む任意のファイル（CLAUDE.md、AGENTS.md、.github/copilot-instructions.md、.cursorrules など）に貼り付けます。ルールは、「実際に問題があるものを報告する」ことと「ここで発生しないものに対する防御を構築しない」ことの境界を明確にします。過剰防御の 4 つのカテゴリ（ハッシュ、エッジケース、ルーブリック、過剰構築）と、過剰修正と呼ばれる関連カテゴリを指定しているため、雰囲気について議論する代わりに、発生した行動を正確に指定できます。別の cases/ カタログには、観察された行動（何が求められたか、エージェントが何をしたか、なぜ過剰だったか、適切な対応はどのようなものか）が記録されています。これは貼り付けるものではなく、エージェントが議論したときにケース ID で引用するものです。オプションの Goal Pulse スキルと、Codex の長時間実行ゴール用のタイマーは、メインエージェントに、30 分ごとに完了した作業の収集とブロッカーの処理を継続するよう促します。コマンドラインインストーラーはブロックを追加します（2 回実行しても何も起こらないようにガードがあります）。ブロックは RULES.md を直接読み取るため、同期が失われることはありません。

対象読者

自分のプロジェクトでコーディングエージェントを実行している人（Claude Code、Codex、Antigravity、Cursor、GitHub Copilot、Windsurf、Gemini CLI、または設定ファイルを自動的に読み込む任意のツール）で、エージェントがタスクではなく防御的な作業に時間とトークンを浪費するのを見たことがある人。README は、これがスイッチではないことを正直に述べています。コミュニティの最も一致した期待は「少し役立つ」であり、一部の実行では依然として防御が強化されるでしょう。また、ルールはエージェントが提案することを制限するものであり、検索することを制限するものではないことも明確です。依頼した実際のセキュリティ、移行、検証、レビュー作業は常に優先されます。

ハイライト

• コアブロックはインストールやランタイムバージョンを必要としません。エージェントが自動的に読み込む任意のファイル内のプレーンテキストであるため、リストされているすべてのホストで動作し、おそらくそれ以上でも動作します。
• 4 つの認識可能な形状（ハッシュ、エッジケース、ルーブリック、過剰構築）と関連カテゴリがあり、それぞれに具体的なキャリブレーション例が含まれています。報告すべき「過剰防御のように見えるが、そうではない」という 2 つの反例も含まれます。
• 同じ 9 つのルールを含む短いバージョンで、スペースが限られている設定用にサイズが約半分です。
• ケースカタログでは、有用なエントリには苦情だけでなく「適切な対応はどのようなものか」を含める必要があり、反例は明示的に歓迎されます。
• ブロックには、実際の発見と過剰防御を区別するテストが含まれています。「これはどの特定の障害を検出し、それが発生した場合に私は何を異なる方法で行うか？」