子
子代理任务执行编排
作者:鹿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`:主工作流(七步流程、状态处理、模型选择、红线清单)
支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手