HERO — 反过度防御

一段可粘贴的规则块,终结编码代理的哈希、边界情况、机械判断和过度建设四种过度防御行为。

Star 数
★ 769
最近更新
3 天前
License
MIT
主语言
Python
FA 评分
证据不足

30 秒速览

运行形态
Agent 插件 / 技能
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Shell / 命令行网络访问本地文件系统
典型场景
用 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 提供双语定时提醒。

  1. 用 Claude Code 或 Codex 做无人值守长跑任务的开发者,代理整夜写审计循环而不写功能,需要规则块约束执行方向
  2. 维护 ML 研究流水线的研究者,代理为每次可恢复失败建永久版本树、给每行数据算哈希,需要按案例目录 ID 反驳
  3. 同时使用 Codex 和 Antigravity 的团队,两者都读 AGENTS.md,一份文件即可覆盖两个宿主
  4. 让对抗性评审模型提修改建议的团队,评审者是最典型的过度防御来源,README 建议给评审模型也贴同一块
  5. 写论文的写作者,代理在每个段落里撒免责声明、在产物里写“我们不处理 X”,需要规则 7 和 SIB 案例
  6. 配置文件空间紧张的用户,可采用约一半长度的短版本(规则相同、去掉校准示例)

如何安装或部署这个 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?

FollowAgents 源码审查 · FARS-2.1
证据不足
查看各维度的扣分理由
信任安全

证据仅含 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 自述规则可被更高优先级系统指令覆盖,属可失效的自然语言配置,非强制约束。
证据充分度:低 评估于 2026年11月1日 审查版本 92686ca5c7dc 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

常见问题

往 markdown 文件里写规则真的有用吗?
作者引用社区讨论中获最多认同的回答:“有点用”。部分运行仍会筑墙,应以此为合理预期;对特别敏感的任务,换模型可能比任何提示词更直接。
会不会让代理漏掉真正的 bug 或不写测试?
不会——规则约束的是修复范围而非搜索范围。项目自身文档示例会产生的罕见输入、冒烟测试、用户明确要求的安全/迁移/验证工作都会被报告和执行;规则 6 明确不覆盖这些。
支持哪些代理?需要装什么吗?
Claude Code、Codex、Antigravity、Cursor、GitHub Copilot、Windsurf、Gemini CLI,以及任何自动加载配置文件的其他代理。核心规则没有任何需要安装或运行时版本的东西。
规则块失效了怎么办?
先判断原因:更具体的指令在覆盖它(重复无用)、被长输出淹没(重复有用)、还是上下文压缩稀释了它(重新输出有用)。不要设按小时的定时器——上下文随工作而非随时间增长。
Goal Pulse 是什么,必须装吗?
它是可选的 Codex 技能,安装后在启动或恢复 Goal 时默认激活,每 30 分钟发双语提醒,督促主代理收集已完成工作并处理反复出现的卡点。核心 HERO 规则块与此无关。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents