zfc d372fd82f9 feat: Add 19 Claude Code skills for document workflow
Skills included:
- Review (6): rr, rp, rf, rd, ru, rt
- Write (5): wp, wf, wd, wu, wt
- Modify (6): mr, mp, mf, md, mu, mt
- Utils (2): iter, up

Supports complete document lifecycle:
RequirementsDoc → PRD → FeatureSummary → DevelopmentPlan → UIDesign → tasks

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 11:27:09 +08:00

4.7 KiB
Raw Permalink Blame History

name description
rp 评审 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 用户故事质量

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

2.3 功能需求完整性

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

2.4 非功能需求

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

2.5 文档结构

  • 文档结构是否完整(无空章节)
  • 格式是否统一(表格、列表、标题层级)
  • 术语表是否完整

3. 生成评审报告

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

# 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 的优先级划分不一致