Claude Code 团队让 agent 自我验收的核心办法,是给它一套能跑起来、并且明确返回 "通过还是失败" 的验证手段 —— 测试、构建、lint、类型检查、端到端运行、截图对照设计稿都算。agent 在 "收集上下文→动手改→验证结果" 的循环里自己跑检查、读输出、修失败项,然后把命令结果、构建日志、运行轨迹或截图作为证据一并附上;能自己修好就继续迭代,连续三轮仍不过才停下来升级给人。这套验证能力还能打包成 verify 技能、hook 和提交门禁,由流程强制执行,而不是靠人盯着提醒。
一、为什么要让 agent 自己证明干对了
如果只让 agent 自己判断 "看起来做完了",验收就会落到人头上,每个错误都得靠人偶然发现。团队的思路是把人工验收步骤翻译成可重复执行的检查:检查能给出明确的通过 / 失败信号,agent 就能自己闭环工作,不用人在旁边盯着。
几个可以直接参考的事实:
- 在内部结构化文件生成测试里,加一个独立评分器按评分标准检查 Claude 的产出,任务成功率比纯提示词循环最多提升约 10 分,难题上收益最明显。
- Claude Code 作者 Boris Cherny 认为,给 Claude 一条验证自身工作的途径,是拿到好结果最关键的一件事,估算它能让最终结果变好 2 到 3 倍。
- 有了验证循环,才能并行跑几十个甚至上百个 agent;没有它,一次只能跑一两个,因为什么都得自己复核。
二、验证的基本循环
agent 工作流固定成三段,验证是最后一环,不通过就回到前面继续补上下文和改代码:
- 收集上下文:读需求、代码改动范围和相关约定。
- 采取行动:写代码、改配置、生成文件。
- 验证结果:跑测试、构建、lint 或实际运行,对照预期判断对错;失败就带着输出回到第二步修复。
验证不是一句 "我觉得没问题",而是必须有工具链产出的客观证据。
三、值得投入的三类检查
| 检查类型 | 跑什么 | 能证明什么 | 注意点 |
|---|---|---|---|
| 端到端(E2E)测试 | 模拟真实用户流程,比如加购物车、下单、跳确认页;Web 用浏览器扩展或 CDP,移动端用模拟器 MCP,后端本地起服务 | 整条链路真的能用,而不只是某个函数通过 | 最不容易被糊弄,完成标准明确;优先投入这一类 |
| 属性测试 | 写一条 "不该被打破" 的属性,用 fast-check、Hypothesis、proptest 等库生成成千上万组输入找反例 | 边界条件和极端输入下行为仍然成立 | 重点覆盖 agent 容易漏掉的边角场景 |
| 差分测试 | 新旧系统喂同一批输入(随机输入或生产流量样本),对比输出是否一致 | 大规模迁移后功能没有发生破坏性变化 | 先归一化无关差异,比如空白字符;保留一份 "允许变化" 清单 |
两条避坑原则:测试不能不稳定(flaky),否则会训练 agent 反复重跑而不是修代码;测试不能太慢,否则批量验证时覆盖不到问题。重的检查放在提交前跑。
四、把验证固化成技能和流程
1. verify 技能
在仓库的 .claude/skills/ 目录下放一个 verify 技能,把怎么启动模拟器、怎么跑应用、怎么端到端验收写清楚;Claude 在提交改动前会主动调用它。技能本身要做得快、稳,可以让 agent 反复迭代并压测,把它当成一套冒烟测试框架来打磨。
2. 技能链式串联
把习惯变成契约:比如 /simplify 跑完之后自动接 /verify-no-public-api-changes。链式流程会在整个开发周期里自动跑完整套检查,只有出问题才需要人介入。链式会多耗 token,铺开前先小范围测试。
3. 证据怎么留
- 证据必须来自工具链本身:make test 的真实输出、构建日志、截图对比 diff,而不是 agent 口头声明。
- 会话记录里保存完整命令和输出,再通过 OpenTelemetry 导出到可观测系统;PR 的检查记录里也留一份,方便评审和事后审计。
- 每次提交盖一个验证戳,甚至允许标 "none",这样能反向查出哪些提交没经过验证。
五、门禁、治理与人工兜底
提交门禁:团队维护着一个提交门禁,会话里缺少 /code-review 或 /verify 记录时可以拦截提交。门禁分三档:off 只记录、observe 记录 "本会拦截" 的误报样本、enforce 直接挡住。提交消息里可以写明未验证的理由;同一会话里被拦两次后下次放行,避免 agent 卡死在门禁上。
组织强制项:需要保证的规则可以用 hook 落地,比如任务上报完成前必须先验证;修 bug 过程中禁止 agent 改动测试文件。评审人则把精力放在意图和风险判断上,机械证据已经附在旁边。
什么时候交人:agent 自己跑检查、修失败项;如果连续三轮仍然失败,就停下来把问题交给人工。没有人能读完每一处改动,失败项就是判断哪些事情需要人介入的信号。
评审怎么组织:不堆多个评审员,而是调好主评审;用 REVIEW.md 写清这块代码重点看什么。多轮评审复用前一轮的上下文和历史漏检记录,不每次从头查,成本更低、抓得更准。另有一份 39 项可靠性清单,每项都有可从 diff 读出的触发条件,agent 只查命中的 3 到 10 项,不用人背历史故障。
六、漏检问题怎么沉淀成规则
- 从人工评审意见和 PR 回滚记录里提炼共性问题:同一问题至少在两个 PR 出现、且能从 diff 识别,才视为候选规则;再由三个 agent 尝试证伪,最后走人工 PR 审批。
- 对已知事故对应的 PR 回放多个 bug 查找器:至少两个能抓到,才算可被检测的问题;小 diff 上漏掉的,补进 REVIEW.md。
- 不稳定测试同等待遇:agent 不能跳过测试、不能靠加 sleep 或重试凑过;找不到根因就删掉测试并写明原因。
- 规则要定期清理,测试套件、验证步骤和说明文件只增不减会失效,需要日常修剪。
七、落地建议小结
- 先给 agent 一条能跑通的冒烟验证路径,哪怕只是一个 bash 命令或一套测试。
- 证据贴原始输出,不只贴结论。
- 把反复出现的检查写进技能、hook 和说明文件,沉淀成可复用规则。
- 设定自修轮次上限,超限就升级人工。
- 用回滚率、合并前被拒率等指标回头评估检查本身是否有效。
【相关 FAQ】
问题 1:Claude Code 的 agent 靠什么证明自己把活干对了?
回答 1:靠可执行验证产出的客观证据,而不是自我感觉。Claude Code 的 agent 改完代码后要跑测试、构建、lint、类型检查或实际运行应用,把命令输出、日志、运行轨迹或截图附上;只有工具链结果通过,才能声称任务完成。验证手段可以封装成 .claude/skills/ 下的 verify 技能,在提交前自动调用。
问题 2:Claude Code 里的验证循环具体怎么转?
回答 2:循环分三步:收集上下文、采取行动、验证结果。agent 动手改完后跑检查,读失败输出,定位问题再修,修完重新跑检查,直到通过;像 /simplify 完成后自动接 /verify-no-public-api-changes 这样的链式技能,可以把整套流程自动串起来。循环不闭环时,人只需要定义好 "做完" 的标准和检查入口。
问题 3:什么情况下 Claude Code 的 agent 会停止自修、转交给人?
回答 3:检查失败时 agent 会先自己修,但如果连续三轮验证仍然失败,就停止迭代并把问题升级给人工。提交门禁也可以在缺少 /code-review 或 /verify 记录时拦截提交;同一会话被拦两次后自动放行,避免 agent 被门禁卡死。需要人判断的是意图、风险和持续失败的疑难问题。
问题 4:E2E、属性测试、差分测试在 agent 验证里分别起什么作用?
回答 4:E2E 测试模拟完整用户流程,证明整条链路真正可用,最难被糊弄,是优先投入的一类;属性测试生成大量输入找边界反例,验证极端情况下属性不被打破;差分测试把新旧系统跑在同一批输入上对比结果,用于大规模迁移时确认没有破坏性变更。三类检查配合单元测试和类型检查,覆盖不同层级的正确性。
问题 5:项目里没有自动测试,怎么让 Claude Code 的 agent 做自我验证?
回答 5:可以从最容易跑的信号做起:构建退出码、lint 报错、脚本对比预期 fixture、浏览器截图对照设计稿,或者本地起服务走一遍核心流程。把这些人工检查步骤写进 verify 技能或 CLAUDE.md 里的命令,让 agent 每次提交前执行并贴出结果;后续再逐步补 E2E 和属性测试,把验收标准固化下来。
【参考资料】
- [2026-11-16](How the Claude Code team thinks about verification)claude.dev Blog
- [2026-10-15](How the Claude Code team does code review)claude.dev Blog
- [2026-08-21](The AI-Native SDLC playbook)Claude by Anthropic
- [2026-07-27](Claude 写完代码不直接交了:4 个 Skill 自查一遍,改好再找你)36 氪
- [2026-07-22](Building verification loops in Claude Code with skills)Claude by Anthropic
- [2025-09-29](Building agents with the Claude Agent SDK)Anthropic
【免责声明】
本文基于 Anthropic、Claude Code 团队公开博客及公开报道整理,所述工作流、技能机制、门禁策略和测试方法均来自对应公开资料,不同版本的 Claude Code 产品能力、默认配置和内部流程可能存在差异。文中引用的成功率提升、效果倍数等数据为公开测试或估算口径,不代表对你所在项目的保证。具体使用时请以官方最新文档和实际工具行为为准,本文不构成工程流程或采购上的强制建议。
本文来自作者[幻波路由]投稿,不代表环球科技潮立场,如若转载,请注明出处:https://www.zennew.com/hlw/202611/3289.html
评论列表(4条)
我是环球科技潮的签约作者“幻波路由”!
希望本篇文章《Claude Code 团队怎么让 agent 自己证明活干对了验证循环、证据留痕与人机兜底》能对你有所帮助!
本站[环球科技潮]内容主要涵盖:科技,科技新闻,黑科技
本文概览:Claude Code 团队让 agent 自我验收的核心办法,是给它一套能跑起来、并且明确返回 "通过还是失败 " 的验证手段 —— 测试、构建、lint、类型检查、端到端运行、截图对照设计稿都算。agent 在 "收集上下文→动手改→验证结果 " 的循环里自己跑检查、读输出、修失败项,然后把命令结果、构建日志、运行轨迹或截图作为证据一并附上;能自己修好就继续迭代,连续三轮仍不过才停下来升级给人。这套验证能力还能打包成 verify 技能、hook 和提交门禁,由流程强制执行,而不是靠人盯着提醒。