子

子代理任务执行编排

作者:鹿Sir开发工具v4

按实现计划逐任务派发独立子代理(subagent)执行开发工作,每个任务完成后进行两阶段审查(规格合规 → 代码质量)。当用户要求按计划批量实现任务、用子代理并行/串行开发、或需要带审查检查点的任务编排时触发。触发词:子代理开发、按计划执行、任务编排、subagent、派发任务、两阶段审查。

下载量
264
点赞
66
价格
免费

技能文档

---
name: superpowers-subagent-dev
title: 子代理任务执行编排
description: 按实现计划逐任务派发独立子代理(subagent)执行开发工作,每个任务完成后进行两阶段审查(规格合规 → 代码质量)。当用户要求按计划批量实现任务、用子代理并行/串行开发、或需要带审查检查点的任务编排时触发。触发词:子代理开发、按计划执行、任务编排、subagent、派发任务、两阶段审查。
category: 开发工具
---

# 子代理任务执行编排

## 概述

通过为每个任务派发独立子代理来执行实现计划,每个任务完成后进行两阶段审查:先审规格合规,再审代码质量。

**为什么用子代理:** 将任务委托给专门的子代理,隔离上下文。通过精确构造指令与上下文,确保其专注并成功完成。子代理不应继承会话历史——精确构造它们需要的上下文。

**核心原则:** 每个任务使用全新子代理 + 两阶段审查(规格合规 → 代码质量)。

## 适用条件

```
有实现计划?
  → 任务大多独立? → 使用本技能编排子代理执行
  → 无计划 / 任务强耦合? → 先做方案梳理,或手动顺序执行
```

## 技能工作流

### 步骤1:读取计划并提取任务

读取计划文件一次,提取所有任务及其完整文本与上下文,创建任务清单。

### 步骤2:派发实现者子代理

为当前任务派发一次性子代理,任务文本必须完整内联(不让子代理自行读计划文件),并附上必要的项目上下文与场景说明。

### 步骤3:处理子代理提问

子代理提问时先回答、补充上下文,再重新派发或让其继续;不要忽略提问直接推进。

### 步骤4:实现者自完成

实现者完成实现、运行测试、提交代码并自审。

### 步骤5:规格合规审查

由主会话或独立审查子代理检查实现是否满足计划规格。发现问题 → 反馈给实现者修复 → 重新审查;通过 → 进入下一步。规格合规通过前不得开始质量审查。

### 步骤6:代码质量审查

检查代码质量:DRY、命名、测试设计等。发现问题 → 修复 → 复查。

### 步骤7:标记完成并继续

当前任务两阶段审查全部通过后标记完成,继续下一个任务。全部完成后做最终整体代码审查与收尾(分支合并/清理等)。

## 子代理状态处理

子代理完成后报告四种状态之一,区别处理:

| 状态 | 含义 | 处理 |
|------|------|------|
| DONE | 完成 | 进入规格合规审查 |
| DONE_WITH_CONCERNS | 完成但有疑虑 | 先读关注点;涉及正确性或范围时先解决再审查 |
| NEEDS_CONTEXT | 缺少信息 | 补充缺失上下文后重新派发 |
| BLOCKED | 无法完成 | 上下文问题→补充后同模型重派;需更强推理→换更强模型;任务过大→拆分;计划本身有问题→上报用户 |

**永远不要**忽略升级,也不要不做任何变更就强制同一模型重试。

## 模型选择

用能胜任任务的最弱模型,兼顾成本与速度:

| 任务类型 | 示例 | 模型档位 |
|----------|------|----------|
| 机械实现 | 孤立函数、清晰规格、1-2 个文件 | 快速便宜模型 |
| 集成与判断 | 多文件协调、模式匹配、调试 | 标准模型 |
| 架构与审查 | 需设计判断或深度理解代码库 | 最强模型 |

## 红线(禁止事项)

- 禁止在 main/master 分支直接开始实现(除非用户明确同意)
- 禁止跳过任一阶段审查
- 有未修复问题时禁止继续
- 禁止同时派发多个实现子代理(会冲突)
- 禁止让子代理自行读计划文件(应内联提供完整文本)
- 禁止跳过场景设置上下文
- 禁止用实现者自审替代实际审查(两者都需要)
- 审查发现问题即视为任务未完成,必须走「修复 → 重新审查」循环

使用说明

# 子代理任务执行编排

按实现计划逐任务派发独立子代理执行开发,每个任务完成后经过「规格合规 → 代码质量」两阶段审查,支持按任务类型选择模型档位。

## 最简用法

```text
按 docs/plan.md 的计划执行所有任务
```

技能会提取任务清单,逐个派发子代理实现并组织审查,全部完成后做最终收尾审查。

## 目录结构

- `SKILL.md`:主工作流(七步流程、状态处理、模型选择、红线清单)

如何安装此技能?

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

浏览技能市场

支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手