# Requirement Analysis

> 提供系统化的需求分析工作流，用于理解需求、探索代码库、澄清问题、使用深度分析并在编码前展示实施计划。适用于功能开发、API设计、数据库设计、模块开发和功能修改等场景。当用户提出功能开发、API设计、数据库设计等需求时自动触发此技能。根据用户设置和输入语言进行交互。

- Skill: `majiayu000/requirement-analysis` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/requirement-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/requirement-analysis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/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. **风险和注意事项**

**重要**：在用户确认前，不要开始实施。

询问："这个实施计划看起来如何？我可以开始实施了吗？"

**输出格式**：参见 [assets/output-template.md](assets/output-template.md)

---

### 阶段 6: 实施开发

**前提**：必须获得用户明确确认

**执行原则**：
1. 严格遵循 CLAUDE.md
2. 逐步实施，使用 TodoWrite 跟踪
3. 质量优先，及时验证
4. 保持简洁，避免过度工程
5. 遇到问题及时使用 AskUserQuestion

---

### 阶段 7: 代码审查

**单一审查模式**（简单需求）：
- 使用单个 code-reviewer agent
- 全面审查所有维度

**并行深度审查模式**（复杂需求）：⚡
- 同时启动 5 个审查任务
- 每个聚焦于特定维度（功能正确性、代码风格、简洁性、规范遵循、约定和抽象）
- **详细指南**：[references/parallel-patterns.md](references/parallel-patterns.md)

**审查后必须**：
- 使用 **AskUserQuestion** 询问用户如何处理问题
- 不得自动修复，必须征求确认

**输出格式**：参见 [assets/output-template.md](assets/output-template.md)

---

## 重要原则

1. **自适应语言交互**：根据用户在 Claude 中的 response language 设置和输入消息的语言与用户沟通（技术术语和代码除外）
2. **严格遵循 CLAUDE.md**：必须阅读并遵守项目规范
3. **主动提问**：不清楚的地方必须澄清，不要假设
4. **合理使用 ultrathink**：
   - 阶段 1：根据复杂度决定
   - 阶段 4：必须使用
5. **善用外部资源**：需要时使用 context7、exa（带降级方案）
6. **合理使用并行化**：
   - 阶段 2：复杂需求使用并行探索
   - 阶段 7：大型改动使用并行审查
   - 必须在单个 message 中发起所有并行任务
7. **必须代码审查**：实施完成后必须执行阶段 7
8. **审查前征求确认**：使用 AskUserQuestion，不得自动修复
9. **切勿急躁**：计划确认前不要编码
10. **保持彻底**：考虑边缘情况、错误和性能

---

## 参考文档

### 详细指南
- [并行模式指南](references/parallel-patterns.md) - 并行探索和审查的详细策略
- [使用示例](references/examples.md) - 3 个完整的使用场景示例
- [输出格式模板](assets/output-template.md) - 标准化的输出格式


---