requirement-analysis

# 需求分析技能 (Requirement Analysis Skill)

本技能提供系统化的需求分析工作流，确保在实施前彻底理解需求。

---

## 快速开始

**7 阶段工作流概览**：
```
需求理解 → 代码探索 → 澄清问题 → 深度分析 → 展示计划 → 实施 → 代码审查
```

**核心特性**：
- 🧠 智能使用 ultrathink 进行深度分析
- 🔍 支持并行探索和审查模式
- 🌐 集成外部资源查询（context7、exa）
- 📋 结构化输出和实施计划
- 自适应语言交互

**触发方式**：
- 自动触发：用户提出功能开发、API设计等需求
- 手动触发：`/requirement-analysis`、`使用需求分析skill`

---

## 工作流程概览

### 阶段 1: 需求理解

**目标**：全面理解用户需求

**执行要点**：
- 识别核心功能、业务实体、API 端点、业务规则
- 根据复杂度决定是否使用 ultrathink
- 记录需求理解摘要

**何时使用 ultrathink**：
- ✅ 需求涉及多个模块或系统集成
- ✅ 需求包含复杂业务逻辑或工作流
- ✅ 需求描述模糊或不完整
- ❌ 简单 CRUD 或单一模块需求可跳过

---

### 阶段 2: 代码库探索

**首要任务**：查找并阅读 **CLAUDE.md** 文件

**基础模式**（简单需求）：
- 使用单个 Explore agent
- 快速定位相关代码

**并行模式**（复杂需求）：⚡
- 同时启动 2-5 个 Explore agent
- 按架构层次、功能模块或关注点分解
- **详细指南**：[references/parallel-patterns.md](references/parallel-patterns.md)

**查找内容**：
- CLAUDE.md 规范
- 相关实体和服务
- 现有模式和约定

---

### 阶段 2.5: 外部资源研究

**执行条件**（满足任一即执行）：
- ✅ 涉及新的第三方库或框架
- ✅ 需要了解行业最新实践
- ✅ 内部代码库示例不充分

**工具使用**：
1. **网页搜索**：优先 exa MCP，降级到 WebSearch
2. **库文档**：优先 context7 MCP，降级到 WebSearch + Grep + Read

**何时跳过**：
- ⏭️ 完全基于已有代码
- ⏭️ 团队对技术已经熟悉
- ⏭️ 时间紧急且需求简单

---

### 阶段 3: 澄清问题

**重要**：对任何不清楚、模糊、有歧义的地方，必须使用 **AskUserQuestion 工具**。

**澄清内容**：
- 模糊或规格不足的需求
- 多个有效实施方法之间的选择
- 业务规则细节
- 技术选型或架构决策

---

### 阶段 4: 深度分析

**必须使用 ultrathink**：使用 **mcp__sequential-thinking__sequentialthinking 工具**

**⚠️ 上下文注意事项**：
虽然 ultrathink 能够访问完整的对话历史，但在进行深度分析时，建议明确引用和总结之前阶段的关键发现，确保分析的连贯性和准确性。

**分析内容**：
1. **分析需求组件**
   - 回顾阶段 1 的需求理解结果
   - 分解为可实施的功能模块

2. **设计数据结构**（符合 CLAUDE.md 规范）
   - 基于阶段 2 的代码库探索发现
   - 遵循项目的数据库设计规范和模式

3. **设计 API 端点**（符合 CLAUDE.md 规范）
   - 参考项目现有的 API 设计模式
   - 遵循项目的路由命名和结构约定

4. **设计服务层**（符合 CLAUDE.md 规范）
   - 遵循项目的架构模式和分层约定
   - 复用项目中已有的设计模式和抽象

5. **识别风险和边缘情况**
   - 考虑阶段 3 中用户澄清的特殊情况
   - 分析潜在的技术和业务风险

6. **规划详细实施步骤**
   - 整合所有上述分析
   - 制定可执行的分步实施计划

---

### 阶段 5: 展示实施计划

向用户展示：
1. **需求总结** - 理解的核心要点
2. **代码库发现** - 相关代码和模式
3. **外部资源**（如适用）- 搜索结果和库文档
4. **技术设计** - 数据库、API、服务层
5. **实施步骤** - 编号的详细步骤
6. **风险和注意事项**

**重要**：在用户确认前，不要开