AI Agent / 系统课时

执行代码评审

执行代码评审

本课解决“评审只看代码风格,真正的正确性、安全性和测试缺口却被遗漏”的问题。你将按风险顺序审查变更,并让 Claude Code 输出带证据、可执行且有优先级的评审意见。

学习目标

  • 按正确性、安全性、维护性和测试顺序评审
  • 区分阻塞问题、建议和可选优化
  • 编写包含位置、影响和修复方向的意见

先理解变更意图

评审前先读取需求、验收标准和差异范围,确认这次改动要解决什么问题。脱离意图只看局部代码,容易把正确的业务特例误判为坏味道,也可能忽略真正缺失的行为。

先查看变更入口、核心逻辑、数据边界和测试,再扩展到调用方。若差异包含迁移、权限、并发或外部接口,应把这些高风险区域放在风格问题之前。

按风险顺序检查

正确性检查输入边界、状态转换、错误处理和事务一致性;安全性检查鉴权、授权、敏感数据和注入风险;维护性检查职责、重复、命名和复杂度;测试检查关键路径、失败场景和回归范围。

可以让 Claude Code 使用统一格式输出意见,避免只给模糊判断。

text
请评审当前未提交差异,并结合相关调用方和测试。
按以下优先级检查:
1. 正确性与数据一致性
2. 权限与安全
3. 兼容性和错误处理
4. 可维护性
5. 测试缺口

每条意见必须包含:
- 严重级别:阻塞、重要或建议
- 文件与位置
- 可复现的失败场景或具体影响
- 推荐修复方向

不要把纯格式偏好列为阻塞问题;没有证据的问题请标记为待确认。

预期结果

text
输出按严重级别排序;每条意见都能定位到具体差异,并说明在什么输入或运行条件下产生影响,而不是只写“这里可能有问题”。

把意见写成可操作问题

高质量意见应让作者知道为什么要改,而不是只给结论。例如,“这里缺少校验”不够具体;更好的意见是说明未经授权的用户可通过哪个入口访问什么数据,并建议复用哪一层现有权限检查。

对于没有确定影响的事项,应使用问题形式确认设计意图。若只是另一种同样合理的写法,可以标记为建议,不应阻塞合并。严重级别稳定,团队才会重视真正高风险问题。

复核修正与测试证据

作者修正后,应重新检查原问题是否消失,以及修复是否引入新差异。不要只看回复文字,也不要默认新增测试就一定覆盖目标场景。

评审完成的标准是阻塞问题已解决、重要风险有明确处理、测试证据足够,并且剩余建议不会影响当前验收。可选重构可以另建任务,不必全部挤进当前变更。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行代码评审

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通