# Requirements Analyst

> 需求分析助手，将模糊需求转换为结构化文档。支持两种输出格式：用户故事（User Story）适合敏捷开发，PRD（产品需求文档）适合完整功能规划。通过针对性提问澄清歧义。

- Skill: `kaelen-hou/requirements-analyst` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add kaelen-hou/requirements-analyst`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kaelen-hou/requirements-analyst/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: kaelen-hou (https://skillmd.com/u/kaelen-hou)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/kaelen-hou/requirements-analyst

---


# Requirements Analyst

将模糊需求转换为清晰、可执行的需求文档。

## 如何使用

### 触发方式

直接向 Claude 描述你的需求，例如：

```
我需要一个用户登录功能
```

```
帮我分析这个需求：用户可以在平台上发布和浏览商品
```

```
写一份用户系统的 PRD
```

### 使用流程

1. **描述需求** - 用自然语言描述你想要的功能（可以模糊、不完整）
2. **选择格式** - 助手会询问输出格式（用户故事 / PRD）
3. **回答问题** - 助手会提出澄清问题，选择或输入你的答案
4. **获取文档** - 助手输出结构化的需求文档
5. **确认调整** - 根据需要要求修改或补充

### 示例对话

**用户输入：**
> 我需要一个购物车功能

**助手响应：**

1. 识别缺失信息（用户类型、功能范围、边界条件）
2. 提出澄清问题：
   - 购物车是否支持游客使用？
   - MVP 需要哪些功能？（增删商品/保存/优惠券）
   - 有商品数量上限吗？
3. 根据回答生成用户故事：

```markdown
## User Story: 添加商品到购物车

**As a** 网站访客或注册用户
**I want** 将商品添加到购物车
**So that** 我可以继续浏览并稍后一起结账

### Acceptance Criteria
- [ ] Given 用户在商品详情页，when 点击"加入购物车"，then 商品被添加且显示成功提示
- [ ] Given 购物车已有该商品，when 再次添加，then 数量增加而非重复添加
```

## 分析工作流程

### Phase 1: 理解阶段

1. **接收需求** - 读取用户提供的原始需求文本
2. **识别关键要素**:
   - 用户角色 (Who) - 明确或隐含的用户类型
   - 期望结果 (What) - 用户想要实现什么
   - 业务价值 (Why) - 为什么需要这个功能
   - 约束条件 - 技术、时间、资源限制
3. **标记模糊点** - 识别需要澄清的部分

### Phase 2: 澄清阶段

使用 AskUserQuestion 解决模糊点。按优先级提问：

1. **关键未知** - 没有这个信息无法编写故事
2. **范围澄清** - 边界条件和边缘情况
3. **验收细节** - 如何验证功能完成

提问原则：

- 批量提问 (3-5 个问题一组)
- 提供选项而非开放式问题
- 说明如果不回答会采用的默认假设

### Phase 3: 生成阶段

根据选择的输出格式生成文档：

- **用户故事**: 按照 [USER_STORY_TEMPLATE.md](references/USER_STORY_TEMPLATE.md) 生成
- **PRD**: 按照 [PRD_TEMPLATE.md](references/PRD_TEMPLATE.md) 生成

### Phase 4: 确认阶段

- 使用 INVEST 检查清单验证故事完整性
- 如果故事过大，提供拆分选项
- 与用户确认并接受反馈

## 快速开始

典型需求分析流程：

1. 用户提供模糊需求
2. 助手识别缺失信息，提出澄清问题
3. 用户回答问题
4. 助手生成格式化用户故事和验收标准

## 输出格式

### 用户故事格式

```markdown
## User Story: [简短标题]

**As a** [用户类型/角色]
**I want** [功能/能力]
**So that** [价值/收益]

### Acceptance Criteria
- [ ] Given [上下文], when [操作], then [预期结果]
- [ ] Given [上下文], when [操作], then [预期结果]

### Notes
- [假设说明]
- [识别的依赖]
- [排除范围]
```

### PRD 格式

```markdown
# [产品/功能名称] PRD

## 1. 概述
### 1.1 背景
[为什么要做这个功能]
### 1.2 目标
[业务目标和用户目标]
### 1.3 成功指标
[如何衡量成功]

## 2. 用户分析
### 2.1 目标用户
[用户画像]
### 2.2 用户痛点
[当前问题]
### 2.3 用户场景
[典型使用场景]

## 3. 功能需求
### 3.1 功能列表
[功能清单和优先级]
### 3.2 功能详情
[每个功能的详细说明]
### 3.3 用户故事
[对应的用户故事]

## 4. 非功能需求
[性能/安全/兼容性要求]

## 5. 数据需求
[数据模型和流转]

## 6. 开放问题
[待决策事项]
```

## 参考资料

### 用户故事模板

**何时加载**: 生成用户故事时

参见 [USER_STORY_TEMPLATE.md](references/USER_STORY_TEMPLATE.md):

- 标准用户故事格式
- INVEST 检查清单
- 故事拆分策略

### PRD 模板

**何时加载**: 生成 PRD 文档时

参见 [PRD_TEMPLATE.md](references/PRD_TEMPLATE.md):

- 完整 PRD 结构
- 各部分编写指南
- PRD vs 用户故事对比

### 验收标准指南

**何时加载**: 编写验收标准时

参见 [ACCEPTANCE_CRITERIA.md](references/ACCEPTANCE_CRITERIA.md):

- Given-When-Then 格式
- 不同类型验收标准示例
- 编写原则

### 提问策略

**何时加载**: 需要向用户提问时

参见 [CLARIFICATION_QUESTIONS.md](references/CLARIFICATION_QUESTIONS.md):

- 何时提问 vs 何时假设
- 按类别分类的问题库
- 问题模板