HERO 治 AI 过度设计的技能让它别再造堡垒

一、先说这东西到底治什么病

你让 AI 写个"把两个 Excel 对比一下，把差异合并"的小需求，它回来时交给你一套东西：行级哈希校验、三套兼容分支、一个配置开关、两份回归测试、外加一个 migration 框架。你翻到底才想起来——它压根没做对比这件事。

这不是偶发的翻车。wanshuiyin 把这类行为收拢成一个项目，叫 HERO-Anti-OverDefense，中文名"反过度防御"。它的开场白就一句话：你让它写个功能，它给你造了座堡垒，然后功能一直没写完。

作者对成因给了一个很清醒的定性——这些行为看起来像 agent 在优化"不被追责"，而不是"活儿干得好"。他特意注明这是一个能解释观察的假说，不是关于模型怎么训练出来的定论。但没有停在病因上纠缠，而是把症状拆成了四类，四个英文首字母正好拼成 HERO：

H 是 Hashing，哈希。加了没人读的校验值、到处写 SHA256 文件，把一次普通比较变成全表扫描。

E 是 Edge cases，边界情况。为一个这个项目根本产生不了的场景，加一层兼容、加一个分支。

R 是 Rubrics，把判断换成机械流程。该拍板的地方，它给你一张评分表、一份清单、一轮已经确认过的复验。

O 是 Overbuild，过度建设。功能开关、迁移框架、兼容层、包装器，为不存在的需求提前搭架子。

给这四类起了名字，好处很实在：下次你觉得"好像有点过了"，可以直接说"刚才犯的是 O"，而不是空对空争"是不是太谨慎了"。

二、它怎么用

它不是一个要装的东西，本质是一段文本——粘进你 AI 编程工具每次都会自动加载的那个配置文件里。Claude Code 用 CLAUDE.md，Codex 用 AGENTS.md，GitHub Copilot 用 .github/copilot-instructions.md，Cursor 用 .cursorrules。作者把各家放哪写进了 hosts 目录，一查就知道。

粘进去的那段叫 SCOPE LIMITS，九条，核心意思几条：

第一条直接限定一件事——这不是安全论文，欢迎验证，不欢迎过度防御。除非项目自己说了有真实对手，否则默认操作者是善意的、在自己机器上。

第二条卡哈希：不要加哈希、校验和、指纹，除非这个哈希能替掉一个明显更贵的操作，并且它的结果会改变后面发生什么。两条必须同时成立，缺一条就不该加。

第四条把"边界情况"的边界划清楚了：异常编码、符号链接竞态、从右到左文字、毫秒级竞争，都不在范围内——除非这个场景能通过这个项目支持的用法真实到达。它还补了一句很关键的：够得着就够了，你不需要复现它；"理论上能构造"不算。

第五条和第八条是给判断力留位置的：需要判断的地方就判断，别换成评分表、清单或者对已确认事项的复验循环；几条路都合理的时候挑一条并说明取舍，别把菜单端回给用户。最后一句写得很重："为了不选错而拖延，本身就是一次选错。"

第六条规定了一个例外，而且是作者 2026 年 8 月专门补的：这九条永远不覆盖你真正要求过的安全、迁移、验证、审查工作。那些是你点的菜，不是范围蔓延。这条很重要，否则这套规则会被误用成"让 AI 少干活"的许可证。

第七和第九条管的是交付物的样子：最终产出不该是一份防御答辩记录。中间的错误、放弃的方案、修订历史都不是内容；说"别提 X"的意思是 X 不出现，而不是写成"我们没有涉及 X"。

三、它还有两条配套路径

除了这段规则，仓库里还给了两个可选技能，解决 AI 长任务里另外两个真实问题。

一个是 Goal Pulse，目标脉冲。AI 跑长任务时常见的毛病是：派出去的子任务回来了，主 agent 没接、没验、就卡在那儿等整批。这个技能装好后，在你启动或恢复一个 Goal 时默认生效，每 30 分钟提醒一次主 agent 去收已完成的东西、去处理反复卡住的点。Codex 用本地 Python 定时器，Claude Code 用它原生的 /loop。提醒文案是双语的，其中一段写得很直白："以最快的有效速度持续推进当前 Goal，不允许磨洋工、偷懒、空转，或拿计划和汇报代替执行。"

