PRD 需求分析

PRD Requirement Analysis

分析 HM Desktop PRD 文档并生成结构化的需求分析报告。

Analyze HM Desktop PRD documents and generate structured requirement analysis reports.

快速开始

Quick Start

提供 PRD 文件路径：

分析 PRD: {PRD文件路径}

或指定具体选项：

分析 PRD: {PRD文件路径}
- 输出格式：JSON
- 检查完整性：是
- 提取 KEP：是
- 检测冲突：是

Provide the PRD file path:

Analyze PRD: {PRD File Path}

Or specify specific options:

Analyze PRD: {PRD File Path}
- Output Format: JSON
- Check Completeness: Yes
- Extract KEP: Yes
- Detect Conflicts: Yes

分析流程

Analysis Process

1. 文档元数据解析

1. Document Metadata Parsing

提取以下信息：

文档版本（VX.X 格式）
创建日期（YYYY-MM-DD）
文档作者/团队
产品名称
目标版本

Extract the following information:

Document Version (in VX.X format)
Creation Date (YYYY-MM-DD)
Document Author/Team
Product Name
Target Version

2. KEP（关键体验路径）提取

2. KEP (Key Experience Path) Extraction

对每个找到的 KEP，提取：

KEP ID：格式应为 KEP1-01、KEP1-02 等
KEP 名称：简洁、包含动词的名称
优先级：P0（关键）、P1（重要）、P2（可选）
用户故事：用户场景描述
验收标准：明确的验证条件

For each identified KEP, extract:

KEP ID: Should be in formats like KEP1-01, KEP1-02, etc.
KEP Name: Concise, verb-included name
Priority: P0 (Critical), P1 (Important), P2 (Optional)
User Story: User scenario description
Acceptance Criteria: Clear verification conditions

3. 需求统计

3. Requirement Statistics

需求总数
P0 需求数量（发布必需）
P1 需求数量（重要但不阻塞）
P2 需求数量（未来增强）

Total number of requirements
Number of P0 requirements (Mandatory for release)
Number of P1 requirements (Important but non-blocking)
Number of P2 requirements (Future enhancements)

4. 完整性验证

4. Completeness Verification

5. 章节顺序验证

5. Chapter Order Validation

验证 PRD 文档章节是否符合标准顺序：

标准顺序：需求来源 → 需求背景 → 需求价值分析 → 竞品分析 → 需求描述

检测逻辑：

提取文档中所有一级标题（# 开头）
验证前5章的标题是否符合要求
如顺序错误，列出问题并建议调整
如缺失竞品分析章节，明确提示补充

输出格式：

章节顺序检查结果：
✅ 第1章：需求来源
✅ 第2章：需求背景
✅ 第3章：需求价值分析
❌ 第4章：竞品分析（缺失，需补充）
✅ 第5章：需求描述

Verify if PRD document chapters comply with the standard order:

Standard Order: Requirement Source → Requirement Background → Requirement Value Analysis → Competitor Analysis → Requirement Description

Detection Logic:

