codecamp

让 Qwen 评审重构与提交信息

代码评审只给 diff、按维度清单过、输出格式钉死——这是官方六要素里 Objective 与 Response 的直接应用;贴全文件让模型自由发挥,产出的大多是正确但无用的泛泛之谈。

一、前提与适用

前提 说明
适用任务 变更评审、重构建议、提交信息生成
官方依据 Model Studio 提示词六要素:Objective 写清具体任务,Response 指定输出形态(六要素口径见 同一需求为何给 Qwen 写三遍)
评审三件套 只给 diff+维度清单+逐条输出格式
不适用 架构级评审——需要整体上下文与业务约束,diff 形态装不下

二、怎么做

评审三件套,逐项钉死:

  1. 只给 diff。贴变更 diff 而不是全文件,并把「不要假设未改动部分的问题」写进提示词——范围约束让评审聚焦改动本身;调用方上下文单独一小段给出(本次改动影响谁)。
  2. 维度清单。写死检查维度(正确性、边界处理、命名),并给输出纪律「无问题的维度写『通过』」——不写这句,模型会为凑满维度硬找问题。
  3. 逐条输出格式。每条按「严重度:位置:问题:建议」,让产出可直接转成评审意见与待办;重构与提交信息场景把维度换成对应清单即可。

坏写法:

看看这段代码有什么问题,帮我改好。

无范围(全文件自由发挥)、无维度(问题泛泛)、无格式(产出不可转办)——「帮我改好」还会诱导模型大改特改。

改写后的完整提示词:

你是代码评审员。只评审下面的 diff,不要假设未改动部分的问题。按「正确性、边界处理、命名」三个维度检查,逐条输出:严重度(高/中/低):位置(行号):问题:建议。无问题的维度写「通过」。

diff:
```diff
 def divide(a, b):
-    return a / b
+    if b == 0:
+        return None
+    return a / b

调用方上下文:返回值直接用于后续计算 display_total = result * 100。


范围、维度、格式三段钉死;调用方上下文单独给——它正是考「边界处理」取舍的关键信息。

「评审三件套是否齐」可以做成可跑检查:

```python
## EXPECT: 范围约束=1 维度清单=3 输出格式=1
PROMPT = open("prompts/8.4.txt", encoding="utf-8").read()

scope = int("不要假设未改动部分的问题" in PROMPT)
dims = PROMPT.count("正确性") + PROMPT.count("边界处理") + PROMPT.count("命名")
fmt = int("严重度" in PROMPT and "建议" in PROMPT)
print(f"范围约束={scope} 维度清单={dims} 输出格式={fmt}")

实测输出与判定:脚本实跑输出与首行注释一致。逐条判定:范围约束、输出格式各命中 1 次,三维度命中 3 次,评审提示词形态完整。判定器只查形态;评审结论质量,看下面的实测输出并对照调用方上下文核实。

怎么看这个示例:判定器是本地脚本,上面那条提示词另在 qwen3.7-max(temperature=0.7、top_p=0.8) 上实测;脚本输出不等于模型输出,两者分别核对。

模型回复(真实输出节选):

**正确性**
严重度:高:位置:第 3 行:问题:结合调用方上下文,返回 `None` 会导致后续执行 `result * 100` 时抛出 `TypeError`。这不仅将原本明确的 `ZeroDivisionError` 掩盖为难以排查的类型错误,还破坏了调用方的逻辑,违背了快速失败(Fail-fast)原则。:建议:不要返回 `None`。应移除该 `if` 判断以保留 Python 原生的 `ZeroDivisionError`,或主动抛出明确的业务异常(如 `ra…(节选)

Qwen 输出卡片

以上为模型真实回复的节选,实测日期 2026-11-16。

三、参数与边界

边界 说明
diff 完整性 diff 必须含足够上下文行,缺上下文的改动模型无法判断副作用
结论采纳 评审意见是线索不是判决,逐条人工核实后再改代码
维度外溢 维度清单之外的问题模型可能顺带提及——采纳前先归类到清单内核对
提交信息 生成提交信息时给「类型:摘要:正文」模板与改动清单,格式约束同本节 Response 写法

四、验收清单

检查项 通过标准
范围聚焦 意见全部落在 diff 改动行,无对未改动部分的猜测
维度可转办 每条意见带严重度与位置,可直接建任务
上下文入判 调用方上下文被实际引用(如 None 传播问题),不是摆设
停手条件 连续两轮意见仍飘在改动范围外,先补 diff 上下文行而不是堆维度

五、注意与相关

评审提示词的骨架就是六要素的工程化:Objective=只审 diff 按三维度,Response=逐条四段格式,Context=调用方上下文(六要素全表见 同一需求为何给 Qwen 写三遍)。评审发现的行为疑点别停在「读」——转 8.2 做最小复现实跑;解释陌生代码的分层写法见 怎么让 Qwen 解释看不懂的代码;脚本与测试生成的预期输出写法见 让 Qwen 生成脚本与测试。

调试怎么给 Qwen 最小复现
怎么让 Qwen 讲懂复杂概念
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }