skills/oh-pdd-prd-analysis/SKILL.md
分析 HM Desktop PRD 文档,提取需求信息、验证完整性、检查章节顺序(需求来源→需求背景→需求价值分析→竞品分析→需求描述)、检查 KEP 定义、检测需求冲突并生成结构化分析报告。适用于用户请求:(1) 分析或审查 PRD 文档, (2) 从需求中提取 KEP 列表, (3) 检查 PRD 完整性或一致性, (4) 将需求映射到模块架构, (5) 验证 PRD 格式合规性, (6) 验证竞品分析章节完整性。关键词:PRD分析, requirement extraction, KEP验证, completeness check, chapter order validation, 竞品分析检查, analyze PRD, 需求提取, 完整性检查, 章节顺序验证
npx skillsauth add openharmonyinsight/openharmony-skills oh-pdd-prd-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
分析 HM Desktop PRD 文档并生成结构化的需求分析报告。
提供 PRD 文件路径:
分析 PRD: {PRD文件路径}
或指定具体选项:
分析 PRD: {PRD文件路径}
- 输出格式:JSON
- 检查完整性:是
- 提取 KEP:是
- 检测冲突:是
提取以下信息:
对每个找到的 KEP,提取:
使用 references/completeness_rules.md 中的检查清单验证所有必需章节。
标准章节顺序:需求来源 → 需求背景 → 需求价值分析 → 竞品分析 → 需求描述
章节顺序验证:
竞品分析章节检查:
验证 PRD 文档章节是否符合标准顺序:
标准顺序:需求来源 → 需求背景 → 需求价值分析 → 竞品分析 → 需求描述
检测逻辑:
输出格式:
章节顺序检查结果:
✅ 第1章:需求来源
✅ 第2章:需求背景
✅ 第3章:需求价值分析
❌ 第4章:竞品分析(缺失,需补充)
✅ 第5章:需求描述
检查:
检查内容:
| 检查项 | 说明 | |--------|------| | 章节位置 | 竞品分析必须在第4章 | | 竞品数量 | 至少分析2个竞品 | | 对比维度 | 功能、技术、体验、成本等 | | 差异化 | 是否明确说明差异化优势 | | 证据支撑 | 是否有数据或案例支撑 |
输出:如竞品分析缺失或不足,生成补充建议模板
按照 references/module_mapping.md 的指导将需求映射到服务模块。
生成 prd_analysis_report.md,包含:
{
"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": [...]
}
自定义报告格式,参见 assets/report_template.md。
| 错误类型 | 处理方式 | |----------|----------| | PRD 文件未找到 | 提示用户检查文件路径 | | 格式不符合规范 | 列出缺失的必需章节 | | 需求冲突 | 列出冲突和建议的解决方案 | | 读取失败 | 检查文件编码(应为 UTF-8) |
基本分析:
分析 {PRD文件路径} 这个 PRD
输出 JSON 格式:
分析 {PRD文件名},以 JSON 格式输出结果
仅检查完整性:
检查 {PRD文件名} 是否包含所有必需的 PRD 章节
提取 KEP:
从 {PRD文件名} 中提取所有 KEP 定义
检测冲突:
检查 {PRD文件名} 中是否存在需求冲突
模块划分建议:
根据 {PRD文件名} 的需求,建议如何划分服务模块
testing
--- name: ohos-req-value-decision description: Use after review meeting to record decision and route to next step. Triggers: 评审决策纪要, 评审结论回流, value decision, 评审接纳, 评审不接纳, 评审退回, 下次重新上会. Do NOT use for feature baseline (ohos-req-feature-baseline), review gate checks (ohos-req-review-gate), or IR generation (ohos-req-feature-to-ir). metadata: author: openharmony scope: common stage: requirements capability: value-decision version: 0.3.0 status: draft tags: - sdd - requirements
development
Use when converting an OpenHarmony requirement document, spec, or design proposal into an OpenHarmony review slide deck (需求评审 / 需求变更评审 / 设计评审 PPTX) — produces the fixed OpenHarmony-branded review-deck structure (OH logo on every page) with architecture/flow diagrams and field tables. Triggers on "需求评审PPT", "需求变更评审", "把需求文档转成评审PPT", "spec转评审PPT", "requirement/spec to review deck". NOT for arbitrary or generic slide decks unrelated to OpenHarmony requirement/design review.
testing
Use when performing the Phase 0 Step 0.5 Review Ready Gate on a 04-feature.md, especially when the user says "evaluate gate", "review readiness", "feature ready?", "should we generate IR", or when the ohos-req-intake-orchestration main session needs a structured Ready / Conditional Ready / Not Ready judgment instead of doing the check inline. Reads 01-04, runs seven fixed checks plus a conditional-items check, and returns a machine-readable JSON summary plus a human-readable table that the main session can route on. Do NOT use for feature baseline generation (ohos-req-feature-baseline), value decision recording (ohos-req-value-decision), or IR generation (ohos-req-feature-to-ir).
testing
--- name: ohos-req-requirement-intake description: Use when importing an OHOS requirement into Phase 0.1, especially for 01-requirement.md, requirement intake, background, user value, scenarios, scope, FR/NFR, affected modules, or priority. Triggers: 需求导入, 01-requirement, 需求基线, RR单号. Do NOT use for feasibility analysis (ohos-req-feasibility-analysis), architecture decision (ohos-req-arch-decision), or feature baseline (ohos-req-feature-baseline). metadata: author: openharmony scope: common