审查 AI 大改动,先盘点影响范围
先列出改动波及的应用、共享模块和文档,排查触及同一文件的开放 PR,再集中对照受影响界面的前后截图。根据行为差异定位需要细读的代码。
AI 深度解读
AI 一次改了 50 个文件,逐个打开看,每处改动都可能说得通。真正难发现的是改动之间的关系:一个共享函数还有另外 3 个页面在用,或者同一条业务规则被复制到了另一个应用里。
作者建议把审查顺序倒过来。先确认改动波及哪些地方,再把受影响的页面改前改后摆到一起看,最后带着具体疑点回到代码。对前端和全栈开发者来说,这套流程最实用的地方,是能把「这 50 个文件从哪儿看起」变成几个有明确入口的问题。
先弄清改动波及了哪些地方
作者先列出 Web、移动端、桌面端、官网和文档,再逐个搜索功能相关的词。搜索词既包括产品里叫得顺口的名字,也包括代码中的命名和类型名。命中后要打开确认,剔除同名但无关的结果,再补上搜索容易漏掉的入口。比如一个页面只渲染通用组件,测试只验证最终行为,应用商店详情只描述用户能做什么,它们都可能受影响。
清单按落地顺序排,共享代码在前,各端应用随后,官网和文档收尾。作者还会查看尚未合并的 PR 有没有碰同一批文件。同一个共享模块上叠着两份改动,即使各自看起来合理,合并时也需要重新确认调用方看到的行为。
把每个受影响页面的前后截图放在一起
作者把所有受影响页面的改前、改后截图放在同一页,像在 Figma 里评审一样,把批注钉到出问题的位置。空状态坏了、按钮偏了,拿两张图对着看,比从几处 JSX 和 CSS 改动里推演最终画面直接。
截图有了疑点,作者再用 4 条规则找该细读的代码。第一,每项业务事实只有一个权威来源,比如套餐权益由一个地方判定。第二,两个应用都遵循的规则在共享代码里写一次,各端导入。第三,一个文件只承担一项职责,避免改一个功能时把几个无关功能一起卷进来。第四,依赖保持单向,共享代码不能反过来导入某个应用。作者最先查的是同一件事有没有在两处各算一遍,因为之后只改其中一处,两边就会给出不同结果。
哪些决定需要人来定
已有规则可以交给 AI 逐项检查。会移除用户依赖的功能、调整价格,或改变付费套餐权益的改动,需要人做产品决定。作者建议把这类决定记录成规则,下次遇到类似 PR 时就有依据可查。
他们团队用来构建自家产品的 starter kit,可以生成一页审查材料,列出影响范围、汇总页面前后截图,并提出需要人拍板的问题。作者称它支持 Claude Code 和 Codex,在 GitHub 免费提供。
我的判断
先看影响范围,再看页面,这个顺序适合跨应用、跨页面的 PR。逐文件读 diff 擅长检查具体实现,前后截图擅长发现用户看得见的回归,两者能在同一个疑点上接起来。比如截图里付费按钮消失了,就回到代码确认是布局把它遮住了,还是权益判断发生了变化。
作者描述的是他们团队的工作流,没有给出与逐文件审查的对照数据,也没有交代工具怎样确认页面和状态已经覆盖齐全。因此,原文所说的「几秒发现问题」可以视为经验之谈。截图只能说明被拍下的那个状态,权限切换、请求失败、数据写入等行为还得结合测试和实现核对。共享规则也有个前提:先确认两个端的业务语义确实相同。组件看起来一样,套餐权益或空状态的触发条件仍可能各有要求。
能拿来做什么
- 审查跨端 PR 时,让 AI 按共享模块、各端应用、官网和文档列出影响清单,并给每个页面标出对应的组件或调用链,再核对是否有其他未合并的 PR 改了同一批文件。
- 用同一份测试数据和相同视口生成改前、改后截图,把正常态和这次改动涉及的空状态放在一起。看到差异后,沿着批注定位到对应组件和分支。
- 如果 Web 和 Node 都在计算同一项套餐权益,先核对两边的规则是否一致,再确定哪一处负责判定、另一处如何复用结果。涉及改价或权益变更时,把要拍板的问题单独写进 PR。