需求文档转成能逐条勾选的验收清单
实测于 2026-11-14 · 数字来自一次真实运行
这一页的运行记录来自一次真实运行,不是估计值。token用量没采集到就写「未采集」,不填数字。
适用场景
需求文档写了几页,开发和测试各按自己的理解做,验收时扯不清。要一份能逐条勾的清单,而且每条都要能对应回原文。
准备
- 宿主版本
- 0.1.2-alpha.5
- 模型
- 待填
- 模式 / 权限
- --profile headless / workspace-write / Windows 11 / node 22.22.2
- 需装插件
- 无(如用到插件,在实测后补齐名称与版本)
- 输入材料
- 自造1,225字PRD(积分兑换页改版),故意埋了两处矛盾:3.1说「展示可兑换商品」而3.3说「库存0仍展示」;4节说「成功率不低于改版前」而1节只给了「转化率2.3%」
完整指令
读 prd.md,生成验收清单 acceptance.md。
【输出】
表格,列:编号 | 验收项 | 判定方式(怎么算通过) | 原文依据(章节号 + 原句片段) | 类型(功能/边界/性能/交互/数据) | 可测性(可自动/需人工/不可测)
【硬约束】
1. 每条验收项必须能在原文找到依据。找不到依据的,不要写进清单,单独列在「原文未明确的需求」一节。
2. 判定方式必须是可观察、可核对的动作或结果,禁止写「符合预期」「体验良好」「功能正常」这类无法判定的词。
3. 「不可测」这个值允许出现,但必须写清为什么不可测(例如「原文只说要快,没给具体指标」)。
4. 原文若自相矛盾(前后说法冲突),单独列在「需求冲突」一节,两条原文都贴出来,不要自己选一个。
5. 不要补充原文没有的需求。你想到但原文没写的,放在最后一节「建议补充但原文未要求」,与验收清单严格分开。
【分段交付】
先只做原文的前三分之一给我看格式,我确认后再继续。
最后报告:共几条验收项、各类类型各几条、可测性分布、几条原文未明确、几处需求冲突。运行记录
| 项目 | 数值 | 备注 |
|---|---|---|
| 耗时 | 1分44秒 | 2026-11-14 |
| 结果 | 25条验收项(可测20 / 部分可测2 / 不可测3);抓到2处需求冲突、15条原文未明确、12条建议补充;产物16,610字节;零残留 | |
| 输入 / 输出token | 未采集 | |
| 残留 | 无残留,工作区只有prd.md与acceptance.md。 |
实测发现
- 两处埋的矛盾全部抓到,而且没有替我选一个:C-01报「3.1展示可兑换商品vs 3.3库存0仍展示,对列表集合的定义相反」;C-02报「目标是提升转化vs成功率不低于改版前,两者是否同一指标未说明」。
- 「判定方式」这一列没有一处是空话。举三个实际的:余额不足的差额校验写成「构造若干组 (P,B) 且B<P,页面提示差额D满足D = P − B,例P=1000、B=300须提示700」;按钮置灰写成「disabled为true且点击后抓包无兑换提交,并设B≥P的对照组证明非恒置灰」;事务一致性写成「故障注入使库存扣减影响行数为0,须同时满足接口失败、库存不变、余额不变、记录未新增、界面无成功提示」。
- 它把原文的三句空话判成「不可测」而不是硬编个标准:4G流畅、加载要快、成功率不低于改版前,都写清缺什么(无量化指标、无阈值与计时口径、无基线数值与统计口径)。这是清单最有价值的输出——原文的缺陷被暴露了。
- 「原文未明确」列了15条(确认页展示哪些商品信息、按钮在哪一层、库存展示格式、失败提示等),全部没有混进主表。建议补充的12条单独成节,与主表严格隔离。
- 它自己加了可测性的三档定义(可测 / 部分可测 / 不可测)并说明每档的判定口径,放在表格前——这是我指令里没要求的,属于合理补强。
这条配方的核心是第2条(判定方式必须可观察)和第5条(不许补需求)。去掉第2条你会得到一份「符合预期」的清单,去掉第5条你会得到一份看起来更完整、但分不清哪些是原文要的清单。
产物
跑通后在这里给出文件清单与截图,并说明原始文件有没有被改动。
验收清单
点一下可勾选,用来逐条核对。
- 每条验收项都能在原文找到依据(抽查三条去原文核对)
- 没有出现「符合预期」「功能正常」这类无法判定的判定方式
- 「不可测」的条目写清了为什么不可测
- 原文矛盾被单列,没有替你选一个
- 「建议补充」与验收清单严格分开,没有混进去
失败与边界
- 这条配方最容易失守的是第5条:模型很爱补需求,而且补得很合理。所以「建议补充」必须单独成节,一混进清单你就分不清哪些是原文要的
- 「判定方式」这一列是整条配方的价值所在。写成「能正常提交」等于没写;写成「提交后3秒内返回成功,且列表页出现该条记录」才可核对
- 需求文档里常见的「响应快」「体验流畅」这类词,会被归到「不可测」——这不是配方的缺陷,是原文的缺陷。清单能把这个缺陷暴露出来,本身就是产出