subagent-driven

Subagent-Driven Development Skill 介绍

概述

该技能通过为每个任务派发独立子代理来执行结构化计划，并在任务之间强制进行两阶段评审：先检查规格符合度，再检查代码质量。它用质量门槛保证进度系统化。

快速开始

准备计划 —— 将任务提取到 TodoWrite 跟踪器。

对每个任务：

派发实现者子代理
回答澄清问题
运行规格符合度评审
运行代码质量评审

最终评审 —— 进行全面代码评审。

完成 —— 使用 finishing-a-development-branch。

适用场景

执行包含大多独立任务的实现计划
需要停留在当前会话中
任务之间需要质量门槛
需要在多个步骤中保留上下文

不适用场景

任务耦合紧密
更偏好并行执行
简单、单文件改动

流程

计划 → [任务 1] → 实现 → 规格评审 → 质量评审 → ✓ ↓ ↓ 如需要则修复并重新评审 [任务 2] → 实现 → 规格评审 → 质量评审 → ✓ ... 最终评审 → 完成

详细流程

步骤 1：计划准备

提取所有任务及其完整上下文：

任务提取

从计划创建 TodoWrite 条目：

[ ] 任务 1：[带完整上下文的描述]
[ ] 任务 2：[带完整上下文的描述]
[ ] 任务 3：[带完整上下文的描述]

重要：向子代理提供提取后的文本，不要让子代理直接读取计划文件。

步骤 2：逐任务执行

对每个任务：

2a. 派发实现者

实现者子代理提示词：

实现以下任务：

[来自计划的完整任务文本]

要求：

遵循 TDD：先写测试，验证失败，再实现，验证通过
进行原子提交
在报告完成前自审
如需要可提出澄清问题

用摘要报告完成，包括：

变更的文件
新增/修改的测试
与计划的任何偏差

2b. 处理澄清

如果实现者提出问题：

在实现开始前回答
不要让实现者在假设下继续
为后续参考记录答案

2c. 规格符合度评审

规格评审者子代理提示词：

审查实现是否符合规格：

原始任务规格： [来自计划的任务文本]

所做变更： [来自实现者的摘要]

验证：

[ ] 规格中的所有要求均已实现
[ ] 没有遗漏要求
[ ] 没有添加额外功能（YAGNI）
[ ] 实现符合所描述的方法

报告：通过或不通过，并给出具体问题

如果不通过：修复问题，重新运行规格评审。

2d. 代码质量评审

仅在规格评审通过后：

质量评审者子代理提示词：

审查实现的代码质量：

变更的文件： [文件列表]

审查：

[ ] 代码清晰度和可读性
[ ] 错误处理
[ ] 测试覆盖率和质量
[ ] 性能考量
[ ] 安全影响
[ ] 是否遵循项目约定

报告：通过或不通过，并给出具体问题

如果不通过：修复问题，重新运行质量评审。

2e. 标记完成

两次评审都通过后：

在 TodoWrite 中将任务标记为完成
继续下一个任务

步骤 3：最终评审

所有任务完成后：

最终评审者子代理提示词：

对所有变更进行全面代码评审：

已完成任务： [所有任务列表]

修改的文件： [完整文件列表]

审查：

[ ] 整体架构一致性
[ ] 跨任务一致性
[ ] 集成正确性
[ ] 完整测试覆盖
[ ] 文档完整性

报告：通过或给出需要处理的具体问题

步骤 4：完成

使用 finishing-a-development-branch 技能：

决定：合并到主分支或创建 PR
处理清理
更新跟踪

关键规则

绝不：

跳过评审（规格符合度或代码质量）
在规格符合度通过前开始代码质量评审
并行派发多个实现子代理
让子代理直接读取计划文件
接受存在未解决问题标记的评审
在当前任务通过两项评审前继续下一个任务

始终：

向子代理提供提取后的文本
在实现前回答澄清
在重新评审前修复问题
记录与计划的偏差
按顺序运行两个评审阶段

评审顺序理由

规格符合度（它做了正确的事吗？） ↓
代码质量（它做得好吗？）

规格在前，因为：

打磨错误代码没有意义
需求驱动设计决策
质量评审假设功能正确

最佳实践

做：

提取完整任务上下文
在实现者提示词中包含预期结果
评审标准要具体
发现问题立即修复
保持 TodoWrite 更新
记录任何计划偏差

不做：

仓促完成评审
评审前批量处理多个任务
修复后跳过重新评审
让实现者猜测需求
接受“基本通过”的评审
带着未解决问题继续

错误处理

情况 / 动作：

实现者提问 → 完整回答，然后继续
规格评审失败 → 修复具体问题，重新评审
质量评审失败 → 修复具体问题，重新评审
任务被依赖阻塞 → 先完成依赖
计划需要修订 → 更新计划，重新提取任务

指标

指标 / 目标 / 描述：

首次规格符合度通过率 >80% → 首次通过规格评审的任务比例
首次质量通过率 >70% → 首次通过质量评审的任务比例
重新评审周期 <2 → 每个任务平均重新评审次数
任务完成率 100% → 按计划完成的任务

技能介绍

任务提取