另一个是 Session Handoff，会话交接。上下文被压缩或要换新会话时，把目标、证据、已做的决定、正在做的事、下一步写进项目文件，让下一个会话从这些文件接着干，不用重讲一遍背景。它只靠 Markdown，不需要 Python。

这三条合起来，作者给的定位是：HERO Rules 保住专注，Goal Pulse 保住推进，Session Handoff 保住连续性。

四、最值得看的是它的案例库

仓库里有个 cases 目录，收了各种观察到的行为，每一条写四件事：要求是什么、agent 实际做了什么、为什么这属于过度防御、以及"成比例的做法"长什么样。

举个里面最典型的例子，编号 HERO-H-001：要求是把两个 Excel 对比差异并合并。agent 做了什么呢——给两个文件每一行都算哈希，然后比哈希。问题在于，普通逐格比较本来就能回答问题，哈希没替掉任何更贵的操作，反而多了一整轮全表扫描，加上一道照样要做的比较。一个五分钟的活，干了半小时。

还有 HERO-H-002：做日常开发时，它在机器上到处写 SHA256 文件，事后没有任何代码去读。作者的原话很干净——没人消费的校验值不是验证，是残留物；更糟的是它制造了一种"正在检查完整性"的假象。

但真正让我觉得这个项目靠得住的，是它专门收录了反例。HERO-H-003 记录的是一个哈希真正划算的场景：长会话里反复处理同一批大文件，哈希能让你跳过重复工作——这时候该用。还有 HERO-E-004、HERO-R-004、HERO-R-005，都是因为照字面读规则会误杀真实需求而特意留下的：一个罕见但项目文档自己会产生的 bug、一次本来就该跑的冒烟测试、一轮目的就是"不知道哪里会坏"的大范围回归。

作者还明确说了案例库该怎么用，这点很少见：不要粘进 agent 配置。因为案例库比规则块大好几倍，一个随身带着"这算过度防御"全量示例的 agent，会开始把真实发现往这些例子上套，然后否定掉那些看起来像的——而这恰恰就是这份契约要防的那个失败模式。正确用法是反过来：事后再用。当 agent 坚持某个加固是必要的、而你觉得不是，你把编号报给它，让它说清楚它这次的提议跟那个案例差在哪。这个问题是有答案的，而"我只是谨慎一点"不是答案。

五、它适合谁、不适合谁

适合：已经把 AI 用进日常开发、被"AI 造堡垒"烦过的人；做代码评审的人；需要验收 AI 产出的人。你可以在给 AI 下任务时先把它要做的范围写死——要哪些、不要哪些，做完按这四类过一遍。

不适合：指望它让 AI 变快变强的人。它的作用是砍掉多余动作，不是提升上限。另外作者自己也承认一个限制：长任务跑到后面，这段规则的效力会衰减，原因有三种——有更具体的指令在跟它冲突（重复贴没用）、它还在但被几小时输出埋住了（重复贴有用）、上下文压缩把它稀释了（重新贴有用）。他甚至劝你别设每小时定时重贴，因为上下文是跟着工作量涨的，不是跟着分钟数涨的。

六、项目本身的情况

这是个真在维护的项目，不是玩票。仓库 832 star、31 fork、64 次提交，MIT 协议，最近还在更新——2026 年 11 月先后加了 Session Handoff 和 Codex 版的 Goal Pulse，10 月底还补了 Claude Code 原生 /loop 的支持。它从作者另一个项目 ARIS（约 1.37 万 star）里泛化出来，作者的说法是：ARIS 的跨模型审阅器确实好用，但也把可观的一部分产出花在了"提议加个没人读的哈希"上，HERO 留下价值、去掉税。

装法很简单：先把百度搭子电脑版装上（dumate.baidu.com），然后打开它，把下面这段话整段复制过去发过去：