HERO — 反过度防御
一段可粘贴的规则块,终结编码代理的哈希、边界情况、机械判断和过度建设四种过度防御行为。
- Star 数
- ★ 769
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 证据不足
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 用 Claude Code 或 Codex 做无人值守长跑任务的开发者,代理整夜写审计循环而不写功能,需要规则块约束执行方向
- 不适合
- 需要强制执行而非自然语言约束的团队(模型可能不遵守)
- 想通过提示词让代理少干活的用户——本项目的目标是把精力花在正事上
- 依赖已缓存旧版规则块、未重新粘贴的现有用户
这个 Agent 能做什么,适合哪些场景?
HERO 将编码代理的过度防御归纳为四个家族:H(哈希)、E(边界情况)、R(机械判断/清单化)、O(过度建设),并提供一段中英双语的规则块粘贴进代理配置文件(如 CLAUDE.md 或 AGENTS.md)来约束代理行为。仓库包含 RULES.md 契约、带编号的行为案例目录(cases/)、各宿主的粘贴位置指南(hosts/)以及一个可选的 Codex Goal Pulse 技能,每 30 分钟提醒主代理收集成果、处理反复出现的卡点。它不需要安装运行时,核心规则就是纯文本;规则块只约束“修复范围”,不限制代理报告真实缺陷。项目脱胎于 ARIS(约 13.7k 星)的跨模型评审经验,作者自己也承认这只是“有点用”的可被覆盖的自然语言配置,而非强制机制。
核心交付物是 RULES.md 中的 “=== SCOPE LIMITS ===” 文本块,共九条规则:限制哈希/校验和(仅当替代更昂贵操作且结果改变后续行为时才加)、禁止为本项目不出现的输入做加固、禁止用评分表和清单替代判断、禁止为不存在的未来建脚手架、交付文本不得写成辩护词、动量也是交付物的一部分(多个合理方案时选一个并说明取舍)、最终产物不得保留生成与修正痕迹。安装方式是一段 shell 命令:用 grep 检查 CLAUDE.md 是否已含 'scope.limits',再用 curl 拉取 RULES.md 并用 awk 截取该块追加到文件末尾,幂等且只追加不覆盖。配套的 cases/ 目录按 ID(如 HERO-R-006、HERO-O-005、SIB-003、SIB-004)收录已观察行为,供用户在代理坚持某项加固时按 ID 引用反驳;该目录有意不被代理加载。Goal Pulse 技能(skills/goal-pulse/)为 Codex Goal 提供双语定时提醒。
- 用 Claude Code 或 Codex 做无人值守长跑任务的开发者,代理整夜写审计循环而不写功能,需要规则块约束执行方向
- 维护 ML 研究流水线的研究者,代理为每次可恢复失败建永久版本树、给每行数据算哈希,需要按案例目录 ID 反驳
- 同时使用 Codex 和 Antigravity 的团队,两者都读 AGENTS.md,一份文件即可覆盖两个宿主
- 让对抗性评审模型提修改建议的团队,评审者是最典型的过度防御来源,README 建议给评审模型也贴同一块
- 写论文的写作者,代理在每个段落里撒免责声明、在产物里写“我们不处理 X”,需要规则 7 和 SIB 案例
- 配置文件空间紧张的用户,可采用约一半长度的短版本(规则相同、去掉校准示例)
如何安装或部署这个 Agent?
把规则块粘贴进代理自动加载的配置文件——Claude Code 用 CLAUDE.md,Codex 和 Antigravity 用 AGENTS.md,Copilot 用 .github/copilot-instructions.md,Cursor 用 .cursorrules。也可用一条命令追加到 CLAUDE.md(幂等,重复运行不会重复添加):
grep -qi 'scope.limits' CLAUDE.md 2>/dev/null || { printf '\n\n'; curl -sL \
https://raw.githubusercontent.com/wanshuiyin/HERO-Anti-OverDefense/main/RULES.md \
| awk '/^=== SCOPE LIMITS/,/^Say plainly when something is correct/'; } >> CLAUDE.md其他宿主把文件名换成 AGENTS.md 或 .github/copilot-instructions.md 即可。中文规则块见中文 README,其 grep 守卫和 awk 范围需同时修改。
重要:如果在此前任何规则变更之前粘贴过旧块,旧的 “=== SCOPE LIMITS ... ===” 段落已过期——防止重复追加的守卫也会阻止替换,需手动删除旧段落后重新运行。核心规则无需安装任何运行时。可选的 Goal Pulse 技能需单独按 skills/goal-pulse/README.md 安装到 Codex。
如何使用这个 Agent?
核心用法是零操作:规则块放在始终被加载的配置文件里(不要放在需要手动调用的位置——长跑无人值守时没人调用它)。cases/ 目录不被代理加载,是给你自己用的:当代理坚持某项加固必要时,按 ID(如 HERO-R-006)引用对应案例反驳。遇到规则块在长跑中失效时,按 RULES.md 的指引区分三种原因:有更具体的指令在覆盖它、被数小时输出淹没、或上下文压缩稀释了它,再决定是否重复。运行任何检查前自问:这能检测什么具体故障,发生了我会怎么做不同的事?无答案就不运行。Goal Pulse 安装后,启动或恢复 Codex Goal 时默认激活,每 30 分钟发一次双语提醒,暂停的 Goal 保持静默。
这个 Agent 有哪些优点和局限?
- 零安装、零运行时:核心规则是纯文本,适用于任何自动加载配置文件的代理,包括清单未列出的宿主
- 案例目录(cases/)提供了可检查的具体形状和 ID,让“这是过度防御”从感觉之争变成可引用的判断
- 明确划定反向边界:规则约束修复范围而非搜索范围,项目自身文档产生的罕见缺陷和冒烟测试仍会被报告
- 诚实披露局限:作者明确说明它“有点用”、模型可以拒绝遵守,而非夸大为开关
- 约束是可被覆盖的自然语言配置:有报告称代理以更高优先级系统约束为由拒绝遵守
- 规则块在长跑中会失效(被覆盖、被淹没或被压缩稀释),需要用户自行诊断原因并处理
- 在 2026-08-11 之前粘贴的旧块已过期,且幂等安装命令不会自动替换,需手动删除重贴
- 效果依赖模型与提示词:仓库提到部分用户靠换用不同或更早的模型才彻底解决问题
这个 Agent 与同类方案有什么区别?
项目明确脱胎于同作者的 ARIS(Auto-claude-code-research-in-sleep,约 13.7k 星)——ARIS 的跨模型评审器会花可观输出提出无人读取的哈希,HERO 保留了价值、去掉了这部分税负,规则 7 的“新闻稿原则”则改编自 Adkid-Zephyr 的 anti-defensive-writing-Skill。同系列还有 Anti-Autoresearch,把同一方法用于研究诚信。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| HERO — 反过度防御 当前 | 证据不足 | Agent 插件 / 技能免费 | ★ 769 | 3 天前 | Python | Codex · Claude Code |
| CoCo Super Intelligence | 69 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 797 | 3 天前 | Python | Codex · Claude Code |
| 最强 Agent 系统提示词 | 44 · 缺口较多 | — | ★ 882 | 1 天前 | — | ChatGPT · Codex · Claude Code |
| Loop Library: 可复用 AI Agent 工作流库 | 61 · 存在缺口 | Agent 插件 / 技能免费 | ★ 3.2k | 1 个月前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据仅含 README、LICENSE、一个 CI 工作流和 Goal Pulse 测试文件;RULES.md、hosts/、cases/、skills/goal-pulse/scripts/goal_pulse.py 等被引用文件均未提供,无法核实权限、确认、数据流、回滚等实现。README 的安装命令通过 curl 拉取远程 RULES.md 并追加到 CLAUDE.md,属外部网络副作用,但无校验和/签名,且被引用脚本缺失,故全部按缺失计 0。
测试文件显示对 Goal Pulse 的 tick/start/stop 有较细的行为断言(冷却、暂停、锁、替换超时),但被测脚本 goal_pulse.py 与 requirements.txt 未提供,无法确认依赖可用性与失败信息实现;README 自述规则为可被更高优先级指令覆盖的自然语言配置,可靠性有限。证据不足以支撑评分,计 0。
README 声称兼容 Claude Code、Codex、Antigravity、Cursor、Copilot、Windsurf、Gemini CLI,并区分核心规则与可选 Goal Pulse;但 hosts/ 与 RULES.md 缺失,无法核实触发精度、边界与环境适配。计 0。
LICENSE 为完整 MIT(2026 Ruofeng Yang),README 有变更记录与安装说明;但信息架构依赖大量未提供的文件(RULES.md、cases/、hosts/、skills/),版本号与维护责任仅以 README 叙述,发布者身份未经验证。整体证据不足,计 0。
README 对四类过度防御(Hashing/Edge cases/Rubrics/Overbuild)有清晰定义与示例,并给出短版本与粘贴块;但核心 RULES.md 与案例目录缺失,无法评估实际输出可用性与边际价值。计 0。
README 引用 PR、案例编号与外部项目,但对应文件未提供,无法交叉核对;测试文件可佐证 Goal Pulse 的部分行为,但被测代码缺失。声明与证据分离度无法评估,计 0。
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 核心文件 RULES.md、hosts/、cases/ 与 skills/goal-pulse/scripts/goal_pulse.py 未在证据中提供,无法核实规则内容、安装路径与 Goal Pulse 实现。
- README 安装命令通过 curl 拉取远程内容并追加到 CLAUDE.md,无校验和或签名,存在供应链与内容漂移风险。
- 发布者身份未经验证,维护责任与更新路径仅由 README 自述,不应据此推断可靠性。
- README 自述规则可被更高优先级系统指令覆盖,属可失效的自然语言配置,非强制约束。