Git pre-commit hook + any coding agent部分实测🌏 海外

用 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
分类
编程开发自动化代理
原作者
Geoffrey Huntley @GeoffreyHuntley ↗
我们实测
部分实测
成本 / 耗时
零成本:git 自带钩子机制;用不用代理都一样适用。
来源
ghuntley.com Geoffrey Huntley ↗Simon Willison's Weblog ↗

要解决的事

让编码代理稳定遵守项目约定(比如日志/可观测性必须走统一模块),而不是靠提示词和技能包「概率性」地记住。

步骤

  1. 挑一条代理老是违反、又能用脚本判断的约定,例如「不许直接调用 console.log / 观测 SDK,必须用 diagnostics 模块」。
  2. 写 .git/hooks/pre-commit(或用 husky / pre-commit 框架管理):只检查暂存区 diff 里新增的行(git diff --cached -U0),排除约定模块本身。
  3. 命中就 exit 1,并把输出写成给代理看的指令:哪一行违规、应该改用什么、改完重新提交。
  4. 让代理照常干活。它提交失败时会读到这段输出并自行修正——修复指令就这样「注入」回循环里。
  5. 同一类问题出现三次就再加一条检查;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 里再跑一遍同样的检查。
  • 只查新增行,否则老代码会让每次提交都失败;正则别写太宽,误报会让代理改坏正确的代码。
  • 「十次十中」是作者的经验说法,我们没有用代理做对照实验。

同类用例