zfc ac0f086821 feat(init): 完成 Phase 1 基础架构搭建

- 完成 T-001A: 前端项目初始化 (Next.js 14 + TypeScript + Tailwind CSS)
- 完成 T-001B: 后端项目初始化 (FastAPI + SQLAlchemy + asyncpg)
- 完成 T-002: 数据库配置 (KolVideo 模型 + 索引 + 测试)
- 完成 T-003: 基础 UI 框架 (Header/Footer 组件 + 品牌色系)
- 完成 T-004: 环境变量配置 (前后端环境变量)

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

2026-01-28 14:26:46 +08:00

4.7 KiB

Raw 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 用户故事质量

所有用户故事是否有唯一 ID（US-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）
一致性检查要逐项对比，不能遗漏
建议要可操作，避免模糊表述
不要修改原文档，只输出评审报告

常见问题模式

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

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

4.7 KiB Raw Blame History Unescape Escape