Extract all level-1 headings (starting with #) from the document
Verify if the first 5 chapters meet the requirements
If the order is incorrect, list the issues and suggest adjustments
If the Competitor Analysis chapter is missing, clearly prompt to supplement it

Output Format:

Chapter Order Check Results:
✅ Chapter 1: Requirement Source
✅ Chapter 2: Requirement Background
✅ Chapter 3: Requirement Value Analysis
❌ Chapter 4: Competitor Analysis (Missing, needs supplement)
✅ Chapter 5: Requirement Description

6. 冲突检测

6. Conflict Detection

检查：

同一功能在不同章节描述不一致
优先级冲突（P0 项目过多）
技术可行性风险
矛盾的用户场景

Check for:

Inconsistent descriptions of the same function in different chapters
Priority conflicts (Excessive P0 items)
Technical feasibility risks
Contradictory user scenarios

7. 竞品分析章节检查

7. Competitor Analysis Chapter Check

检查内容：

检查项	说明
章节位置	竞品分析必须在第4章
竞品数量	至少分析2个竞品
对比维度	功能、技术、体验、成本等
差异化	是否明确说明差异化优势
证据支撑	是否有数据或案例支撑

输出：如竞品分析缺失或不足，生成补充建议模板

Check Items:

Check Item	Description
Chapter Position	Competitor Analysis must be in Chapter 4
Number of Competitors	Analyze at least 2 competitors
Comparison Dimensions	Function, technology, experience, cost, etc.
Differentiation	Whether differential advantages are clearly stated
Evidence Support	Whether there is data or case support

Output: If Competitor Analysis is missing or insufficient, generate a supplementary suggestion template

8. 模块划分建议

8. Module Division Suggestions

按照 references/module_mapping.md 的指导将需求映射到服务模块。

Map requirements to service modules according to the guidelines in references/module_mapping.md.

输出格式

Output Formats

Markdown 报告（默认）

Markdown Report (Default)

生成

prd_analysis_report.md

，包含：

文档信息
需求概述
KEP 列表
完整性检查结果
冲突检测结果
模块划分建议

Generate

prd_analysis_report.md

, including:

Document Information
Requirement Overview
KEP List
Completeness Check Results
Conflict Detection Results
Module Division Suggestions

JSON 格式

JSON Format

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": [...]
}

json

{
  "prd_info": {
    "file": "{PRD File Name}",
    "version": "VX.X",
    "date": "2026-01-31"
  },
  "requirements": {
    "total": 25,
    "p0": 8,
    "p1": 12,
    "p2": 5
  },
  "kep_list": [...],
  "completeness": {...},
  "conflicts": [...],
  "module_suggestions": [...]
}

参考文档

Reference Documents

PRD 格式要求: references/prd_format.md
完整性规则: references/completeness_rules.md
KEP 验证: references/kep_validation.md
模块映射: references/module_mapping.md

PRD Format Requirements: references/prd_format.md
Completeness Rules: references/completeness_rules.md
KEP Verification: references/kep_validation.md
Module Mapping: references/module_mapping.md

报告模板

Report Template

自定义报告格式，参见 assets/report_template.md。

Customize report format, see assets/report_template.md.

错误处理

Error Handling

错误类型	处理方式
PRD 文件未找到	提示用户检查文件路径
格式不符合规范	列出缺失的必需章节
需求冲突	列出冲突和建议的解决方案
读取失败	检查文件编码（应为 UTF-8）

Error Type	Handling Method
PRD File Not Found	Prompt user to check the file path
Non-Compliant Format	List missing mandatory chapters
Requirement Conflicts	List conflicts and suggested solutions
Read Failure	Check file encoding (should be UTF-8)

使用示例

Usage Examples

基本分析：

分析 {PRD文件路径} 这个 PRD

输出 JSON 格式：

分析 {PRD文件名}，以 JSON 格式输出结果

仅检查完整性：

检查 {PRD文件名} 是否包含所有必需的 PRD 章节

提取 KEP：

从 {PRD文件名} 中提取所有 KEP 定义

检测冲突：

检查 {PRD文件名} 中是否存在需求冲突

模块划分建议：

根据 {PRD文件名} 的需求，建议如何划分服务模块

Basic Analysis:

Analyze this PRD: {PRD File Path}

Output in JSON Format:

Analyze {PRD File Name} and output results in JSON format

Check Completeness Only:

Check if {PRD File Name} contains all mandatory PRD chapters

Extract KEP:

Extract all KEP definitions from {PRD File Name}

Detect Conflicts:

Check if there are requirement conflicts in {PRD File Name}

Module Division Suggestions:

Based on the requirements in {PRD File Name}, suggest how to divide service modules

oh-pdd-prd-analysis

Original

Translation