首页/AI/提示词工程速查/代码评审提示写法
任务型写法50 条

代码评审提示写法

代码评审提示按维度分工:正确性、边界、并发、安全、性能、可读性;每条意见给位置、问题与修改建议三段式。

提示词工程速查AI更新于 2026-10-13

评审提示为什么要分维度

自由发挥式的评审容易挑软柿子:反复说命名和注释,漏掉并发与安全。按维度分工(正确性、边界、并发、安全、性能、可读性)能保证覆盖面,再要求每条意见写清位置、问题、建议,输出才可执行。评审提示的产出是给人改代码用的,不是给人点赞用的。

基本信息

评审维度正确性 / 边界 / 并发 / 安全 / 性能 / 可读性
单条结构位置 + 问题 + 建议(三段式)
缺项处理没有发现问题的维度明确输出「无」
禁止项「建议进一步优化」这类没有指向的意见

典型使用场景

  • 合并请求(MR/PR)预审:先机器过一遍维度清单,减轻人工评审负担
  • 关键路径代码复核:并发与边界维度重点检查,配合压测结论
  • 历史代码巡检:按维度批量扫描存量代码,输出问题清单与优先级
  • 接口变更审查:重点看兼容性、错误码与超时处理
  • 安全相关改动:权限校验、输入校验、日志脱敏单独列维度

评审提示模板

评审提示模板
评审下面的代码,按维度逐条给出意见:
[维度] 正确性/边界/并发/安全/性能/可读性
[位置] 文件:行号或函数名
[问题] 具体描述(引用代码片段)
[建议] 可执行的修改方向
# 空维度也要表态,避免漏判被误读为「没问题」
没有发现问题的维度输出“无”;不要泛泛而谈“建议优化”。
# 大 diff 分批送审,一次只看一个文件或一个函数
分批建议:单次输入不超过 300 行 diff,按文件切分。
代码:<diff>……</diff>

维度检查要点

维度重点看什么常见漏项
正确性逻辑分支与返回值是否符合契约异常路径返回值未覆盖
边界空集合、零值、最大长度、时区空输入与并发边界
并发共享状态、锁粒度、幂等性重试导致的重复副作用
安全鉴权、输入校验、日志脱敏越权访问与敏感信息落盘
性能复杂度、循环内查询、批量操作N+1 查询与无分页全表扫描
可读性命名、函数长度、注释必要性过长的条件表达式
大 diff 一次性送审会漏:按文件或函数分批,每批只关注少数维度,命中率明显更高。
评审意见要能落到具体行。要求引用代码片段后,模型编造行号的情况会明显减少,人工核对也更快。

易错点

  • 不限定输出格式时评审意见空泛、无法执行;位置、问题、建议三段式应当作为硬约束
  • 大 diff 一次性评审会漏检关键问题,按文件或函数分批评审更可靠
  • 模型可能给出看似合理但实际错误的建议(如建议删掉必要的空值判断),关键改动仍需人工判断后合并
  • 不写「无问题」的维度会被误读为漏审,导致人工再全量过一遍,评审提示的收益被抵消

数据来源与参考

  • Google 工程实践文档:代码评审(Code Review)指南维度
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