作者：苏晚编码 Agent 更靠谱的 5 层护栏：Cole Medin 11 条清单的落地版
17 分钟视频里的 11 条建议其实是 5 层护栏：上下文管理、事件级保障、会话卫生、并发与迭代硬边界、独立评审。附可以直接抄的钩子配置、交接文模板、规则审计 prompt 和评审 Agent prompt。
Cole Medin 上周发了一期视频《11 Tiny Coding Agent Fixes With A Stupid Amount Of Payoff》（原视频链接），17 分钟给了 11 条让 Claude Code、Cursor、Codex 这类编码 Agent 更靠谱的做法。视频本身有中文自动字幕可看，我不想再逐条翻译一遍——那对已经看过的读者是浪费，对没看过的读者不如直接去看原片。
真正值得写的，是把这 11 条重新排一次。先说例外：原视频第 8 条讲的是"目前 orchestrator 协调多个 Agent 还不够可靠、别急着上"，那是一个反面结论（先别做这件事），不构成一层可落地的护栏，我没有把它编进结构。所以下文按剩下的 10 条来重排——它们并不是 10 个平行的技巧，而是一套"确定性护栏"里的 5 个层次：上下文管理 → 事件级保障 → 会话卫生 → 并发与迭代的硬边界 → 独立评审。看清楚这个结构，你就能判断自己团队现在缺哪一层，而不是被清单淹没。
下面每一层我都会给出可以直接抄的模板：规则审计 prompt、hooks 的最小配置骨架、交接文的字段清单、评审 Agent 的启动 prompt。这也是这篇文章相对 Cole 原视频要加的东西——他讲了"为什么"，落地的"怎么做"要自己补。
护栏 1：规则文件的"节流 + 防漂移"
Cole 的第 1、2、5 条，本质是同一件事的两面：给 Agent 写的规则，跟给人写的文档不同。人可以在模糊里补全，Agent 不行。
先说节流。他引用 Anthropic 的官方建议：全局规则最好控制在 200 行以内。我自己的经验线是 300 行封顶。超过就要拆——不是拆到别的文件里全局加载，而是拆成"处理这类任务时才读的上下文文件"。原因是模型的注意力是有限的稀缺资源，塞得越多，具体命令越容易被淹没。那些"Don't repeat yourself""Keep it simple"式的口号写在全局规则里，属于纯纯的负载，2026 年的模型不需要你教它这些。
再说防漂移。他引用的那份研究说，四分之一带 AI 层的仓库里，规则文件已经和代码库对不上号——引用了被删掉的目录、被换掉的数据库、被重命名的模块。这个问题不会自愈，只会越攒越多。Cole 说他有个 skill 专门跑规则漂移审计，视频里没给出完整 prompt，我用起来发现真正管用的版本大概是这样：
你是仓库审计员。任务：把 CLAUDE.md / AGENTS.md 里的每一条规则，
拆成"事实主张"清单（每条一行，标注出处：规则文件第几行）。
然后对每条事实主张，去代码库里找证据：
- 提到的文件路径是否存在？
- 提到的命令是否能在 package.json / Makefile / CI 里找到？
- 提到的目录组织是否与当前仓库结构一致？
- 提到的技术栈（如"我们用 Prisma"）是否与实际依赖匹配？
输出三类：仍成立 / 已漂移 / 无法核实。已漂移的给出最小修补建议。
只输出这三类，不要输出"看起来还行"这种主观判断。
把这个 prompt 存成 slash 命令或 skill，每周跑一次，比等它出问题再修便宜得多。
护栏 2：把"必须发生"的规则改成钩子
这是 Cole 讲得最漂亮的一条，也是最容易被忽视的一条。核心命题只有一句：大模型是概率的，钩子是确定的。
Hooks: Guarantees, Not Suggestions。图片来源：Cole Medin / YouTube（视频约 6 分 15 秒）
图里的对比非常直白。同样一句话 "After you finish implementing, run the tests"：
- 写在规则里：Agent 读到、掂量了一下、跳过了；测试没跑，套件仍红，但它告诉你"完成"。
- 写在钩子里（Stop hook）：同一句话变成代码；红了就把回合打回去让它继续修，绿了才允许结束。
判断一条规则要不要转成钩子，问自己三个问题：它必须每次都发生吗？它能被写成代码判定成功/失败吗？失败之后应该阻止 Agent 说"我完成了"吗？ 三个都是"是"，就该转。
Claude Code 的 hooks 配置骨架大致是这样（放在 ~/.claude/settings.json 或 .claude/settings.json）：
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "cd $CLAUDE_PROJECT_DIR && pnpm test --run || (echo 'TESTS FAILED - do not claim done' && exit 2)"
}
]
}
]
}
}
exit 2 会把标准错误里的内容以"这次回合还没结束"的形式回喂给 Agent，让它自己去修。这就是那张图右下角绿色路径的实现方式。
再列几类明显适合改成钩子的规则：格式化（PreToolUse 触发 prettier / ruff）、危险命令拦截（PreToolUse 匹配 rm -rf 直接 exit 2）、提交前测试（Stop 触发）、生成的秘密扫描（PostToolUse 触发 gitleaks）。国内团队用 Cursor 的话，等价机制是它的 + tasks / commands，思路一致：把不能靠自觉的事情，用外部命令锁死。
想了解 AI 如何助力您的企业？
免费获取企业 AI 成熟度诊断报告，发现转型机会
