摘要:AI 编程让单次改动的代码量变大,逐行审 diff 的性价比会下降。更合理的做法,是把审查前移到计划:目标、边界、接口、数据模型、风险和验证路径。
Builder.io 的 Steve Sewell 提了一个很好的判断:AI 写代码之后,人类更应该审计划,而不是把主要精力放在逐行审代码上。
这个判断容易被误解成“以后不用看代码”。不是。
它真正说的是:当 AI 一次能改几十个文件、生成上千行代码时,传统 diff 审查的边际收益会下降。人类最该提前确认的,是它到底准备解决什么问题、改哪些边界、怎样验证结果。
代码生成前,方向错了,后面写得越多越麻烦。
为什么 Markdown 计划不够
Claude Code 的 Plan Mode 很有用,但它通常输出一大段 Markdown。
对模型来说,这没问题;对人来说,可审性很差。产品经理要从文字里脑补页面,工程师要从文件列表里推断模块边界,数据负责人要从几行描述里判断 schema 风险。
这等于让人把文本反向渲染成系统图。
Builder.io 的 /visual-plan 思路有价值,正是因为它把计划变成可视对象:线框图、文件地图、API 结构、Schema 变更、待确认问题。重点不是“好看”,而是降低审查成本。
AI 编程里真正稀缺的不是代码,而是可共同理解的意图。
审计划,本质是审契约
AI 生成代码前,计划应该回答六个问题。
第一,目标是否正确。它有没有理解真实需求?有没有把产品问题误解成纯技术问题?
第二,边界是否清楚。它准备改哪些文件、模块、接口?有没有跨过不该跨的所有权边界?
第三,结构是否合理。数据模型、组件层级、调用路径、权限校验和错误处理是否成立?
第四,风险是否暴露。是否涉及迁移、灰度、回滚、安全、性能和兼容性?
第五,验证是否具体。是跑测试、类型检查、截图验证、接口契约测试,还是人工验收?
第六,哪些问题需要人决定。模型不应该替人拍板业务策略、品牌口径和高风险权限。
这些问题在计划阶段就能拦住。等代码写完再发现方向错,成本已经高很多。
可视化不是装饰
工程师有时会轻视可视化计划,觉得图只是包装,代码才是真的。
但在 AI 编程里,可视化是压缩认知负担的工具。
线框图让产品经理看用户路径;API 图让前后端确认契约;Schema 图暴露字段和迁移风险;文件地图帮助工程负责人判断是否越界;状态图能发现异常分支和空状态。
这些信息如果埋在 diff 里,只有工程师能勉强读懂。可视化计划把审查对象从“代码细节”提升到“系统影响”,产品、设计、工程和安全都能参与。
这才是 /visual-plan 的核心意义:让 AI 动手之前,团队先对“准备怎么改”达成共识。
完成后还需要 recap
只审计划还不够。AI 执行过程中可能偏离计划。
所以 /visual-recap 也重要。它把 branch、commit 或 PR diff 翻译成结构化变更总结:核心文件、API/Schema 变化、UI 状态、风险点、已跑测试和未覆盖项。
这不是替代代码审查,而是让人更快进入重点。工程师可以追关键 diff,产品和设计也能理解这次 AI 到底改了什么。
好的 recap 应该能回答三件事:
- 最初计划是什么;
- 实际改变了什么;
- 哪些地方还没有证据证明安全。
编译器类比要谨慎
“没人检查编译器生成的汇编”这个类比很准,但不能用过头。
我们信任编译器,是因为它有形式化约束、测试、标准和几十年工程验证。AI Agent 还没有这个成熟度。
所以更准确的说法是:不要把 AI 生成代码当成人类手写作品逐行校对,而要把它当作生成物,用计划、权限、测试、运行检查和审计来约束。
人类不是退出审查,而是换审查对象:
- 生成前审计划;
- 生成中看边界;
- 生成后看 recap;
- 放行前看证据。
这对工程师要求更高,不是更低。
结论
AI 编程会让代码生成越来越快,diff 越来越长。继续把主要精力放在逐行找问题上,团队会被拖进低效审查。
更合理的分工是:
人审计划,机器写代码,流水线做验证,团队看影响。
计划错了,先别写。
代码写完了,别只看总结,要看 recap 和证据。
AI 编程从玩具走向生产,关键不是让模型更会写,而是让团队更会审它准备怎么写、实际写成了什么。
参考资料
[1] BuilderIO/skills, “/visual-plan README”, https://github.com/BuilderIO/skills/blob/main/skills/visual-plan/README.md
[2] BuilderIO/skills, “Skills for coding agents”, https://github.com/BuilderIO/skills
[3] Steve Sewell, “Introducing /visual-plan - rich plans for Claude Code + Codex”, YouTube, 2026-06, https://www.youtube.com/watch?v=NE0aBuQF0HA
[4] Builder.io, “Code Review in the AI Age”, https://www.builder.io/blog/code-review-ai