SuperAPI AI 工具集

subagent-driven-development

编程与开发

查看项目

更新于 10-30 18:19

技能介绍

用途:Subagent-Driven Development 是一个用于“执行实施计划”的流程型技能,适用于当前会话中已有实施计划、且任务彼此基本独立的场景。它通过“每个任务一个新子代理 + 任务级审查 + 最终整体审查”的方式推进开发,目标是在保证质量的同时加快迭代。

主要能力:

  1. 分任务分派实现子代理:每个任务派出一个全新的实现者子代理,其指令和上下文由主控代理精确构造,不继承主会话历史,避免上下文污染。
  2. 任务级审查:每个任务完成后立即生成审查包并派出任务审查者,审查两个维度——规格符合性(spec compliance)和代码质量,二者缺一不可,实现者的自审不能替代任务审查。
  3. 最终整体审查:全部任务完成后,派出最终代码审查者做覆盖整个分支的广泛审查;如发现问题,只做一次修复派发、一次限定范围复审,并对残余项作出裁定。
  4. 进度台账:进度记录写入台账文件而非仅依赖待办列表,因为会话记忆在压缩后不会保留;恢复时以台账和 git log 为准,台账首行标识对应计划文件,已标记完成的任务不会重复派发。
  5. 独立工作区:为每个计划分配一个被 git 忽略的工作区目录(<repo-root>/.superpowers/sdd/),存放台账、任务简报、报告、审查包等全部产物,不与其他计划混用;不要在未获人工伙伴明确同意时直接在 main/master 分支上实施。
  6. 预检冲突扫描:在派发第一个任务前通读计划,找任务之间或与全局约束相冲突之处,以及计划明确要求但审查标准会视为缺陷的内容,汇总成一次性批量问题交人工裁决,而不是执行中反复打断。
  7. 修复轮次机制:审查发现问题后进入最多 5 轮修复,第 1-3 轮可恢复原实现者,第 4 轮起换用全新实现者并升级到更强模型,每轮修复后做限定范围复审;第 5 轮仍有承载性问题则停止并向人工报告 BLOCKED。
  8. 模型分级选择:机械型实现任务用快速低价模型,集成与判断类任务用标准模型,架构与设计类以及最终整分支审查用最强模型;审查模型按改动规模、复杂度和风险匹配;派发时须显式指定模型,避免默认继承会话模型。同时提示“轮次数比 token 单价更重要”,多步工作中最低价模型往往需要 2-3 倍轮次。

使用方式:先通过 using-git-worktrees 创建或确认隔离工作区;运行 bash scripts/sdd-workspace PLAN_FILE 获得该计划的专属目录;检查 <workspace>/progress.md 台账并据此恢复或新建(首行为 # SDD ledger — plan: <计划文件路径>);通读计划、记录上下文与全局约束、为每个任务建待办;完成预检扫描;记录 BASE 提交(git rev-parse HEAD),运行 bash scripts/task-brief PLAN_FILE N 生成任务简报文件,按模板 implementer-prompt.md 派发实现者;根据返回状态(DONE、DONE_WITH_CONCERNS、NEEDS_CONTEXT、BLOCKED)分别处理;用 bash scripts/review-package PLAN_FILE BASE HEAD 生成审查包并按 task-reviewer-prompt.md 派发任务审查者;修复轮次中使用 re-review-prompt.md 复审;终审使用 ../requesting-code-review/code-reviewer.md;终审通过后删除该计划工作区,并转入 finishing-a-development-branch。全程不在任务之间暂停询问,只有无法解决的 BLOCKED、真正阻碍进展的歧义或全部任务完成时才停止;不要在多个实现子代理之间并行派发(会冲突);大段内容以文件形式交接,不粘贴进上下文。

适用场景:已有实施计划、任务大多相互独立、且具备子代理工具(且人工伙伴未选择内联执行)的编码会话。若任务紧密耦合、没有实施计划,或选择了内联执行、缺少子代理工具,则分别应改用先头脑风暴/手工执行或 executing-plans(内联执行)。

限制:资料未提供版本、安装命令、收费与价格、支持平台等信息;其脚本路径与提示词文件均以技能包内相对路径给出,需在该技能环境中使用。