SuperAPI AI 工具集

subagent-driven-development

智能体与模型

查看项目

更新于 10-16 02:22

技能介绍

用途

Subagent-Driven Development 用于在当前会话中执行一份书面的实施计划(implementation plan),前提是计划中的任务大多相互独立,且将任务委派给子代理比内联协调更划算。若需要跨会话执行,则应改用 executing-plans。

主要能力

  • 读取计划,提取全部任务全文,并创建 TodoWrite。
  • 为每个任务派发一个全新的实现者子代理(implementer),随后进行两阶段审查:先规格符合性审查(spec compliance),再代码质量审查(code quality)。
  • 通过 SubagentContextPacket 进行紧凑的上下文交接,而不是传递完整对话历史。
  • 协调者负责验证、提交、更新检查点与漂移检查,并作为默认的 Git 变更所有者。
  • 提供实现者、规格审查者、代码质量审查者的提示模板。

使用方式

流程如下:

  1. 读取计划,提取所有任务全文,创建 TodoWrite。
  2. 每个任务:派发实现者,附带任务文本、基线引用、检查点和非目标。
  3. 实现者完成后,派发规格符合性审查者 → 修复缺口 → 重新审查直到通过。
  4. 派发代码质量审查者 → 修复问题 → 重新审查直到通过。
  5. 协调者执行全新验证,仅暂存任务所属路径,提交该连贯任务,回读 Git 状态,更新检查点/漂移 → 进入下一任务。
  6. 全部任务完成后:最终代码审查 → 完成验证;仅在任务创建了分支/工作树或被要求集成时才使用分支收尾。

在首次写入仓库前,协调代理记录 TaskStartSnapshot。同一任务的代理共享当前工作区。协调者是暂存、提交、分支和工作树的唯一默认 Git 变更所有者;实现者和审查者只编辑/验证/报告,不改变 Git 生命周期状态。

在派发实现者前,构建 SubagentContextPacket,包含:任务、目标与停止条件、相关基线引用与文件、已知事实与未知项、非目标、预期输出与验证、记录的 TDD 模式/路线/权限/选择工作流与所有者、必读摘录、不安全假设。不要粘贴完整聊天记录、完整会话历史或无界日志。

实现者子代理报告四种状态之一:DONE(进入规格审查)、DONE_WITH_CONCERNS(先阅读疑虑再决定)、NEEDS_CONTEXT(补充上下文后重新派发)、BLOCKED(评估阻塞原因:上下文问题则补充上下文重派;需要更多推理则换更强模型;任务过大则拆分;计划本身有误则上报人类)。

模型选择:机械性任务(1-2 个文件、规格完整)用快速/廉价模型;集成任务(多文件、模式匹配)用标准模型;架构/设计/审查用最强模型。

适用场景

  • 已有书面实施计划,任务大多独立,且希望留在当前会话中执行。
  • 需要为每个任务保持隔离上下文、避免继承会话历史。
  • 需要两阶段审查保证规格符合性与代码质量。

限制与红线

禁止:跳过任一阶段审查;带着未修复问题继续;并行派发多个实现子代理(会冲突);让子代理自行读取计划文件(应提供全文);跳过场景设定上下文;忽略子代理提问;在规格符合性未通过前开始代码质量审查;在任一审查有未决问题时进入下一任务;让实现者/审查者执行暂存、提交、分支或创建/删除工作树;为同一任务的代理创建各自的工作树。

若子代理任务失败,应派发修复子代理并给出具体指令,不要手动修复(避免上下文污染)。

集成

必需的工作流技能:aegis:writing-plans(创建本技能执行的计划)、aegis:requesting-code-review(审查者子代理的代码审查模板)、aegis:using-git-worktrees(必要并发检出时的条件性例外)、aegis:finishing-a-development-branch(任务创建分支或工作树时的条件性集成/清理)。

子代理应验证并消费父级 TDD 决策;若 auto 决策缺失或无效,应在源码编辑前返回其选择所有者。当 TDD 为 off 时,不要自动加载 aegis:test-driven-development 或强制 RED/GREEN,改用按比例验证;仅在 TDD Route 为 strict 或用户/项目明确要求 TDD 时加载。

替代工作流:aegis:executing-plans 用于并行会话而非同会话执行。

提示模板文件:./implementer-prompt.md、./spec-reviewer-prompt.md、./code-quality-reviewer-prompt.md。