PRD 需求分析
分析 HM Desktop PRD 文档并生成结构化的需求分析报告。
快速开始
提供 PRD 文件路径：
分析 PRD: {PRD文件路径}或指定具体选项：
分析 PRD: {PRD文件路径}
- 输出格式：JSON
- 检查完整性：是
- 提取 KEP：是
- 检测冲突：是分析流程
1. 文档元数据解析
提取以下信息：
- 文档版本（VX.X 格式）
- 创建日期（YYYY-MM-DD）
- 文档作者/团队
- 产品名称
- 目标版本
2. KEP（关键体验路径）提取
对每个找到的 KEP，提取：
- KEP ID：格式应为 KEP1-01、KEP1-02 等
- KEP 名称：简洁、包含动词的名称
- 优先级：P0（关键）、P1（重要）、P2（可选）
- 用户故事：用户场景描述
- 验收标准：明确的验证条件
3. 需求统计
- 需求总数
- P0 需求数量（发布必需）
- P1 需求数量（重要但不阻塞）
- P2 需求数量（未来增强）
4. 完整性验证
使用 references/completeness_rules.md 中的检查清单验证所有必需章节。
标准章节顺序：需求来源 → 需求背景 → 需求价值分析 → 竞品分析 → 需求描述
章节顺序验证：
- 第1章：需求来源
- 第2章：需求背景
- 第3章：需求价值分析
- 第4章：竞品分析（必需）
- 第5章：需求描述
- 后续章节是否符合规范
竞品分析章节检查：
- 是否存在独立的竞品分析章节（第4章）
- 竞品数量是否≥2个
- 是否包含竞品功能对比表格
- 是否包含竞品技术方案分析
5. 章节顺序验证
验证 PRD 文档章节是否符合标准顺序：
标准顺序：需求来源 → 需求背景 → 需求价值分析 → 竞品分析 → 需求描述检测逻辑：
- 提取文档中所有一级标题（# 开头）
- 验证前5章的标题是否符合要求
- 如顺序错误，列出问题并建议调整
- 如缺失竞品分析章节，明确提示补充
输出格式：
章节顺序检查结果：
✅ 第1章：需求来源
✅ 第2章：需求背景
✅ 第3章：需求价值分析
❌ 第4章：竞品分析（缺失，需补充）
✅ 第5章：需求描述6. 冲突检测
检查：
- 同一功能在不同章节描述不一致
- 优先级冲突（P0 项目过多）
- 技术可行性风险
- 矛盾的用户场景
7. 竞品分析章节检查
检查内容：
| 检查项 | 说明 |
|---|---|
| 章节位置 | 竞品分析必须在第4章 |
| 竞品数量 | 至少分析2个竞品 |
| 对比维度 | 功能、技术、体验、成本等 |
| 差异化 | 是否明确说明差异化优势 |
| 证据支撑 | 是否有数据或案例支撑 |
输出：如竞品分析缺失或不足，生成补充建议模板
8. 模块划分建议
按照 references/module_mapping.md 的指导将需求映射到服务模块。
输出格式
Markdown 报告（默认）
生成 prd_analysis_report.md，包含：
- 文档信息
- 需求概述
- KEP 列表
- 完整性检查结果
- 冲突检测结果
- 模块划分建议
JSON 格式
{
"prd_info": {
"file": "{PRD文件名}",
"version": "VX.X",
"date": "2026-01-31"
},
"requirements": {
"total": 25,
"p0": 8,
"p1": 12,
"p2": 5
},
"kep_list": [...],
"completeness": {...},
"conflicts": [...],
"module_suggestions": [...]
}参考文档
- PRD 格式要求: references/prd_format.md
- 完整性规则: references/completeness_rules.md
- KEP 验证: references/kep_validation.md
- 模块映射: references/module_mapping.md
报告模板
自定义报告格式，参见 assets/report_template.md。
错误处理
| 错误类型 | 处理方式 |
|---|---|
| PRD 文件未找到 | 提示用户检查文件路径 |
| 格式不符合规范 | 列出缺失的必需章节 |
| 需求冲突 | 列出冲突和建议的解决方案 |
| 读取失败 | 检查文件编码（应为 UTF-8） |
使用示例
基本分析：
分析 {PRD文件路径} 这个 PRD输出 JSON 格式：
分析 {PRD文件名}，以 JSON 格式输出结果仅检查完整性：
检查 {PRD文件名} 是否包含所有必需的 PRD 章节提取 KEP：
从 {PRD文件名} 中提取所有 KEP 定义检测冲突：
检查 {PRD文件名} 中是否存在需求冲突模块划分建议：
根据 {PRD文件名} 的需求，建议如何划分服务模块