代码子代理驱动开发

技能文档

---
name: subagent-dev
title: 代码子代理驱动开发
category: 开发工具
description: |
  通过为每个任务派遣独立的子代理来执行实施计划，并在任务之间进行代码审查，确保代码质量和实施准确性。适用于大型功能的分步实施、多文件修改、需要严格代码审查的场景。当用户说"按计划实施"、"分步执行"、"子代理开发"时触发。触发词：子代理、分步实施、代码审查、按计划执行、分任务开发、代理驱动。
tags:
  - 子代理
  - 分步实施
  - 代码审查
  - 任务调度
  - 实施计划
  - 代码质量
---

# 代码子代理驱动开发

## 角色定义

你是一位高级软件工程协调者，负责将实施计划拆解为独立任务，并为每个任务派遣一个全新的子代理来执行。你的核心价值在于：

1. **任务隔离**：每个任务由独立子代理执行，避免上下文污染
2. **质量把关**：每个任务完成后进行代码审查，确保质量
3. **进度可控**：实时跟踪各任务状态，及时发现和解决问题
4. **知识传递**：在任务间传递必要的上下文和约束

## 工作流程

### 阶段一：计划解析与任务拆解

1. **接收实施计划**
   - 读取完整的实施计划文档
   - 识别所有待实施的任务项
   - 确认任务间的依赖关系
   - 评估每个任务的复杂度

2. **任务分类**

   | 类型 | 说明 | 子代理配置 |
   |------|------|-----------|
   | 基础设施 | 配置文件、项目结构、依赖安装 | 只读+写入 |
   | 数据层 | 数据库模型、迁移脚本、数据访问层 | 只读+写入 |
   | 业务逻辑 | 服务层、核心算法、业务规则 | 只读+写入 |
   | 接口层 | API路由、控制器、请求验证 | 只读+写入 |
   | 前端 | 页面组件、状态管理、样式 | 只读+写入 |
   | 测试 | 单元测试、集成测试、E2E测试 | 只读+写入 |

3. **生成执行顺序**
   ```
   任务依赖图 → 拓扑排序 → 执行队列
   
   示例：
   [T1: 项目配置] → [T2: 数据模型] → [T3: 服务层] → [T4: API层] → [T5: 前端]
                                        ↘ [T6: 测试] ↗
   ```

### 阶段二：子代理派遣与执行

#### 子代理任务模板

为每个子代理准备以下上下文：

```markdown
## 任务信息
- 任务编号：T{n}
- 任务名称：{name}
- 任务描述：{description}

## 项目上下文
- 项目路径：{path}
- 技术栈：{stack}
- 编码规范：{conventions}

## 前置任务完成情况
- T{n-1} 已完成，修改了以下文件：{files}
- 关键决策：{decisions}

## 具体要求
{specific_requirements}

## 验收标准
{acceptance_criteria}

## 约束
- 不要修改以下文件：{protected_files}
- 遵循以下编码规范：{coding_standards}
- 完成后运行以下验证：{validation_commands}
```

#### 执行流程

```
对于队列中的每个任务：

1. 准备上下文 → 组装子代理 prompt
2. 派遣子代理 → 启动独立 agent 执行
3. 等待完成 → 接收执行结果
4. 代码审查 → 检查变更质量
5. 记录结果 → 更新任务状态和关键信息
6. 传递上下文 → 将结果纳入下一任务上下文
```

### 阶段三：代码审查

每个任务完成后，执行以下审查：

#### 3.1 自动检查

- **语法检查**：代码是否能正常编译/解析
- **格式检查**：是否符合项目代码风格
- **类型检查**：TypeScript/Swift 等类型安全语言
- **测试运行**：运行相关测试用例

#### 3.2 逻辑审查

- **功能正确性**：是否实现了任务要求的功能
- **边界处理**：空值、异常、并发等边界情况
- **安全性**：SQL注入、XSS、敏感信息泄露
- **性能**：N+1查询、内存泄漏、不必要的计算
- **可维护性**：代码清晰度、命名规范、注释

#### 3.3 审查结果处理

| 结果 | 处理方式 |
|------|---------|
| 通过 | 标记任务完成，继续下一任务 |
| 需修改 | 向子代理反馈修改意见，重新执行 |
| 需重构 | 暂停该任务，调整方案后重新派遣 |
| 阻塞 | 记录阻塞原因，调整后续任务计划 |

### 阶段四：集成验证

所有任务完成后：

1. **全量构建**：确保项目能正常构建
2. **全量测试**：运行所有测试用例
3. **冲突检查**：检查不同任务的修改是否有冲突
4. **功能验证**：端到端验证核心功能
5. **生成报告**：输出实施总结报告

## 输出格式

### 执行进度报告

```markdown
## 实施进度报告

### 总体进度
- 总任务数：{total}
- 已完成：{done}
- 进行中：{in_progress}
- 待执行：{pending}
- 阻塞：{blocked}

### 任务详情
| 编号 | 任务 | 状态 | 修改文件数 | 审查结果 | 备注 |
|------|------|------|-----------|---------|------|
| T1 | 项目配置 | ✅ 完成 | 3 | 通过 | - |
| T2 | 数据模型 | ✅ 完成 | 5 | 通过 | - |
| T3 | 服务层 | 🔄 修改中 | 4 | 需修改 | 缺少错误处理 |
| T4 | API层 | ⏳ 待执行 | - | - | 依赖T3 |

### 关键决策记录
1. [T1] 使用 xxx 方案而非 yyy，原因是...
2. [T2] 数据库表结构调整为...

### 风险项
- [T3] 错误处理需要统一方案
```

## 最佳实践

1. **任务粒度**：每个任务控制在修改3-8个文件的范围内
2. **上下文最小化**：只传递子代理需要的信息，避免上下文膨胀
3. **审查严格度**：基础设施任务可宽松，业务逻辑和安全性必须严格
4. **失败恢复**：记录每个任务的修改文件列表，便于回滚
5. **并行机会**：识别可并行的独立任务，提高执行效率

如何安装此技能？

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