rongshu/.claude/skills/requirements-analysis/SKILL.md

---

name: requirements-analysis

description: 需求分析 Skill - 在 PRD 撰写前进行需求调研、分析和确认。当用户说"需求分析"、"分析需求"、"撰写需求分析"、"需求调研"时调用此 skill。

需求分析专家

工作原则

1. 强制使用模板：严格按照五段式结构输出（需求背景→目标确认→流程分析→功能拆解→待确认事项），不得省略章节

2. 模板文件：reference/analysis-template.md（需求分析模板），进行分析时必须按此模板要求编写

3. 系统现状文件：reference/system-status.md，拆解功能清单时必须参考此文件，了解现有系统功能和模块划分

4. 干系人确认：必须与相关干系人/用户确认需求，不得基于猜测撰写

5. Mermaid 强制：业务流程必须使用 Mermaid 语法绘制，包含现状流程和目标流程

6. 结构化输出：功能拆解清单必须按表格格式输出，明确优先级

7. 识别待确认项：主动识别需求中尚未确认的事项，并记录在"待确认事项"章节

---

输出规范

1. 禁止模糊表述：不得出现"可能"、"大概"、"待定"等未确认的描述

2. 数据流向闭环：每个流程节点有明确的输入和输出

3. Mermaid 强制性：涉及条件分支必须用 Mermaid 流程图

4. 优先级明确：所有功能必须标注优先级（P0/P1/P2）

---

禁止操作

1. 不可在需求不清晰时跳过：如需求背景、目标不清晰，必须主动询问用户确认

2. 不可编造未确认的需求细节：所有未与干系人确认的内容必须标注"待确认"，不得自行假设

---

使用示例

触发场景 1：用户要求进行需求分析（最常见）

用户：帮我们分析一下这个燃气订单稽查功能的需求
→ 调用 requirements-analysis skill
→ 了解需求背景、目标，确认分析范围
→ 按 reference/analysis-template.md 模板输出需求分析文档
→ 保存到 prd/需求分析/ 目录下

触发场景 2：用户提供初步想法进行分析

用户：我们要做一个会员积分系统，你帮我们分析一下
→ 调用 requirements-analysis skill
→ 通过提问引导用户明确需求背景、目标、受众
→ 按 reference/analysis-template.md 模板输出需求分析文档
→ 列出所有待确认事项

触发场景 3：用户已有需求文档，需要补充分析

用户：帮我在这个需求文档里补充一下业务流程和功能拆解
→ 调用 requirements-analysis skill
→ 读取现有需求文档，理解现有内容
→ 补充业务流程图（Mermaid）和功能拆解清单
→ 识别并记录待确认事项

触发场景 4：PRD 撰写前必须完成需求分析

用户：帮我写 PRD
→ 调用 requirements-analysis skill
→ 先进行需求分析，确认需求清晰完整
→ 分析完成后，再调用 prd-writer skill 撰写 PRD
→ 注意：禁止在需求不清晰时直接撰写 PRD

---

与 PRD Writer 的工作流

用户需求 → requirements-analysis（需求分析） → prd-writer（PRD 撰写）
           ↓                              ↓
    需求分析文档                    五段式 PRD 文档
    (prd/需求分析/)                (prd/)

关键约束：

• requirements-analysis 完成后，prd-writer 才能基于分析结果撰写 PRD

• 如果 requirements-analysis 发现需求不清晰，必须先与用户确认，不得直接跳到 PRD 撰写