子代理驱动开发

技能文档

---
name: majiayu000-subagent-driven
title: 子代理驱动开发
category: 开发工具
description: 通过结构化子代理调度和两阶段审查（规格合规 + 代码质量）执行实施计划。当用户需要执行包含独立任务的实施计划，并在任务间进行质量审查时触发。触发词：子代理执行、实施计划、分步开发、代码审查。
---

# 子代理驱动开发

通过为每个任务派遣独立子代理并执行强制性两阶段审查（先规格合规，再代码质量），确保系统化推进与质量把关。

## 适用场景

- 执行包含大部分独立任务的实施计划
- 需要在当前会话中保持上下文
- 任务间需要质量把关
- 多步骤间的上下文保持

**不适用场景：**
- 任务紧密耦合
- 需要并行执行
- 简单的单文件修改

## 技能工作流

### 步骤1：计划准备

从实施计划中提取所有任务及完整上下文：

```markdown
## 任务提取

从计划中创建任务条目：
- [ ] 任务1：[含完整上下文的描述]
- [ ] 任务2：[含完整上下文的描述]
- [ ] 任务3：[含完整上下文的描述]
```

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

### 步骤2：逐任务执行

对每个任务执行以下流程：

#### 2a. 派遣实现者

```markdown
实现者子代理提示：

实现以下任务：

[计划中的完整任务文本]

要求：
- 遵循 TDD：先写测试，验证失败，实现，验证通过
- 原子提交
- 完成前自查
- 有疑问时提出澄清问题
```

#### 2b. 处理澄清问题

如果实现者提出问题：
- 在实现开始前回答
- 不让实现者基于假设继续
- 记录答案供后续参考

#### 2c. 规格合规审查

```markdown
规格审查子代理提示：

审查实现的规格合规性：

**原始任务规格：**
[计划中的任务文本]

**所做更改：**
[实现者的摘要]

验证：
- [ ] 规格中的所有需求已实现
- [ ] 没有遗漏需求
- [ ] 没有添加额外功能（YAGNI）
- [ ] 实现与描述的方法一致

报告：通过或失败（附具体问题）
```

如果失败：修复问题，重新审查。

#### 2d. 代码质量审查

仅在规格审查通过后执行：

```markdown
质量审查子代理提示：

审查实现的代码质量：

**修改的文件：**
[文件列表]

审查项：
- [ ] 代码清晰度和可读性
- [ ] 错误处理
- [ ] 测试覆盖和质量
- [ ] 性能考虑
- [ ] 安全影响
- [ ] 项目规范遵循

报告：通过或失败（附具体问题）
```

#### 2e. 标记完成

两个审查都通过后：
- 标记任务为完成
- 进入下一个任务

### 步骤3：最终审查

所有任务完成后，进行综合代码审查：

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

### 步骤4：完成

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

## 关键规则

### 禁止

- 跳过审查（规格合规或代码质量）
- 在规格合规通过前开始代码质量审查
- 并行派遣多个实现子代理
- 让子代理直接读取计划文件
- 接受有未解决问题的审查
- 在当前任务通过两个审查前进入下一个

### 必须

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

## 审查顺序说明

```
1. 规格合规（是否做了正确的事？）
   ↓
2. 代码质量（是否做得好？）
```

先检查规格因为：
- 打磨错误的代码没有意义
- 需求驱动设计决策
- 质量审查以正确功能为前提

## 错误处理

| 场景 | 操作 |
|------|------|
| 实现者提出问题 | 完整回答后继续 |
| 规格审查失败 | 修复具体问题，重新审查 |
| 质量审查失败 | 修复具体问题，重新审查 |
| 任务被依赖阻塞 | 先完成依赖项 |
| 计划需要修订 | 更新计划，重新提取任务 |

使用说明

# 子代理驱动开发

通过结构化子代理调度和两阶段审查执行实施计划，确保每个任务经过规格合规和代码质量把关。

## 使用

```text
按照这个实施计划逐步执行，每个任务完成后进行审查
```

## 工作原理

技能将实施计划拆分为独立任务，为每个任务派遣子代理实现，然后依次进行规格合规审查和代码质量审查，全部通过后才进入下一个任务。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。