用 pre-commit 钩子拦下代理违反约定的写法,并把修复说明交回给它,不用一直改 AGENTS.md
Geoffrey Huntley(Ralph loop 提出者)的做法:代理不用你的诊断库时,不去改 AGENTS.md,而是写个 pre-commit 钩子检查 diff,发现绕过就让提交失败,并输出一句给代理的修复提示。他称之后「十次十中」。
访问官网 Git pre-commit hook + any coding agent ↗- 定价
- 免费
- 地区
- 海外
- 出自哪里
- 海外社区
- 上架日期
- 2026 年 10 月 17 日
- 实测日期
- 2026 年 10 月 17 日
- 用的版本
- git pre-commit hook (Bash), tested with git on Linux 2026-10-17
- 我们实测
- 部分实测
- 成本 / 耗时
- 零成本:git 自带钩子机制;用不用代理都一样适用。
要解决的事
让编码代理稳定遵守项目约定(比如日志/可观测性必须走统一模块),而不是靠提示词和技能包「概率性」地记住。
步骤
- 挑一条代理老是违反、又能用脚本判断的约定,例如「不许直接调用 console.log / 观测 SDK,必须用 diagnostics 模块」。
- 写 .git/hooks/pre-commit(或用 husky / pre-commit 框架管理):只检查暂存区 diff 里新增的行(git diff --cached -U0),排除约定模块本身。
- 命中就 exit 1,并把输出写成给代理看的指令:哪一行违规、应该改用什么、改完重新提交。
- 让代理照常干活。它提交失败时会读到这段输出并自行修正——修复指令就这样「注入」回循环里。
- 同一类问题出现三次就再加一条检查;Huntley 建议每隔几个月删掉技能包和 AGENTS.md 重新评估,确定性的检查留着。
提示词
写一个 git pre-commit 钩子:检查暂存区 diff 的新增行,如果直接调用 console.log / console.error(src/diagnostics.js 除外),就拒绝提交,并打印一句给代理看的修复指令:改用 src/diagnostics.js 里的 log(),改完重新提交。写完后用一个故意违规的提交验证它能拦住。
原文怎么说
Huntley 在 2026-10-13 的文章中写道:与其反思后更新 AGENTS.md(仍会有偏差、会漂移),不如写 pre-commit 钩子检查 git diff 里绕过诊断模块的直接调用,让提交失败并注入提示,「一下子就十次十中」。他把技能包 / AGENTS.md 称为「软件工程师的星座运势」。Simon Willison 2026-10-13 也引用了这一段。
我们实测
我们在一个临时 git 仓库里按上面的提示词写了钩子,验证了「拦住提交 + 输出修复指令」这半边机制;没有让编码代理在真实项目里跑循环,所以「代理读到提示后自我修正、十次十中」未验证。
我们亲自试下来:新增一行 console.log("hi") 后 git commit 退出码为 1,钩子打印违规行和「AGENT: 改用 log() 再提交」;改成 import { log } 并调用 log("hi") 后提交成功(退出码 0)。钩子约 10 行 Bash。
怎么用上
原文在 ghuntley.com(英文博客,国内一般可直接打开);方法只用 git,不依赖任何海外服务,国产模型 / 代理同样适用。
适合谁
用 Claude Code / Codex / Cursor 等代理长时间跑循环、又被「它总不按约定写」困扰的工程师。
踩坑提示
- 只适合能用脚本确定判断的规则;「写得优雅一点」这种要求拦不住。
- .git/hooks 不随仓库提交;团队或云端代理要用 husky / pre-commit 框架或 core.hooksPath 统一分发。
- 代理可能用 git commit --no-verify 绕过——在代理权限 / 指令里禁止它,或在 CI 里再跑一遍同样的检查。
- 只查新增行,否则老代码会让每次提交都失败;正则别写太宽,误报会让代理改坏正确的代码。
- 「十次十中」是作者的经验说法,我们没有用代理做对照实验。
同类用例
- 文档每页配演示视频,界面一改就报红视频创作ScreenplayClaude Code工具免费;需 Claude 等 agent 额度◐ 部分实测海外
- 让 AI 写后端时默认防并发、越权和改表事故编程开发backendskillsClaude CodePostgreSQL免费;每次任务多花约一倍额度◐ 部分实测海外
- 一个下午让 AI 做出能在浏览器里玩的 3D 动作游戏编程开发Claude CodeTripo即梦技能免费;需 Claude 额度,素材工具另计◐ 部分实测国内
- 长期让 AI 写同一个项目,仓库也不乱编程开发ClaudeCodexoil-delegate需 Claude 和 Codex 订阅◐ 部分实测国内
- 边用一个网页产品,边让 AI 写出它的工作原理调研搜索REAClaude CodeChrome工具免费;需 Claude 或 Codex◐ 部分实测海外