| name | new-feature |
| description | 端到端新功能开发流水线。当用户想要从需求到完整实现一站式完成新功能开发时使用。调用时需附带功能需求描述。自动串联:需求澄清 → 代码实现 → UT(委托 ut-writer SKILL)→ Lint(委托 lint-check-fix Agent)→ 构建测试验证。 |
| argument-hint | [功能需求描述] |
端到端新功能开发流水线
从一句需求描述出发,自动完成:需求澄清 → 代码实现 → 单元测试补充 → Lint 检查修复 → 构建/测试验证 → 提交代码。
流程总览
用户输入需求描述
|
v
[阶段 1] 需求澄清
|
v
记录明确的需求描述
|
v
[阶段 2] 代码实现
|
v
[阶段 3] 补充单元测试(委托 ut-writer SKILL)
|
v
[阶段 4] Lint 检查修复(委托 lint-check-fix Agent)
|
v
[阶段 5] 构建 & 测试验证(build / lint / test:coverage,并行)
| ← 失败则修复代码并重新验证
v
[阶段 6] 提交代码
|
v
完成 ✓
步骤
阶段 1:需求澄清
-
获取需求输入
- 如果用户直接提供了需求描述,直接使用
- 如果未提供任何信息,使用 AskUserQuestion tool 询问:
"请描述您想要开发的新功能。"
-
阅读项目上下文
阅读 CODEBUDDY.md 获取项目架构和开发规范。
-
需求分析与澄清
使用 Agent tool(subagent_type=Explore)深入理解需求:
- 探索现有代码结构
- 确认需求涉及的模块和文件
- 评估技术可行性和影响范围
-
确认需求方案
使用 AskUserQuestion tool 向用户确认:
- 功能概述
- 涉及的模块和文件
- 实现方案(如有多种方案,列出各方案的优缺点)
- 可能的影响范围
等待用户确认后再继续。
阶段 2:代码实现
-
创建任务列表
使用 TaskCreate tool 根据确认的需求创建详细的任务列表,将实现工作拆分为可跟踪的小任务。
-
实现代码
按照任务列表逐一实现:
- 使用 Read tool 阅读需要修改的文件
- 使用 Edit tool 进行精确修改
- 遵循项目编码规范(CODEBUDDY.md)
- 每完成一个任务,使用 TaskUpdate tool 标记为完成
注意:
- 保持实现范围最小化,仅实现需求本身
- 确保修改不引入新的问题
阶段 3:补充单元测试
-
委托 ut-writer SKILL 补充单元测试
使用 Skill tool 调用 ut-writer SKILL:
Skill tool, skill: "ut-writer"
ut-writer 会自动:
- 评估当前覆盖率基线
- 分析覆盖率缺口
- 为新功能涉及的模块补充或增强测试
- 循环「写测试 → 跑测试 → 修复失败」直到覆盖率达 60% 且全部通过
等待 ut-writer 完成后再继续。
阶段 4:Lint 检查修复
-
委托 lint-check-fix Agent 检查并修复 lint 错误
使用 Agent tool(subagent_type="lint-check-fix")进行 lint 检查与修复:
Agent tool, subagent_type: "lint-check-fix"
prompt: "请对项目进行 lint 检查并自动修复所有可修复的问题。"
lint-check-fix 会自动:
- 执行 lint 检查
- 分类问题(可自动修复 / 需手动修复 / 需用户确认)
- 自动修复可修复的问题
- 输出修复报告
等待 lint-check-fix 完成后再继续。
阶段 5:构建 & 测试验证
-
并行运行 build、lint、测试
以下验证任务相互独立,必须并行执行(使用多个 Bash tool 并行调用):
pnpm build
pnpm lint
pnpm test:coverage
收集全部结果后统一分析。如果任何一项失败,分析错误并修复代码/测试。
-
验证循环
如果步骤 9 中任何一项失败:
- 分析错误日志
- 修复代码或测试
- 重新并行运行全部验证(build / lint / test:coverage)
- 最多重试 3 轮。如果 3 轮后仍有失败,暂停并报告问题,等待用户指导。
阶段 6:提交代码
-
提交代码
仅在阶段 5 的所有验证步骤全部通过后才执行此步骤。
完成时的输出
## 新功能开发完成
**功能:** <功能名称>
**实现方案:** <方案简述>
### 修改的文件
- <文件列表及修改说明>
### 验证结果
- ✓ 构建通过(pnpm build)
- ✓ Lint 通过(pnpm lint)
- ✓ 测试通过(pnpm test:coverage)
### Git 信息
- commit: <commit hash>
- message: <commit message>
功能开发全流程已完成!
护栏
- 严格按阶段顺序执行:每个阶段必须完成后才能进入下一阶段
- 需求必须先澄清:不得跳过需求澄清阶段直接进入实现
- 实现范围最小化:仅实现需求本身,不做无关的功能增强
- UT 必须委托 ut-writer:单元测试统一通过 ut-writer SKILL 补充
- Lint 必须委托 lint-check-fix:Lint 检查与修复统一通过 lint-check-fix Agent 处理
- 验证必须全部通过:build、lint、test:coverage 全部通过后才能提交代码
- 失败时修复而非跳过:验证失败时必须修复代码并重新验证
- 重试有上限:验证循环最多 3 轮,超过后暂停等待用户指导
- 使用 Task tool 跟踪进度:创建任务跟踪每个阶段的进度
- 遵循项目编码规范:遵循 CODEBUDDY.md 中的约定