需求分析技能 (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
查找内容：
- CLAUDE.md 规范
- 相关实体和服务
- 现有模式和约定
阶段 2.5: 外部资源研究
执行条件（满足任一即执行）：
- ✅ 涉及新的第三方库或框架
- ✅ 需要了解行业最新实践
- ✅ 内部代码库示例不充分
工具使用：
- 网页搜索：优先 exa MCP，降级到 WebSearch
- 库文档：优先 context7 MCP，降级到 WebSearch + Grep + Read
何时跳过：
- ⏭️ 完全基于已有代码
- ⏭️ 团队对技术已经熟悉
- ⏭️ 时间紧急且需求简单
阶段 3: 澄清问题
重要：对任何不清楚、模糊、有歧义的地方，必须使用 AskUserQuestion 工具。
澄清内容：
- 模糊或规格不足的需求
- 多个有效实施方法之间的选择
- 业务规则细节
- 技术选型或架构决策
阶段 4: 深度分析
必须使用 ultrathink：使用 mcp__sequential-thinking__sequentialthinking 工具
⚠️ 上下文注意事项： 虽然 ultrathink 能够访问完整的对话历史，但在进行深度分析时，建议明确引用和总结之前阶段的关键发现，确保分析的连贯性和准确性。
分析内容：
-
分析需求组件
- 回顾阶段 1 的需求理解结果
- 分解为可实施的功能模块
-
设计数据结构（符合 CLAUDE.md 规范）
- 基于阶段 2 的代码库探索发现
- 遵循项目的数据库设计规范和模式
-
设计 API 端点（符合 CLAUDE.md 规范）
- 参考项目现有的 API 设计模式
- 遵循项目的路由命名和结构约定
-
设计服务层（符合 CLAUDE.md 规范）
- 遵循项目的架构模式和分层约定
- 复用项目中已有的设计模式和抽象
-
识别风险和边缘情况
- 考虑阶段 3 中用户澄清的特殊情况
- 分析潜在的技术和业务风险
-
规划详细实施步骤
- 整合所有上述分析
- 制定可执行的分步实施计划
阶段 5: 展示实施计划
向用户展示：
- 需求总结 - 理解的核心要点
- 代码库发现 - 相关代码和模式
- 外部资源（如适用）- 搜索结果和库文档
- 技术设计 - 数据库、API、服务层
- 实施步骤 - 编号的详细步骤
- 风险和注意事项
重要：在用户确认前，不要开始实施。
询问："这个实施计划看起来如何？我可以开始实施了吗？"
输出格式：参见 assets/output-template.md
阶段 6: 实施开发
前提：必须获得用户明确确认
执行原则：
- 严格遵循 CLAUDE.md
- 逐步实施，使用 TodoWrite 跟踪
- 质量优先，及时验证
- 保持简洁，避免过度工程
- 遇到问题及时使用 AskUserQuestion
阶段 7: 代码审查
单一审查模式（简单需求）：
- 使用单个 code-reviewer agent
- 全面审查所有维度
并行深度审查模式（复杂需求）：⚡
- 同时启动 5 个审查任务
- 每个聚焦于特定维度（功能正确性、代码风格、简洁性、规范遵循、约定和抽象）
- 详细指南：references/parallel-patterns.md
审查后必须：
- 使用 AskUserQuestion 询问用户如何处理问题
- 不得自动修复，必须征求确认
输出格式：参见 assets/output-template.md
重要原则
- 自适应语言交互：根据用户在 Claude 中的 response language 设置和输入消息的语言与用户沟通（技术术语和代码除外）
- 严格遵循 CLAUDE.md：必须阅读并遵守项目规范
- 主动提问：不清楚的地方必须澄清，不要假设
- 合理使用 ultrathink：
- 阶段 1：根据复杂度决定
- 阶段 4：必须使用
- 善用外部资源：需要时使用 context7、exa（带降级方案）
- 合理使用并行化：
- 阶段 2：复杂需求使用并行探索
- 阶段 7：大型改动使用并行审查
- 必须在单个 message 中发起所有并行任务
- 必须代码审查：实施完成后必须执行阶段 7
- 审查前征求确认：使用 AskUserQuestion，不得自动修复
- 切勿急躁：计划确认前不要编码
- 保持彻底：考虑边缘情况、错误和性能