⚡

功能开发工作流程 feature-dev

这是一个自动化工作流程技能，用于功能开发，通过7个阶段和 specialized agents（代码探索者、代码架构师、代码审查者）来探索代码库、设计架构和进行质量审查。关键词：功能开发、代码探索、架构设计、代码审查、工作流程自动化、代理。

架构设计 0 次安装 0 次浏览 更新于 3/7/2026

名称: 功能开发 描述: 通过 specialized agents（代码探索者、代码架构师、代码审查者）自动化7阶段功能开发。用于多文件功能、架构决策或遇到模糊需求、集成模式、设计方法错误。

关键词: 功能开发, 代码探索, 架构设计, 代码审查, 工作流程自动化, 斜杠命令, 代理, 发现阶段, 实施规划, 质量审查 许可证: MIT 允许工具: [“读取”, “写入”, “编辑”, “Bash”, “任务”] 元数据: 版本: 1.0.0 作者: Sid Bidasaria 代理: - 代码探索者 - 代码架构师 - 代码审查者

功能开发工作流程

一个全面的、结构化的功能开发工作流程，具有 specialized agents 用于代码库探索、架构设计和质量审查。

快速开始

启动引导式功能开发工作流程：

/功能-开发 添加用户认证与 OAuth

或交互式：

/功能-开发

工作流程将自动引导您通过7个不同的阶段。

概述

构建功能不仅仅是写代码。此技能提供了一种系统化方法，它：

  • 理解代码库，然后再进行更改
  • 提出澄清问题，以解决模糊性
  • 精心设计，提供多种架构选项
  • 实施后进行质量审查

7阶段工作流程

阶段 1: 发现

目标: 理解需要构建什么

  • 澄清不明确的功能请求
  • 识别问题、约束和需求
  • 总结理解并与用户确认

示例:

用户: /功能-开发 添加缓存
代理: 让我理解您需要什么...
       - 应该缓存什么？（API 响应、计算值等）
       - 您的性能要求是什么？
       - 您有偏好的缓存解决方案吗？

阶段 2: 代码库探索

目标: 理解相关的现有代码和模式

  • 并行启动2-3个代码探索者代理
  • 探索类似功能、架构、UI 模式
  • 读取所有识别出的文件以进行深入理解
  • 呈现全面的发现总结

启动的代理:

  • “查找与[功能]类似的功能并追踪实施”
  • “映射[领域]的架构和抽象”
  • “分析[相关功能]的当前实施”

示例输出:

找到类似功能：
- 用户认证（src/auth/）：使用 JWT 令牌、中间件模式
- 会话管理（src/session/）：基于 Redis、24小时过期

关键文件：
- src/auth/AuthService.ts:45 - 核心认证逻辑
- src/middleware/authMiddleware.ts:12 - 请求认证

阶段 3: 澄清问题

目标: 填补空白并解决所有模糊性

  • 审查代码库发现和功能请求
  • 识别未明确指定的方面（边缘情况、错误处理、集成点）
  • 呈现有组织的问题列表
  • 在继续之前等待答案

示例:

在设计之前，我需要澄清：

1. OAuth 提供商：哪些提供商？（Google、GitHub、自定义？）
2. 用户数据：存储 OAuth 令牌还是仅个人资料？
3. 现有认证：替换还是与当前认证一起添加？
4. 会话：与现有会话管理集成吗？
5. 错误处理：如何处理 OAuth 失败？

关键: 确保在设计开始前没有任何模糊。

阶段 4: 架构设计

目标: 设计多种实施方法

  • 启动2-3个代码架构师代理，具有不同重点：
    • 最小更改: 最小变更，最大重用
    • 清洁架构: 可维护性、优雅抽象
    • 实用平衡: 速度 + 质量
  • 呈现比较，包括权衡和建议
  • 询问使用哪种方法

示例输出:

方法 1: 最小更改
- 使用 OAuth 方法扩展现有 AuthService
优点: 快速、低风险
缺点: 将 OAuth 与现有认证耦合

方法 2: 清洁架构
- 具有专用接口的新 OAuthService
优点: 清洁分离、可测试
缺点: 更多文件、更多重构

方法 3: 实用平衡
- 新的 OAuthProvider 抽象
优点: 平衡复杂性和清洁度
缺点: 一些耦合仍存在

建议: 方法 3 - 清洁边界而不过度重构

阶段 5: 实施

目标: 构建功能

  • 等待明确批准再开始
  • 从先前阶段读取所有相关文件
  • 遵循所选架构实施
  • 严格遵循代码库约定
  • 更新待办事项以跟踪进度

阶段 6: 质量审查

