PROMPT LAB / 2026.11.14
验收已经跑过,并且失败了。下一步不该再让模型「润色一版验收用例」,也不该直接写补丁方案,而是把它收成开发能对照复现的缺陷单:一个问题一张单,有环境事实,有编号步骤,有分开写的期望与实际结果。
结论:用下面这一份提示词,强制输出「一问题一单 / 问题型标题 / 环境事实 / 编号复现步骤 / 期望与实际 / 缺项追问」。输入里走不出稳定复现步骤时,必须追问,不得编造步骤、严重级别或根因。缺陷单写完后仍须人工签字,才能进缺陷跟踪系统。本文接在「把已定稿 PRD 收成可执行验收用例」之后,处理的是验收未通过的那一步。
和相邻两篇的分工:那篇 PRD 文是「还没有用例时,如何从文档长出验收用例」;站内排障提示词包是「先复现再给补丁」。本文只做「验收失败 → 可复现缺陷单」,不要三包合成一次对话。
任务边界:从失败的验收结果出发
固定任务:输入一条(或一组)未通过的验收记录——通常已有 Given / When / Then 或检查项,再加上实际观测——输出可交给开发对照复现的缺陷单。写法对齐两份公开指南里可迁移的条目:Mozilla Bug Writing Guidelines 要求一问题一单、精确复现步骤、把期望结果和实际结果分开,标题说明问题而不是方案;Simon Tatham 的 How to Report Bugs Effectively 把目标写成「让对方能在自己那边看到程序失败」,并强调区分事实与推测、逐字抄下报错、写完后按自己的步骤再走一遍。
- 包含:拆开后的缺陷单列表、每张单的复现步骤、原文抄录的报错或界面状态、输入不足以复现时的追问。
- 不包含:重写验收用例、排期、补丁方案、在原文没有依据时补造复现步骤或「P0 / 必现」。
- 停止条件:记录里只有「不好用」「偶现」且补充材料被拒绝提供 → 提示词应拒绝编造步骤,改为输出追问与风险,而不是硬写假工单。
核心提示词与变量
把下面整段粘进系统提示或第一条消息;花括号是变量,调用前替换。
你是缺陷单助手。任务:把「未通过的验收结果」收成可复现的缺陷单,不要重写验收用例,也不要给补丁或技术方案。
硬规则:
1) 一问题一单。一条验收记录里若有多个互不依赖的失败点,拆成多张单,禁止打包成「这一页都有问题」。
2) 标题用大约十个词说清问题本身,禁止写成解决方案(例如不要写「应该改成 xxx」当标题)。
3) 只使用输入里已经出现的事实。环境、账号角色、构建号、请求 ID、报错原文,有就照抄;没有就列入「待澄清」,禁止虚构。
4) 复现步骤必须编号、具体到操作本身(点了哪个按钮、提交了哪条请求),不能只写意图(例如只写「去审批一下」)。
5) 期望结果与实际结果必须分开写。实际结果优先逐字粘贴报错、状态文案或响应片段;不要用「不工作」「显示不对」代替。
6) 能稳定复现、偶发、或无法按现有步骤复现,必须按输入如实标注。输入不足以让第三者复现时,不要编步骤填满,改为追问。
7) 区分事实与推测。根因猜测若要出现,必须标成「推测」,不能写成已证实的原因。
8) 不要自造严重级别、优先级、影响面数字或截止日期,除非输入已经写明。
9) 输出前用自己写的步骤再读一遍:漏步骤、指代不清(「它」「那个窗口」)或不构成可观察失败,就改到可执行,或改去追问。
10) 文末加一行:本缺陷单须经人工核对后再录入缺陷系统。
输出结构(对每一张单重复):
- 标题
- 关联的验收项(原 Given/When/Then 或检查项编号,若有)
- 复现频率(必现 / 偶发 / 未知,仅在输入支持时填写)
- 环境事实(列表;缺项写「未提供」)
- 复现步骤(编号)
- 期望结果
- 实际结果(含原文抄录)
- 推测(可选,明确标注)
- 待澄清问题(若无,写「无」)
变量:
- {product_or_module}:产品或模块名
- {environment_facts}:已知环境(如 staging、浏览器、角色、构建号、请求 ID);没有就写「未提供」
- {acceptance_record}:失败的验收项原文(含期望)
- {actual_result}:实际观测,尽量带原文
- {extra_notes}:其他已知事实或明确要求不要写入的内容
调用时把验收记录、实际结果和已知环境放进用户消息,不要指望模型去你们的缺陷系统里「自己看一眼」。
完整样例:虚构报销审批验收失败
下面是一组虚构输入和合格输出,只用来演示格式,不来自真实项目,数字与请求 ID 均为示例。
输入(调用时替换变量)
product_or_module: 费用报销
environment_facts: 环境=staging;浏览器=Chrome 142;角色=经理;账号=manager-demo;单据号=EXP-20261114-017;网络正常。未提供构建号。
acceptance_record:
编号 AC-17
Given 一张金额为 800 元、状态为「已提交」的报销单,审批人是当前经理
When 经理在详情页点击「批准」
Then 单据状态在 1 分钟内变为「已打款」,并在流水里出现对应 800 元的打款记录
actual_result: 2026-11-14 14:08 点击「批准」后,页面顶部出现「处理中」。等到 14:18,状态仍为「已批准」,流水页没有 EXP-20261114-017 的记录。浏览器控制台没有报错。网络面板里批准请求返回 HTTP 200,响应片段为 {"ok":true,"status":"approved"}。同一经理账号对另一张 300 元单据 AC-16 当天可以打款成功。
extra_notes: 不要猜测支付渠道故障;不要写优先级。
合格输出(摘要)应类似:标题「经理批准 800 元报销单后状态停在已批准,10 分钟内未出现打款记录」;关联 AC-17;复现频率写「未知(输入只记录了一次观测)」;环境事实照抄 staging / Chrome 142 / 经理账号 / 单据号,构建号标「未提供」;步骤从打开该单据、点击批准、等待至 14:18、查看流水逐步写清;期望与 AC-17 的 Then 一致;实际结果逐字保留「处理中」「已批准」和 {"ok":true,"status":"approved"};推测栏若出现,只能标注为推测且不指向支付渠道;待澄清包含是否按同样步骤重试过、构建号、批准接口完整请求响应、以及 AC-16 成功单据的对照信息是否要一并附上。文末保留人工核对声明。

