完整的 7 阶段功能开发工作流（需求理解、代码探索、架构设计、实施、审查、总结）。适用场景：(1) 新功能实施或模块开发，(2) 复杂代码修改和重构，(3) API/数据库/服务架构设计，(4) 多模块功能开发，(5) 需要代码审查的实施任务。融合 ultrathink 深度分析、MCP 工具增强（context7、exa、sequential-thinking）和并行 agent 执行（code-explorer、code-architect、code-reviewer）。支持全程中文交互。
This skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/output-template.mdreferences/mcp-tools.mdreferences/phase-1-discovery.mdreferences/phase-2-exploration.mdreferences/phase-3-clarify.mdreferences/phase-4-design.mdreferences/phase-5-implement.mdreferences/phase-6-review.mdreferences/phase-7-summary.mdreferences/quick-reference.mdreferences/troubleshooting.md提供系统化的 7 阶段功能开发工作流，确保从需求理解到质量交付的完整过程。
工作流概览：
需求理解 → 代码探索 → 澄清问题 → 架构设计 → 实施 → 质量审查 → 总结
核心特性：
手动触发：
/feat-dev [功能描述]
详细指南：
本 skill 优先使用 MCP 工具，但所有功能在无 MCP 环境下完全可用。
| MCP 工具 | 用途 | 降级方案 | 使用阶段 |
|---|---|---|---|
| context7 | 获取最新库文档和 API 参考 | WebSearch + Grep + Read | 2、4、5 |
| exa | 高质量网页搜索和代码示例 | WebSearch | 1、4、6 |
| sequential-thinking | 深度结构化思考（ultrathink） | EnterPlanMode + 思维链分析 | 1、4 |
尝试 MCP 工具 → 失败 → 立即切换降级方案 → 继续工作流（不中断）
重要：不要因为 MCP 工具不可用而中断工作流。
三个外部 agents（位于 agents/ 目录）：
| Agent | 用途 | 使用阶段 | 并行数量 |
|---|---|---|---|
| code-explorer | 深度分析代码库，追踪执行路径 | 2 | 2-3 个 |
| code-architect | 设计架构蓝图，制定实施方案 | 4 | 1 个 |
| code-reviewer | 代码审查，识别 bug 和规范问题 | 6 | 3 个 |
基本原则：
model 参数（如 model: "haiku"），否则会从父进程继承（使用 sonnet）run_in_background: true并行调用（阶段 2 和 6）：
⚠️ 关键要求：必须在单个消息中发起所有 Task 调用
示例（启动 3 个并行 agents）：
1. 在一个消息中发起 3 个 Task 工具调用
2. 每个 Task 设置 run_in_background: true
3. 继续其他工作（如阅读文件）
4. 使用 TaskOutput 收集每个 agent 的结果
单个调用（阶段 4）：
启动 1 个 agent，阻塞等待结果：
- run_in_background: false（或省略此参数）
- 等待 agent 完成后继续
详见各阶段的参考文档。
目标：全面理解用户需求
执行要点：
产出：需求理解摘要（核心功能、业务实体、API 端点、业务规则、集成点、不确定点）
详细指南：references/phase-1-discovery.md
目标：深入理解现有代码库
执行要点：
首要任务：查找并阅读项目根目录的 CLAUDE.md 文件
并行启动 2-3 个 code-explorer agents：
⚠️ 并行执行要求（关键）：
run_in_background: trueAgent 分工：
并行调用示例：
在单个消息中发起所有 Task 调用：
Task 1: 探索数据层
- description: "探索数据层架构"
- prompt: "分析数据层：实体、数据库模式、数据关联。返回5-10个关键文件路径。"
- subagent_type: "feat-dev:code-explorer"
- model: "haiku"
- run_in_background: true
Task 2: 探索业务逻辑层
- description: "探索业务逻辑层架构"
- prompt: "分析业务逻辑层：服务、Repository、业务流程。返回5-10个关键文件路径。"
- subagent_type: "feat-dev:code-explorer"
- model: "haiku"
- run_in_background: true
Task 3: 探索API层
- description: "探索API层架构"
- prompt: "分析API层：控制器、路由、请求处理。返回5-10个关键文件路径。"
- subagent_type: "feat-dev:code-explorer"
- model: "haiku"
- run_in_background: true
等待所有 agents 完成后，使用 TaskOutput 收集结果。
读取所有 agent 识别的文件 - 主进程必须亲自阅读这些文件建立深度理解
整合发现：
可选：使用 context7 查询依赖库文档
产出：代码库探索报告（CLAUDE.md 规范、项目架构、相关组件、设计模式、技术栈、必读文件）
详细指南：references/phase-2-exploration.md
目标：填补需求空白，解决模糊和歧义
执行要点：
产出：澄清结果（用户反馈）或"无需澄清"
详细指南：references/phase-3-clarify.md
目标：设计详细的实施方案
执行要点：
使用 ultrathink（sequential-thinking）进行深度架构分析：
必须启动 code-architect agent 获取专业架构建议：
调用方式：
使用 Task 工具调用 code-architect：
- description: "获取架构设计建议"
- prompt: "基于以下需求和 ultrathink 分析结果，设计架构方案：[需求摘要]。返回5-10个关键架构参考文件和具体的架构设计建议。"
- subagent_type: "feat-dev:code-architect"
- model: "sonnet"
- run_in_background: false # 单个 agent，阻塞等待结果
设计方案（基于 ultrathink + architect 的综合分析）：
向用户展示：
询问用户选择：等待用户确认使用哪个方案
产出（所有都是必须的）：
详细指南：references/phase-4-design.md
目标：按照架构设计实施功能
前置条件：用户已确认架构方案
执行要点：
实施原则：
产出：完整的功能实现代码
详细指南：references/phase-5-implement.md
目标：确保代码质量
执行要点：
并行启动 3 个 code-reviewer agents：
⚠️ 并行执行要求（关键）：
run_in_background: trueReviewer 分工：
并行调用示例：
在单个消息中发起所有 Task 调用：
Task 1: Bug 和逻辑错误审查
- description: "审查Bug和逻辑错误"
- prompt: "审查代码中的Bug、逻辑错误、空值处理等问题。返回问题列表，每个问题标注严重性（高/中/低）和置信度（0-100）。"
- subagent_type: "feat-dev:code-reviewer"
- model: "haiku"
- run_in_background: true
Task 2: 代码风格和质量审查
- description: "审查代码风格和质量"
- prompt: "审查代码重复、函数复杂度、命名清晰度等质量问题。返回问题列表，每个问题标注严重性和置信度。"
- subagent_type: "feat-dev:code-reviewer"
- model: "haiku"
- run_in_background: true
Task 3: 项目规范遵循审查
- description: "审查项目规范遵循"
- prompt: "审查是否遵循项目规范（CLAUDE.md等）、架构模式、命名约定等。返回问题列表，每个问题标注严重性和置信度。"
- subagent_type: "feat-dev:code-reviewer"
- model: "haiku"
- run_in_background: true
等待所有 reviewers 完成后，使用 TaskOutput 收集结果。
整合审查结果：
向用户展示发现并询问决策：
根据用户决策执行：
完成安全检查清单
修复策略（基于用户决策）：
产出：审查报告、修复记录、质量评分
详细指南：references/phase-6-review.md
目标：全面总结实施成果
输出内容：
产出：完整总结文档
详细指南：references/phase-7-summary.md
⚠️ CRITICAL - 工作流执行规则：
⚠️ 每个阶段开始时 MUST 输出（强制）：
---
## 🚀 当前阶段：[X] - [阶段名称]
⚠️ WORKFLOW CHECKPOINT: 当前处于阶段 [X]，必须完成本阶段所有任务后才能进入阶段 [X+1]
---
⚠️ 每个阶段结束时 MUST 输出（强制）：
---
✅ 阶段 [X] 完成
📋 本阶段产出：
- [列出主要产出]
📍 下一阶段：[X+1] - [阶段名称]
⚠️ WORKFLOW CHECKPOINT: 准备进入阶段 [X+1]
---
⚠️ CRITICAL - 收到用户输入后的处理规则：
当用户在阶段中提供输入（如回答澄清问题、确认架构方案）后，MUST 执行以下步骤：
---
📥 已收到用户输入
⚠️ WORKFLOW CHECKPOINT: 继续阶段 [X] - [阶段名称]
（禁止跳出当前 skill，禁止跳过任何阶段）
---
MUST 处理用户输入：整合到当前阶段的分析中
MUST 继续当前阶段：完成阶段剩余工作
MUST 完成阶段后才能进入下一阶段：输出阶段完成标记
CRITICAL - 绝对禁止：
以下检查点是强制性的，必须停止并等待用户输入：
阶段 1 → 2：
阶段 3 → 4（如有澄清问题）：
阶段 4 → 5（CRITICAL CHECKPOINT）：
阶段 5 → 6：
⚠️ CRITICAL - 严格的阶段执行顺序：
必须按此顺序执行：1 → 2 → 3 → 4 → 5 → 6 → 7
每个阶段的执行要求：
允许回退（向前回退）：
❌❌❌ ABSOLUTELY PROHIBITED（绝对禁止的跳跃）：
⚠️ 违反阶段顺序的常见错误模式：
错误模式 1: 阶段 1 → 直接开始代码探索并实施
正确做法: 阶段 1 → 阶段 2 → 阶段 3 → 阶段 4 → [等待确认] → 阶段 5
错误模式 2: 阶段 1 → 用户回复 → 直接实施
正确做法: 阶段 1 → 阶段 2 → 阶段 3 → 阶段 4 → [等待确认] → 阶段 5
错误模式 3: 阶段 4 设计完成 → 直接实施
正确做法: 阶段 4 设计完成 → 请求用户确认 → [停止等待] → 收到确认 → 阶段 5
错误模式 4: 收到用户输入 → 跳出 skill
正确做法: 收到用户输入 → 确认收到 → 继续当前阶段 → 完成后进入下一阶段
使用标准化模板输出各阶段结果。详见：assets/output-template.md
重要：所有输出必须包含阶段标记（见"工作流控制"章节）
本 skill 设计为语言无关，适用于但不限于：
后端：Node.js、Python、Go、Java、Ruby、PHP、C#、Rust 等 前端：React、Vue、Angular、Svelte、纯 JavaScript/TypeScript 等 全栈：Next.js、Nuxt、SvelteKit 等 移动端：React Native、Flutter、Swift、Kotlin 等 数据库：关系型（PostgreSQL、MySQL、SQL Server）、NoSQL（MongoDB、Redis）等
具体实施时，会根据项目的技术栈和 CLAUDE.md 规范调整。