feature-dev

功能开发工作流

一套全面、结构化的功能开发工作流，配备专门用于代码库探索、架构设计和质量审查的 Agent。

快速开始

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

/feature-dev Add user authentication with OAuth

或进行交互：

/feature-dev

工作流将自动引导你完成 7 个不同阶段。

概览

开发功能不仅仅是编写代码。此技能提供了一种系统化方法，以便：

• 在做出更改之前了解代码库
• 提出澄清问题，消除歧义
• 周密地设计，提供多种架构方案
• 在实现后进行质量审查

7 阶段工作流

阶段 1：探索

目标：了解需要构建什么

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

示例：

User: /feature-dev Add caching
Agent: Let me understand what you need...
       - What should be cached? (API responses, computed values, etc.)
       - What are your performance requirements?
       - Do you have a preferred caching solution?

阶段 2：代码库探索

目标：了解相关的现有代码和模式

• 并行启动 2-3 个 code-explorer Agent
• 探索类似功能、架构和 UI 模式
• 阅读所有已识别的文件，以深入了解
• 提供全面的发现总结

启动的 Agent：

• “查找与 [feature] 类似的功能并追踪其实现”
• “梳理 [area] 的架构和抽象”
• “分析 [related feature] 的当前实现”

输出示例：

Found similar features:
- User authentication (src/auth/): Uses JWT tokens, middleware pattern
- Session management (src/session/): Redis-backed, 24hr expiry

Key files:
- src/auth/AuthService.ts:45 - Core authentication logic
- src/middleware/authMiddleware.ts:12 - Request authentication

阶段 3：澄清问题

目标：补齐信息并消除所有歧义

• 审阅代码库发现和功能需求
• 找出说明不足的方面（边缘情况、错误处理、集成点）
• 按条理列出问题
• 等待答复后再继续

示例：

Before designing, I need to clarify:

1. OAuth provider: Which providers? (Google, GitHub, custom?)
2. User data: Store OAuth tokens or just profile?
3. Existing auth: Replace or add alongside current auth?
4. Sessions: Integrate with existing session management?
5. Error handling: How to handle OAuth failures?

关键：确保设计开始前没有任何歧义。

阶段 4：架构设计

目标：设计多种实现方案

• 启动 2-3 个侧重点不同的 code-architect Agent：
  • 最小改动：改动最少，最大限度复用
  • 整洁架构：注重可维护性和优雅的抽象
  • 务实平衡：兼顾速度与质量
• 提供对比，说明权衡并给出建议
• 询问要采用哪种方案

输出示例：

Approach 1: Minimal Changes
- Extend existing AuthService with OAuth methods
Pros: Fast, low risk
Cons: Couples OAuth to existing auth

Approach 2: Clean Architecture
- New OAuthService with dedicated interface
Pros: Clean separation, testable
Cons: More files, more refactoring

Approach 3: Pragmatic Balance
- New OAuthProvider abstraction
Pros: Balanced complexity and cleanliness
Cons: Some coupling remains

Recommendation: Approach 3 - clean boundaries without excessive refactoring

阶段 5：实现

目标：构建功能

• 等待明确批准后再开始
• 阅读前几个阶段涉及的所有相关文件
• 按照选定的架构进行实现
• 严格遵循代码库规范
• 更新待办事项以跟踪进度

阶段 6：质量审查

目标：确保代码简洁、遵循 DRY 原则、优雅且功能正确

• 并行启动 3 个 code-reviewer Agent：
  • 简洁性/DRY/优雅性：代码质量
  • 错误/正确性：功能正确性
  • 规范/抽象：项目标准
• 汇总发现并找出严重程度较高的问题
• 询问如何处理：立即修复、稍后修复，或按现状继续

输出示例：

High Priority Issues:
1. Missing error handling in OAuth callback (src/auth/oauth.ts:67)
2. Memory leak: OAuth state not cleaned up (src/auth/oauth.ts:89)

Medium Priority:
1. Could simplify token refresh logic (src/auth/oauth.ts:120)

What would you like to do?

阶段 7：总结

目标：记录已完成的工作

• 将所有待办事项标记为已完成
• 总结构建内容、关键决策和已修改的文件
• 建议后续步骤

专用 Agent

code-explorer

用途：通过追踪执行路径，深入分析现有代码库中的功能

关注点：

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

输出：

• 带有 file:line 引用的入口点
• 分步骤的执行流程
• 关键组件及其职责
• 需要阅读的重要文件

触发方式：在阶段 2 自动触发，也可手动触发

code-architect

用途：设计功能架构和实现蓝图

关注点：

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

输出：

• 发现的模式和约定
• 附带理由的架构决策
• 完整的组件设计
• 包含构建顺序的实施图

触发方式：在第 4 阶段自动触发，也可手动触发

code-reviewer

用途：审查代码中的错误、质量问题和项目约定

关注点：

• 是否遵循项目指南（CLAUDE.md）
• 错误检测
• 代码质量问题
• 基于置信度进行筛选（仅保留置信度 ≥80% 的结果）

输出：

• 严重问题（置信度 75-100）
• 重要问题（置信度 50-74）
• 附带文件:行号引用的具体修复方案

触发方式：在第 6 阶段自动触发，也可手动触发

使用模式

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

/feature-dev Add rate limiting to API endpoints

手动调用 Agent

探索功能：

"Launch code-explorer to trace how authentication works"

设计架构：

"Launch code-architect to design the caching layer"

审查代码：

"Launch code-reviewer to check my recent changes"

适用场景

适用于：

• 涉及多个文件的新功能
• 需要进行架构决策的功能
• 与现有代码复杂集成的功能
• 需求不太明确的功能

不适用于：

• 单行错误修复
• 微小改动
• 定义明确的简单任务
• 紧急热修复

最佳实践

1. 复杂功能使用完整工作流：7 个阶段确保规划周全
2. 认真回答澄清问题：第 3 阶段可避免后续困惑
3. 慎重选择架构：第 4 阶段会提供多个选项，是有原因的
4. 不要跳过代码审查：第 6 阶段能在代码投入生产前发现问题
5. 阅读建议的文件：第 2 阶段会指出关键文件，请阅读这些文件以了解上下文

常见问题

Agent 耗时过长

原因：对于大型代码库来说，这是正常情况 解决方案：在可能的情况下，Agent 会并行运行。充分分析有助于更好地理解代码。

澄清问题太多

原因：功能请求过于模糊 解决方案：在初始请求中提供更具体的信息，并提前说明相关约束。

架构选项令人难以抉择

原因：提供了多种可行方案 解决方案：相信基于代码库分析得出的建议。拿不定主意时，选择务实的方案。

要求

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

提示

• 明确说明功能请求：细节越多，澄清问题越少
• 相信流程：每个阶段都基于前一阶段的结果
• 审阅 Agent 的输出：Agent 能提供有价值的代码库见解
• 不要跳过阶段：每个阶段都有其作用
• 用于学习：探索阶段能帮助你了解自己的代码库

验证清单

使用工作流后：

• 已成功完成全部 7 个阶段
• 已在第 3 阶段回答澄清问题
• 已在第 4 阶段选择架构方案
• 已在第 5 阶段开始前批准实施方案
• 已在第 6 阶段处理代码审查发现的问题
• 已在第 7 阶段生成包含后续步骤的摘要
• 功能运行符合预期
• 代码遵循项目约定

参考资料

有关工作流的详细文档，请参阅 README.md

有关 Agent 规范，请参阅：

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

有关斜杠命令的实现，请参阅 commands/feature-dev.md