---
name: rp
description: 评审 PRD.md，对比 RequirementsDoc 检查一致性，输出结构化评审报告。
---

# Review PRD

当用户调用 `/rp` 时，执行以下步骤：

## 1. 读取文档

读取以下文件：
- 目标文档：`doc/PRD.md`
- 上游文档：`doc/RequirementsDoc.md`

如果 PRD.md 不存在，提示用户：
> PRD.md 不存在，请先使用 `/wp` 生成 PRD。

如果 RequirementsDoc.md 不存在，提示用户：
> RequirementsDoc.md 不存在，无法进行一致性检查。请先创建需求文档。

## 2. 评审维度

PRD 位于文档链的第二层，需要对比上游 RequirementsDoc 进行评审。

### 2.1 与 RequirementsDoc 的一致性

- [ ] PRD 是否覆盖了 RequirementsDoc 中的所有功能需求
- [ ] PRD 是否覆盖了 RequirementsDoc 中的所有非功能需求
- [ ] PRD 中是否有 RequirementsDoc 中未提及的需求（需标注来源）
- [ ] 术语定义是否与 RequirementsDoc 一致
- [ ] 优先级划分是否与 RequirementsDoc 一致

### 2.2 用户故事质量

- [ ] 所有用户故事是否有唯一 ID（US-xxx）
- [ ] 用户故事是否符合格式：作为{角色}，我想要{功能}，以便{价值}
- [ ] 用户角色是否明确定义
- [ ] 验收标准是否具体可测试
- [ ] 用户旅程是否完整描述核心流程

### 2.3 功能需求完整性

- [ ] 功能架构是否清晰（模块划分合理）
- [ ] 所有功能点是否关联到用户故事
- [ ] 功能点是否有明确的优先级
- [ ] 功能点是否有验收标准
- [ ] 是否遗漏边界情况和异常处理

### 2.4 非功能需求

- [ ] 性能需求是否有量化指标
- [ ] 安全需求是否明确
- [ ] 兼容性需求是否完整
- [ ] 可用性需求是否可验证

### 2.5 文档结构

- [ ] 文档结构是否完整（无空章节）
- [ ] 格式是否统一（表格、列表、标题层级）
- [ ] 术语表是否完整

## 3. 生成评审报告

按以下格式输出评审报告：

```markdown
# PRD 评审报告

## 概要

| 项目 | 内容 |
|------|------|
| 评审时间 | {YYYY-MM-DD HH:mm} |
| 目标文档 | doc/PRD.md |
| 参照文档 | doc/RequirementsDoc.md |
| 问题统计 | {critical} 个严重 / {major} 个一般 / {minor} 个建议 |

## 一致性检查

### 需求覆盖分析

| RequirementsDoc 需求项 | PRD 对应位置 | 状态 |
|------------------------|--------------|------|
| {需求1} | {PRD章节/用户故事ID} | ✅ 已覆盖 / ⚠️ 部分覆盖 / ❌ 未覆盖 |

### 差异说明

{列出 PRD 中新增的、RequirementsDoc 未提及的内容，需说明来源或理由}

## 问题清单

### 严重问题 (Critical)

> 必须修复，否则影响后续文档生成

1. **[位置: doc/PRD.md:行号]** 问题描述
   - 现状：...
   - 与 RequirementsDoc 的差异：...
   - 建议：...

### 一般问题 (Major)

> 建议修复，可提升文档质量

1. **[位置]** 问题描述
   - 建议：...

### 改进建议 (Minor)

> 可选优化项

1. **[位置]** 建议内容

## 用户故事评估

| 评估项 | 结果 |
|--------|------|
| 用户故事总数 | {数量} |
| 符合格式规范 | {数量} / {总数} |
| 有验收标准 | {数量} / {总数} |
| 关联功能点 | {数量} / {总数} |

### 用户故事问题

{列出不符合规范的用户故事}

## 评审结论

{通过 / 需修改后通过 / 不通过}

**结论说明**：
- 通过：PRD 与 RequirementsDoc 一致，可进入下一阶段
- 需修改后通过：存在问题但不影响整体理解，修复后可继续
- 不通过：存在严重一致性问题或遗漏，需重新生成

### 下一步行动

- [ ] 行动项1
- [ ] 行动项2
```

## 4. 保存报告

将评审报告保存到 `doc/review-PRD-claude.md`。

如果文件已存在，覆盖原文件（历史版本通过 git 追溯）。

## 5. 输出摘要

向用户展示评审摘要：
- 一致性检查结果（覆盖率）
- 发现的问题数量（按严重程度分类）
- 用户故事评估结果
- 评审结论
- 报告文件路径

---

## 注意事项

- 评审时保持客观，聚焦于文档质量和一致性
- 问题描述要具体，给出明确的位置引用（如 `doc/PRD.md:42`）
- 一致性检查要逐项对比，不能遗漏
- 建议要可操作，避免模糊表述
- 不要修改原文档，只输出评审报告

## 常见问题模式

在评审时重点关注以下常见问题：

1. **需求遗漏**：RequirementsDoc 中有但 PRD 中没有的需求
2. **需求偏离**：PRD 中的描述与 RequirementsDoc 不一致
3. **凭空添加**：PRD 中有但 RequirementsDoc 中没有的需求（需要来源说明）
4. **用户故事缺陷**：格式不规范、缺少验收标准、角色不明确
5. **功能孤立**：功能点未关联到任何用户故事
6. **优先级冲突**：PRD 与 RequirementsDoc 的优先级划分不一致