提供系统化的 9 阶段需求分析与实施工作流（需求理解、代码探索、外部资源研究、澄清问题、深度分析、展示计划、实施开发、代码审查、总结）。适用于复杂功能开发、多方案对比、新技术栈研究等需要深度规划和完整实施的场景。当用户提出复杂功能开发、API设计、数据库设计且需要深度分析和外部资源研究时触发。
提供系统化的 9 阶段需求分析与实施工作流，确保从深度分析到质量交付的完整过程。
工作流 (阶段 1-9)：
需求理解 → 代码探索 → 外部资源研究 → 澄清问题 → 深度分析 → 展示计划 → 实施开发 → 代码审查 → 总结
核心特性：
本 skill 同时兼容 Claude Code 和 Codex。遇到环境专有工具时，按以下规则映射：
AskUserQuestionTaskList / TaskUpdateupdate_plan，并在对话中输出阶段进度块Task / TaskOutputspawn_agent / send_input / wait_agent；纯工具并行可用 multi_tool_use.parallelAGENTS.md，找不到再查 CLAUDE.mdCLAUDE.md，找不到再查 AGENTS.mdexa → WebSearchweb.search_query / open本技能自动管理任务列表，提供进度可视化和断点恢复能力。
基础模式：
Claude Code:
- 开始阶段时使用 TaskList/TaskUpdate 标记 `in_progress`
- 完成阶段时使用 TaskUpdate 标记 `completed`
Codex:
- 开始阶段时调用 `update_plan`，将当前阶段标记为 `in_progress`
- 完成阶段时调用 `update_plan`，将当前阶段标记为 `completed`
条件执行阶段： 对于条件执行的阶段（如外部资源研究）：
Claude Code:
- TaskUpdate(task.id, status="completed", metadata={note: "不满足执行条件，已跳过"})
Codex:
- update_plan 中将该步骤标记为 `completed`
- 在 explanation 或进度消息中注明“已跳过”
断点恢复：
TaskList() 找到 in_progress 或 pending 状态的任务并继续update_plan 和阶段进度消息，从最后一个 in_progress 或未完成阶段继续高级用法：Task List 管理
工具：mcp__sequential-thinking__sequentialthinking
何时使用：
使用方法：
思考内容：
- 阶段1：分解需求组件、识别依赖关系、分析潜在风险
- 阶段5：设计数据结构、API端点、服务层、识别边缘情况、规划实施步骤
目标：全面理解用户需求
执行要点：
任务管理：
Claude Code:
- TaskUpdate(..., status="in_progress")
- 完成时 TaskUpdate(..., status="completed")
Codex:
- update_plan 将“阶段 1: 需求理解”标记为 `in_progress`
- 完成时标记为 `completed`
目标：全面探索代码库，理解项目架构
首要任务：查找并阅读项目规范文件，优先级如下：
AGENTS.md → CLAUDE.mdCLAUDE.md → AGENTS.md探索模式：
基础模式（简单需求）：
并行模式（复杂需求）：
Task + run_in_background: true + TaskOutputspawn_agent(fork_context=true, ...)，需要结果时使用 wait_agent查找内容：
AGENTS.md / CLAUDE.md / 其他项目规范稳定性要求：
并行模式示例：并行模式指南
目标：研究外部资源，获取最新信息和最佳实践
执行条件（满足任一即执行）：
工具优先级：
exa（如可用）→ 网页搜索工具context7 → 网页搜索 + rg + 文件阅读跳过场景：
跳过处理：
Claude Code:
- TaskUpdate(task.id, status="completed", metadata={note: "不满足执行条件，已跳过"})
Codex:
- update_plan 将当前阶段标记为 `completed`
- 在阶段说明中写明“已跳过”
目标：解决所有不清楚、模糊或有歧义的需求点
重要：必须向用户发起澄清或确认
工具映射：
AskUserQuestion澄清内容：
最佳实践：
任务管理：
Claude Code:
- TaskUpdate(..., status="in_progress")
- 用户回应后 TaskUpdate(..., status="completed")
Codex:
- update_plan 将“阶段 4: 澄清问题”标记为 `in_progress`
- 用户回应并处理后标记为 `completed`
目标：使用 深度思考 进行深度分析，设计完整的技术方案
必须使用 深度思考：mcp__sequential-thinking__sequentialthinking
上下文要求：
深度分析开始前，必须先整理阶段1-4的上下文包，并在思考中显式使用：
分析内容：
分析需求组件（结合阶段1-4结果）
设计数据结构（符合项目规范）
设计 API 端点（符合项目规范）
设计服务层（符合项目规范）
识别风险和边缘情况
规划详细实施步骤
注意事项： 虽然 深度思考 能够访问完整对话历史，但必须明确引用和总结之前阶段的关键发现，确保分析、取舍和实施步骤都能追溯到阶段1-4的输入。
目标：向用户展示完整的实施计划，等待确认
展示内容：
计划要求：
重要：在用户确认前，不要标记任务为 completed
询问："这个实施计划看起来如何？我可以开始实施了吗？"
AskUserQuestion用户确认后：
Claude Code:
- TaskUpdate(task.id, status="completed")
Codex:
- update_plan 将“阶段 6: 展示实施计划”标记为 `completed`
# 下一阶段自动解除阻塞，可以开始
输出格式：输出模板
目标：基于阶段6的架构设计，实施功能代码
前提：必须获得用户明确确认（阶段6完成）
执行原则：
AGENTS.md / CLAUDE.md / 项目规范阶段职责：
完成标志：
目标：独立的质量把关阶段，全面审查代码质量
阶段职责：
审查模式选择：
单一审查模式（简单需求）：
并行深度审查模式（复杂需求）：
Task + run_in_background: true + TaskOutputspawn_agent(fork_context=true, ...)，再用 wait_agent 收集结果执行步骤：
TaskOutput；Codex 用 wait_agent）审查后必须：
AskUserQuestion产出：审查报告（问题列表、严重性标注）、改进建议
目标：总结整个需求分析流程，提供后续建议
总结内容：
需求总结
成果清单
质量指标
后续建议
经验教训
最终进度显示：
### [完成] 所有阶段完成！
需求分析项目 - 100% 完成
📝 阶段完成情况：
[完成] 阶段 1: 需求理解
[完成] 阶段 2: 代码库探索
[完成] 阶段 3: 外部资源研究
[完成] 阶段 4: 澄清问题
[完成] 阶段 5: 深度分析
[完成] 阶段 6: 展示实施计划
[完成] 阶段 7: 实施开发
[完成] 阶段 8: 代码审查
[完成] 阶段 9: 总结
项目成功完成！
AGENTS.md / CLAUDE.md / 其他规范文件context7、网页搜索工具（带降级方案）