# Subagent Driven Development

> 按计划通过子代理逐任务执行开发，每任务经过实现→规范审查→质量审查三阶段。WorkBuddy 版使用 Agent 工具 + TaskCreate。触发词：按计划执行、子代理执行、subagent、parallel execution。

- Skill: `yinqd3/subagent-driven-development` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yinqd3/subagent-driven-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yinqd3/subagent-driven-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yinqd3 (https://skillmd.com/u/yinqd3)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yinqd3/subagent-driven-development

---


# 子代理驱动开发

## 核心原则

每个任务派全新子代理 + 两阶段审查（规范→质量）= 高质量、快迭代。

## WorkBuddy 子代理调度模式

使用 WorkBuddy 的 `Agent` 工具派发子代理，配合 `TaskCreate`/`TaskUpdate` 管理任务状态。

```markdown
GOAL: [一句话——什么结果]
CONTEXT: [计划文件路径 + 相关背景]
FILES: [精确的文件路径]
CONSTRAINTS: [TDD 强制、不扩范围、无不测试的代码]
VERIFY: [测试命令 + 预期输出]
TASK: [粘贴计划文档中的完整任务文本]
```

## 逐任务循环

对计划中的每个任务：

1. **派发实现者子代理** (Agent general-purpose)
   - 包含：完整任务文本、计划文件路径、TDD 约束
   - 等待完成通知

2. **派发规范审查子代理**
   - 包含：实现了什么、计划要求、git diff
   - 必须确认：代码精确匹配规格
   - 有遗漏 → 重新派实现者修复

3. **派发代码质量审查子代理**
   - 包含：git diff、实现描述
   - 必须批准：干净代码、无死代码、DRY、YAGNI
   - 有问题 → 派实现者修复，重新审查

4. 标记任务完成，下一个任务

## 全部任务完成后

1. 派发最终总体审查子代理（完整 diff、所有任务）
2. 修复发现的严重/重要问题
3. 移交 `finishing-a-development-branch`

## 实现者子代理提示模板

```
你是实现一个编码任务的子代理。严格遵循 TDD。

计划文件: [路径]
任务: [任务 N 文本]

约束:
- 先写失败测试。运行。确认失败。再实现。
- 只做最小实现 — YAGNI
- 每个绿色测试后提交: git add <files> && git commit -m "..."
- 不要改任务范围外的文件
- 不要加任务中没有的功能

验证:
- 运行: [测试命令]
- 预期: [预期输出]

完成后报告: 实现了什么、测试结果、提交 SHA。
```

## 规范审查子代理提示模板

```
你是做规范合规审查的子代理。

计划文件: [路径]
正在审查的任务: [任务 N 文本]
GIT 范围: [base_sha..head_sha]

只审查实现是否匹配规格。
报告:
- PASS 或 FAIL
- 任何规格遗漏（规格要求但未实现的）
- 不要评论代码风格或质量
```

## 代码质量审查子代理提示模板

```
你是做代码质量审查的子代理（不审查规范合规）。

GIT 范围: [base_sha..head_sha]
描述: [实现了什么]

审查:
- DRY 违反
- 死代码
- YAGNI 违反（不必要的功能）
- 命名问题
- 缺少错误处理

严重程度: 严重 / 重要 / 次要
报告: 批准，或按严重程度列出问题。
```

## 审查严重程度处理

| 严重程度 | 行动 |
|:---|:---|
| 严重 | 先修复再继续 — 阻塞后续任务 |
| 重要 | 先修复再继续 |
| 次要 | 记录，稍后处理 |