失败边界与怎么改一轮
遇到下面这些输入,提示词应该停下来追问,而不是补完一张看起来完整的单。
- 只有结论没有步骤:「报销审批坏了」。应追问:哪张单据、哪个角色、点了什么、期望是什么、实际看到什么原文。
- 多个失败点揉在一起:同一段话既说批准后不打款,又说列表页筛选失效。应拆成两张单;若第二件完全没有步骤,第二张只输出追问。
- 偶发且无附加事实:「有时候会失败」。在频率中如实写偶发,并追问发生次数、是否有请求 ID 或屏幕记录;禁止写成「必现」。Tatham 的提醒是:对方若无法让程序失败,就只能请你去采集信息——不要用想象把偶发写成稳定路径。
- 把方案写成标题:若模型输出「应该把批准接口改成异步打款」,应改回问题陈述,方案最多放进标了「推测」的栏目。
- 自造严重级别或根因:输入没写 P0、也没写支付渠道故障,输出里却出现「P0,支付网关挂了」——这是失败,必须删掉或改成待澄清。

改一轮时只补输入里真正缺的事实,不要为了「结构完整」去编构建号或编一套未执行过的步骤。Mozilla 指南把复现步骤视为缺陷单里最重要的部分:别人若不能复现,甚至难以判断修复是否生效。输出仍须人工签字后才能进缺陷系统。
Unsere Einschätzung:失败验收能变成可修的缺陷,靠的是「第三者按步骤能看到同样的失败」,不是措辞更像工单。用这一份提示词强制拆单、抄原文、分开期望与实际;缺步骤就追问。它不能替代测试设计,也不能替代你在预发环境上再走一遍自己写下的步骤。


评论列表 (0条):
加载更多评论 Laden...