Files

John Qiu 011916ceb9 feat(req-review): 新增 VP 三件套强制检查（REQ-20260421-0002）

- 结构检查表新增「VP 三件套」必须项
- 新增「VP 三件套强制检查」章节，含四项检查指标和驳回条件
- 常见驳回原因更新：验收不明包含 VP 缺失场景

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-21 09:17:11 +09:30

name, description

name	description
req-review	PRD 评审方法论。用于需求评审、PRD 文档审查、评审意见编写。当执行 /req review 或需要评审 PRD 文档时使用。

PRD 评审方法论

PRD 评审是需求流程的关键质量关卡。

评审流程

PRD 提交 → 结构检查 → 清晰度评估 → 技术可行性 → 数据模型 → API 审查 → 结论

检查项	必须	说明
基本信息	✓	编号、标题、日期、作者
需求背景	✓	为什么需要这个功能
目标用户	✓	面向的用户群体
功能描述	✓	详细功能需求
数据模型	✓	数据库表结构
API 设计	✓	RESTful 接口
验收标准	✓	验收条件（每条 AC 必须附带 VP 三件套，见下方）
VP 三件套	✓	每条 AC 后必须有 VP-Data / VP-Steps / VP-Pass 三个子节
用户故事	○	As a... I want...
页面原型	○	如有 Stitch 原型则必审：布局合理性、与 PRD 描述一致性
非功能需求	○	性能、安全

示例：

当 PRD 包含 Stitch 生成的原型时，评审人应检查：

通过：

✅ PRD 评审通过

【结论】文档完整，需求清晰，方案可行，建议批准。
【肯定】需求背景清晰、数据模型合理、API 规范
【建议】（非阻塞）补充性能测试用例
【评审人】xxx  【时间】2026-xx-xx

驳回：

❌ PRD 评审驳回

【原因】
1. 数据模型缺少索引
2. API 缺少错误处理
3. 搜索需求描述模糊

【修改要求】
□ 补充索引设计
□ 明确错误码
□ 细化搜索实现

【驳回人】xxx  【时间】2026-xx-xx

每条 AC 必须附带完整的 Verification Protocol，缺一项即驳回。

检查项	要求	驳回条件
VP-Data	前置测试数据规格（环境/字段值/状态缺一不可）	未注明在哪个环境建数据
VP-Steps	可重复执行的验证步骤（工具 + 操作 + 检查指标）	步骤无法被第三方重复执行
VP-Pass	明确判定标准（含 ✅ 通过条件 + ❌ 不通过条件）	只写"效果正确"之类模糊描述
环境隔离	localhost 测试数据用 curl，生产数据用 MCP	混用环境

评审结论规则：VP 三件套任何一项缺失 → 驳回，注明「AC N 缺少 VP-XXX，退回补充」。