AI Agent / 系统课时
执行代码评审
执行代码评审
本课解决“评审只看代码风格,真正的正确性、安全性和测试缺口却被遗漏”的问题。你将按风险顺序审查变更,并让 Claude Code 输出带证据、可执行且有优先级的评审意见。
学习目标
- 按正确性、安全性、维护性和测试顺序评审
- 区分阻塞问题、建议和可选优化
- 编写包含位置、影响和修复方向的意见
先理解变更意图
评审前先读取需求、验收标准和差异范围,确认这次改动要解决什么问题。脱离意图只看局部代码,容易把正确的业务特例误判为坏味道,也可能忽略真正缺失的行为。
先查看变更入口、核心逻辑、数据边界和测试,再扩展到调用方。若差异包含迁移、权限、并发或外部接口,应把这些高风险区域放在风格问题之前。
按风险顺序检查
正确性检查输入边界、状态转换、错误处理和事务一致性;安全性检查鉴权、授权、敏感数据和注入风险;维护性检查职责、重复、命名和复杂度;测试检查关键路径、失败场景和回归范围。
可以让 Claude Code 使用统一格式输出意见,避免只给模糊判断。
text
请评审当前未提交差异,并结合相关调用方和测试。
按以下优先级检查:
1. 正确性与数据一致性
2. 权限与安全
3. 兼容性和错误处理
4. 可维护性
5. 测试缺口
每条意见必须包含:
- 严重级别:阻塞、重要或建议
- 文件与位置
- 可复现的失败场景或具体影响
- 推荐修复方向
不要把纯格式偏好列为阻塞问题;没有证据的问题请标记为待确认。预期结果
text
输出按严重级别排序;每条意见都能定位到具体差异,并说明在什么输入或运行条件下产生影响,而不是只写“这里可能有问题”。把意见写成可操作问题
高质量意见应让作者知道为什么要改,而不是只给结论。例如,“这里缺少校验”不够具体;更好的意见是说明未经授权的用户可通过哪个入口访问什么数据,并建议复用哪一层现有权限检查。
对于没有确定影响的事项,应使用问题形式确认设计意图。若只是另一种同样合理的写法,可以标记为建议,不应阻塞合并。严重级别稳定,团队才会重视真正高风险问题。
复核修正与测试证据
作者修正后,应重新检查原问题是否消失,以及修复是否引入新差异。不要只看回复文字,也不要默认新增测试就一定覆盖目标场景。
评审完成的标准是阻塞问题已解决、重要风险有明确处理、测试证据足够,并且剩余建议不会影响当前验收。可选重构可以另建任务,不必全部挤进当前变更。
按自己的节奏,确认真正理解。