目标: 确保代码简单、DRY、优雅且功能正确

  • 并行启动3个代码审查者代理：
    • 简单性/DRY/优雅: 代码质量
    • 错误/正确性: 功能正确性
    • 约定/抽象: 项目标准
  • 整合发现并识别高严重性问题
  • 询问做什么: 现在修复、以后修复或按原样进行

示例输出:

高优先级问题:
1. OAuth 回调中缺少错误处理（src/auth/oauth.ts:67）
2. 内存泄漏：OAuth 状态未清理（src/auth/oauth.ts:89）

中等优先级:
1. 可以简化令牌刷新逻辑（src/auth/oauth.ts:120）

您想做什么？

阶段 7: 总结

目标: 记录完成的内容

  • 标记所有待办事项完成
  • 总结构建了什么、关键决策、修改的文件
  • 建议下一步

Specialized Agents

代码探索者

目的: 通过追踪执行路径深入分析现有代码库功能

重点:

  • 入口点和调用链
  • 数据流和转换
  • 架构层和模式
  • 实施细节

输出:

  • 带文件:行引用的入口点
  • 逐步执行流程
  • 关键组件和职责
  • 需要读取的基本文件

触发: 自动在阶段 2，或手动

代码架构师

目的: 设计功能架构和实施蓝图

重点:

  • 代码库模式分析
  • 架构决策
  • 组件设计
  • 实施路线图

输出:

  • 找到的模式和约定
  • 带理由的架构决策
  • 完整组件设计
  • 带构建顺序的实施地图

触发: 自动在阶段 4，或手动

代码审查者

目的: 审查代码以发现错误、质量问题和不符项目约定

重点:

  • 项目指南合规性（CLAUDE.md）
  • 错误检测
  • 代码质量问题
  • 基于置信度的过滤（仅≥80% 置信度）

输出:

  • 关键问题（置信度 75-100）
  • 重要问题（置信度 50-74）
  • 带文件:行引用的具体修复

触发: 自动在阶段 6，或手动

使用模式

完整工作流程（推荐用于新功能）

/功能-开发 添加 API 端点的速率限制

手动代理调用

探索功能:

"启动代码探索者以追踪认证如何工作"

设计架构:

"启动代码架构师以设计缓存层"

审查代码:

"启动代码审查者以检查我的最近更改"

何时使用

用于:

  • 涉及多个文件的新功能
  • 需要架构决策的功能
  • 与现有代码的复杂集成
  • 需求有些模糊的功能

不用于:

  • 单行错误修复
  • 琐碎更改
  • 定义明确的简单任务
  • 紧急热修复

最佳实践

  1. 对复杂功能使用完整工作流程: 7个阶段确保彻底规划
  2. 深思熟虑地回答澄清问题: 阶段 3防止未来混淆
  3. 有意识地选择架构: 阶段 4提供选项是有原因的
  4. 不要跳过代码审查: 阶段 6在生产前发现问题
  5. 阅读建议的文件: 阶段 2识别关键文件—阅读它们以获取上下文

常见问题

代理耗时太长

原因: 对于大型代码库是正常的 解决方案: 代理尽可能并行运行。彻底性通过更好的理解得到回报。

太多澄清问题

原因: 功能请求太模糊 解决方案: 在初始请求中更具体。提前提供约束上下文。

架构选项令人不知所措

原因: 呈现了多种有效方法 解决方案: 信任建议（基于代码库分析）。当有疑问时选择实用选项。

要求

  • 安装 Claude Code
  • Git 仓库（用于代码审查）
  • 现有代码库（工作流程从现有模式学习）

提示

  • 在功能请求中具体: 更多细节 = 更少澄清问题
  • 信任流程: 每个阶段都建立在先前阶段之上
  • 审查代理输出: 代理提供有价值的代码库见解
  • 不要跳过阶段: 每个阶段都有目的
  • 用于学习: 探索阶段教您了解自己的代码库

验证清单

使用工作流程后：

  • [ ] 所有7个阶段成功完成
  • [ ] 阶段 3中回答了澄清问题
  • [ ] 阶段 4中选择了架构方法
  • [ ] 阶段 5开始前批准了实施
  • [ ] 阶段 6中解决了代码审查发现
  • [ ] 阶段 7中生成了带下一步的总结
  • [ ] 功能按预期工作
  • [ ] 代码遵循项目约定

参考

有关详细工作流程文档，请参见 README.md

有关代理规格，请参见：

  • agents/code-explorer.md
  • agents/code-architect.md
  • agents/code-reviewer.md

有关斜杠命令实施，请参见 commands/feature-dev.md