requirement-analysis

【当用户提出功能开发、API设计、数据库设计等需求时自动启用】系统化需求分析工作流 - 理解需求、探索代码库、澄清问题、使用ultrathink深度分析并在编码前展示实施计划(全程使用中文)

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

This Claude skill provides a systematic 7-stage requirement analysis workflow designed to bridge the gap between initial user requests and high-quality code implementation. It automates the process of codebase exploration, requirement clarification, and deep technical analysis, ensuring that API designs, database schemas, and feature developments are architecturally sound and strictly follow project-specific standards (CLAUDE.md) before coding begins.

Use Cases

  • Complex Feature Development: Systematically decomposing vague business requirements into structured implementation plans with clear technical milestones.
  • API and Database Design: Designing robust data models and interface specifications that maintain consistency with existing architectural patterns and naming conventions.
  • Legacy Codebase Exploration: Utilizing parallel exploration agents to quickly understand dependencies and impact areas when modifying or extending large-scale existing systems.
  • Technical Risk Mitigation: Leveraging deep 'ultrathink' analysis to identify potential edge cases, performance bottlenecks, and architectural risks during the planning phase.
namerequirement-analysis
description提供系统化的需求分析工作流,用于理解需求、探索代码库、澄清问题、使用深度分析并在编码前展示实施计划。适用于功能开发、API设计、数据库设计、模块开发和功能修改等场景。当用户提出功能开发、API设计、数据库设计等需求时自动触发此技能。根据用户设置和输入语言进行交互。

需求分析技能 (Requirement Analysis Skill)

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


快速开始

7 阶段工作流概览:

需求理解 → 代码探索 → 澄清问题 → 深度分析 → 展示计划 → 实施 → 代码审查

核心特性:

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

触发方式:

  • 自动触发:用户提出功能开发、API设计等需求
  • 手动触发:/requirement-analysis、使用需求分析skill

工作流程概览

阶段 1: 需求理解

目标:全面理解用户需求

执行要点:

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

何时使用 ultrathink:

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

阶段 2: 代码库探索

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

基础模式(简单需求):

  • 使用单个 Explore agent
  • 快速定位相关代码

并行模式(复杂需求):⚡

查找内容:

  • 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


阶段 6: 实施开发

前提:必须获得用户明确确认

执行原则:

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

阶段 7: 代码审查

单一审查模式(简单需求):

  • 使用单个 code-reviewer agent
  • 全面审查所有维度

并行深度审查模式(复杂需求):⚡

  • 同时启动 5 个审查任务
  • 每个聚焦于特定维度(功能正确性、代码风格、简洁性、规范遵循、约定和抽象)
  • 详细指南:references/parallel-patterns.md

审查后必须:

  • 使用 AskUserQuestion 询问用户如何处理问题
  • 不得自动修复,必须征求确认

输出格式:参见 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. 保持彻底:考虑边缘情况、错误和性能

参考文档

详细指南