requirement-analysis

# 需求分析技能

提供系统化的 9 阶段需求分析与实施工作流，确保从深度分析到质量交付的完整过程。

---

## 快速开始

**工作流** (阶段 1-9)：
```
需求理解 → 代码探索 → 外部资源研究 → 澄清问题 → 深度分析 → 展示计划 → 实施开发 → 代码审查 → 总结
```

**核心特性**：
- 深度分析：使用 ultrathink 进行复杂需求分析
- 外部资源：集成 context7、exa 研究最佳实践
- 结构化产出：详细的实施计划 + 完整代码实现
- Task List 管理：进度可视化、断点恢复

**与 feat-dev 的区别**：
- 本技能：9 阶段，**包含外部资源研究**，适合复杂需求和新技术栈
- feat-dev：7 阶段，快速实施流程，适合需求相对明确的场景

---

## Task List 管理

本技能自动管理任务列表，提供进度可视化和断点恢复能力。

**基础模式**：
```markdown
# 开始阶段时
tasks = TaskList()
task = findTaskBySubject(tasks, "阶段 X: 阶段名称")
TaskUpdate(task.id, status="in_progress", owner="requirement-analysis")

# 完成阶段时
TaskUpdate(task.id, status="completed")
```

**条件执行阶段**：
对于条件执行的阶段（如外部资源研究）：
```markdown
# 如果跳过此阶段
TaskUpdate(task.id, status="completed", metadata={note: "不满足执行条件，已跳过"})
```

**断点恢复**：如果执行中断，检查 `TaskList()` 找到 `in_progress` 或 `pending` 状态的任务并继续。

**高级用法**：[Task List 管理](references/task-list-management.md)

---

## Ultrathink 使用指南

**工具**：`mcp__sequential-thinking__sequentialthinking`

**何时使用**：
- ✅ 阶段1：需求涉及多个模块、复杂业务逻辑、描述模糊
- ✅ 阶段5：必须使用（深度分析）
- ❌ 简单 CRUD 或单一模块需求可跳过

**使用方法**：
```markdown
思考内容：
- 阶段1：分解需求组件、识别依赖关系、分析潜在风险
- 阶段5：设计数据结构、API端点、服务层、识别边缘情况、规划实施步骤
```

---

## 工作流程

### 阶段 1: 需求理解

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

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

**任务管理**：
```markdown
task = findTaskBySubject(tasks, "阶段 1: 需求理解")
TaskUpdate(task.id, status="in_progress", owner="requirement-analysis")
# 完成时
TaskUpdate(task.id, status="completed")
```

---

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

**目标**：全面探索代码库，理解项目架构

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

**探索模式**：

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

**并行模式**（复杂需求）：
- 同时启动 2-5 个 Explore agent
- 按架构层次或功能模块分解
- ⚠️ **必须在单个消息中发起所有 Task 调用**
- 每个任务设置 `run_in_background: true`
- 使用 TaskOutput 收集结果

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

**并行模式示例**：[并行模式指南](references/parallel-patterns.md)

---

### 阶段 3: 外部资源研究 (条件执行)

**目标**：研究外部资源，获取最新信息和最佳实践

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

**工具优先级**：
1. 网页搜索：exa MCP