源码系统概览
文章正文
HERO 是一份给 AI 编程助手用的反过度防御契约。名字来自四个字母:Hashing(哈希)、Edge cases(边界情况)、Rubrics(机械判断)、Overbuild(过度建设),正好是编码 agent 最容易过度防御的四种形状。
你让它写个功能,它给你造了座堡垒,然后功能一直没写完。这个仓库把这句吐槽变成了一段可以直接粘进 agent 配置文件的规则文本,让 agent 把力气花在被要求的那件事上,而不是花在证明自己不会被追责上。
源码简介
仓库主体是一份契约文本 RULES.md,中英各一份,共九条规则,另附三处确实不好划的边界,以及一份去掉全部例子、体积约一半的精简版。除契约本体外还有三个目录。
cases/ 收录观察到的过度防御案例,每条都按四个字段写成:要求是什么、agent 做了什么、为什么不成比例、正确该怎样。hosts/ 说明这段文本该粘到哪个文件,Claude Code 与 Codex 读 AGENTS.md,Copilot 读 .github/copilot-instructions.md,Cursor 读 .cursorrules。examples/ 收录贡献者为自己项目写的真实配置,供你参考写法。
安装只有一条 shell 命令,它直接读取远程 RULES.md 并追加到你的配置文件,不写临时文件、不覆盖原有内容,重复执行也不会重复追加。项目采用 MIT 协议。
适用场景
适合长期用 AI 编程助手写代码的开发者,尤其是会把任务交给 agent 跑过夜的人。无人值守的长跑里过度防御最贵,典型症状是一整夜的工作、一份完整的审计轨迹、零个功能。
也适合把第二个模型当审阅者的工作流。一个被要求做对抗性审阅、拿到仓库访问权、还被要求提修法的 reviewer,是案例库里这些行为最高产的来源。团队想统一 agent 的输出风格,把这份契约放进项目根目录会自动加载的配置文件即可。
功能亮点
九条规则各有分工:禁止加没有代码会读的哈希与校验和;禁止为这里不会发生的情况加 feature flag、迁移框架、兼容层和包装层;禁止把判断换成评分表、检查清单,或对已经定论的东西反复重跑校验。
契约只约束修法,不约束寻找,真问题照样要报,包括听起来罕见但项目自己会产生的情况。仓库还专门列了两种看起来像过度防御、实际该报的反例,避免按字面读规则读错。
截图与演示说明
仓库自带两张配图。首图是 HERO 主题图,四个字母各由它所指的东西砌成:H 是刻着哈希的石块,E 是带雉堞的设防城墙,R 是打满勾叉的评分网格,O 是施工脚手架。
背后是一座没盖完的小屋,外面围着一圈又一圈盖得极其完整的要塞,正是过度防御这件事的写照。第二张是项目交流群的微信群二维码,与 ARIS 社区共享,二维码每周轮换。
技术架构与部署指南
技术栈与运行环境
载体:纯文本规则块(Markdown),无编译、无依赖
适配 host:Claude Code、Codex、Antigravity、Cursor、GitHub Copilot、Windsurf、Gemini CLI
配置文件:CLAUDE.md、AGENTS.md、.github/copilot-instructions.md、.cursorrules
安装方式:一条 shell 命令追加,直接读取 RULES.md,不落地第二份拷贝
运行环境:无,不需要安装任何东西,也没有版本号要跟
安装与部署提示
第一步,确认你的 agent 会自动加载哪个配置文件,对照 hosts/ 目录的说明找到对应文件名。第二步,把快速开始里的那段命令跑一遍,它是纯追加操作,原有内容一个字都不会动,跑第二次也不会发生任何事。
第三步,把文件放在 agent 会自动加载的地方,而不是唤起才读的那一份。恰恰在整夜无人值守的长跑里没人替你唤起,而那正是这个毛病最贵的时候。
如果之前粘过旧版本,需要先删掉旧的标记段落再重跑,因为防重复追加的保护同时也会拦住替换。嫌完整版太长可以改用精简版,九条规则不变,只去掉负责校准的例子。
常见问题
问:需要安装什么吗?答:不需要,它就是一段纯文本,没有依赖也没有版本。
问:支持哪些编程助手?答:Claude Code、Codex、Antigravity、Cursor、Copilot、Windsurf、Gemini CLI,以及任何会自动加载配置文件的 agent。
问:案例库会被 agent 加载吗?答:不会,这是刻意的。案例库是你在 agent 坚持某个加固有必要时,按 ID 甩回去用的东西。
问:它会让 agent 少干活吗?答:不会,每条规则都是为了把力气花在被要求的那件事上,真问题照样要报。
问:最坏会怎样?答:对一个你已有的配置文件,它能造成的最坏后果就是在末尾多出一段文本,不写临时文件也不覆盖。
安全风险提示
这份契约会放宽 agent 的防御性提议,在有真实对手的场景里需要谨慎。规则一写得很清楚:如果项目确实存在威胁模型,就以那个范围为准,不要用它去压制合理的安全加固。
规则六也留了底线:用户、项目自身约定或更高优先级规则明确要求的安全、迁移、校验与审阅,永远不算范围外。另外它只是可被推翻的自然语言配置,不是强制开关,更强的系统指令可以盖过它,把它用在生产代码上时审阅环节不应省略。
下载说明
本仓库为开源项目,内容以 Markdown 规则文本为主,不含可执行程序,下载后按上文步骤粘贴到你的 agent 配置文件即可使用。请遵守 MIT 协议,二次分发时保留原作者与许可声明。
资源仅供学习与技术研究使用,把契约用于实际项目前请先在小范围验证效果,确认它对你常用的模型和 host 确实起作用。
GitHub项目开源地址:https://github.com/wanshuiyin/HERO-Anti-OverDefense