Code Review 评审意见怎么写、怎么回复提示词(措辞不伤人、意见可执行)

做代码评审时不知道怎么把意见写得清楚又不冒犯人,或者收到评审意见后想有理有据地回复(接受、解释、反驳)时用:把你的原始想法改写成规范的评审评论或回复,并标注意见的分量。

NNathaniel bigo··原创首发·AI 辅助撰写
通用大模型 对话模型通用
你是一名带过团队的技术负责人,擅长写清楚、尊重人、能直接执行的代码评审评论。

我的身份:[评审人/被评审的作者]
团队的评论习惯:[如中文、用 nit: 前缀标小问题]
相关代码片段:
  [粘贴代码]
我想表达的意思(可以很口语、带情绪):
  [你的原始想法]
如果我是作者,收到的评审意见是:
  [评审意见原文,没有就写无]

如果我是评审人,请把我的想法改写成评审评论:
1. 先标明分量:必须修改(阻断合并)/ 建议修改 / 小问题(nit)/ 只是提问。
2. 说清楚「问题是什么、为什么有问题、会在什么情况下出错」,对代码不对人。
3. 给出具体建议或示例代码;如果有多种改法,说明我倾向哪种以及理由。
4. 用提问代替命令的场合(不确定作者是否有别的考虑时),写成「这里是否考虑过……」。
5. 每条评论控制在 5 行以内。

如果我是作者,请帮我写回复:
1. 先判断每条意见:我应该接受、需要解释背景、还是有理由不同意。不同意时给出依据(性能数据、需求约束、团队约定)。
2. 接受的意见写明「已在某次提交修改」;需要另开任务处理的,写明会在哪里跟进。
3. 如果双方观点分歧较大,建议转为当面或语音沟通,并给出一句得体的说法。

禁止:讽刺、反问式指责(「你没测试过吗?」)、绝对化用语(「这是错的」「从来不」)。最后输出可以直接粘贴的评论文本。

高亮处换成你自己的内容:[评审人/被评审的作者]、[如中文、用 nit: 前缀标小问题]、[粘贴代码]、[你的原始想法]、[评审意见原文,没有就写无]

ChatGPT Plus 充值

已被复制 0 次

使用说明

怎么填变量:[你的原始想法] 怎么想就怎么写,比如「这个函数太长了看不下去,而且没处理空数组」,AI 会拆成两条分量不同的评论。贴上相关代码,评论才能具体到行。

常见坑:

  • 评审意见不标分量,作者分不清哪条必须改、哪条只是个人偏好,结果要么全改、要么全不改。所以模板要求每条先标「必须 / 建议 / nit / 提问」。
  • 一条评论里塞好几个问题,作者回复时很难逐条对应,最好一条只讲一件事。
  • 作为作者,不同意时只说「我觉得没必要」很难说服人,带上依据(例如「这个列表最多 20 条,复杂度不是瓶颈」)。

追问技巧:评论太多时,追问「只保留会阻断合并的意见,其他合并成一条总结」;团队有新人时,追问「改写成带一点讲解的版本,帮助对方理解背后的原则」。

示例输出

示例,仅供参考(原始想法:「这个函数太长了看不下去,而且没处理空数组」)

必须修改:calcDiscount() 在 items 为空数组时会执行 items[0].price,导致报错。空购物车下单页会触发这个分支。建议在函数开头加:

js
if (items.length === 0) return 0

建议修改:这个函数目前约 120 行,同时做了价格计算、优惠券校验和日志记录。是否考虑把优惠券校验拆成单独的函数?这样也方便给它单独写测试。不阻断这次合并,可以另开任务。

同款作品

用这条提示词做出来的作品;原作者会因此获得积分

做同款

还没有同款,来做第一个。

Nathaniel 的更多内容

同主题

同模型

0 条评论

登录 后参与评论

还没有评论,来抢沙发~