wanshuiyin/HERO-Anti-OverDefense

它解决的问题

AI 编码助手在构建功能时，有时会将精力花在防御性工作上，而不是功能本身：添加无人阅读的校验和、针对此处不可能发生的边缘情况进行加固、用评分清单取代判断、为无人要求的未来构建脚手架。作者将此描述为代理优化“不被指责”而非“工作做得好”。这个项目是一个简短的规则块，你可以粘贴到代理的配置文件中，以约束这种行为。

工作原理

该仓库提供了一个规则块（RULES.md），包含九条纯文本规则，提供英文和中文版本，你可以将其粘贴到代理自动加载的任何文件中——CLAUDE.md、AGENTS.md、.github/copilot-instructions.md、.cursorrules 等。这些规则划清了“报告任何实际错误”和“不要针对此处不会发生的事情构建防御”之间的界限。它们命名了四类过度防御——哈希、边缘情况、评分标准、过度构建——以及一个名为过度纠正的同类，因此你可以准确指出刚刚发生的行为，而不是争论感觉。一个单独的 cases/ 目录记录了观察到的行为（要求了什么、代理做了什么、为什么不成比例、相称的做法是什么）；你不需要粘贴该目录——当代理争辩时，你可以按案例 ID 引用它。一个可选的 Goal Pulse 技能和计时器，用于 Codex 长时间运行的目标，提醒主代理每 30 分钟继续收集已完成的工作并处理障碍。一个命令行安装程序会追加该规则块（带有保护，因此运行两次不会产生任何效果），并且该规则块直接读取 RULES.md，因此永远不会失去同步。

适用人群

适用于在自己的项目上运行编码代理的人——Claude Code、Codex、Antigravity、Cursor、GitHub Copilot、Windsurf、Gemini CLI 或任何无需询问即可加载配置文件的工具——并且他们见过代理在防御性工作上浪费时间和令牌，而不是专注于任务。README 诚实地指出这不是一个开关：社区最一致的期望是它“有一点帮助”，有些运行仍然会加固。它还明确指出，这些规则旨在限制代理提出的建议，而不是限制其搜索的内容——你要求的真实安全、迁移、验证或审查工作始终优先。

亮点

• 核心规则块无需安装或运行时版本：它是你代理自动加载的任何文件中的纯文本，因此适用于所有列出的主机，可能还有更多。
• 四种可识别的形状（哈希、边缘情况、评分标准、过度构建）加上一个同类类别，每个都有具体的校准示例——包括两个“看起来像过度防御，但实际上不是”的反例，你应该报告。
• 一个简短版本，包含相同的九条规则，大小约为一半，适用于空间不足的配置。
• 一个案例目录，其中有用的条目必须包含“相称的做法是什么”，而不仅仅是抱怨，并且明确欢迎反例。
• 该规则块包含区分真实发现与过度防御的测试：“这能检测到什么具体故障，如果发生，我会采取什么不同的做法？”