SuperAPI AI 工具集

drive-orchestrate-plan

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

概述

drive-orchestrate-plan 是一个编排型 AI 技能,用于在本地分支上通过“实现—审查”迭代循环,将一个项目计划推进到审查通过的状态。它把一轮实现委托给 ./agents/implementer.md,把一轮审查委托给 ./agents/reviewer.md,然后对审查结论进行裁定,并决定继续循环、升级或推进,直到审查者对 PR 的每个里程碑都报告 SATISFIED。

该技能是一个 orchestrator(编排器),在可委托时不直接执行实现或审查。它持有战略上下文:规格意图、计划结构、验收标准(AC)记分板、决策历史、用户偏好。它不编写代码,也不独立评估正确性,而是综合实现者与审查者的输出。

角色与 persona

编排器采用 tech-lead persona。该 persona 是编排器通用立场的来源,包括 persona 选择、呈现冲突而不合并冲突、面向受众的合适高度、让用户留在循环中、让编排过程可见等。此技能在该通用立场之上增加了计划循环特有的机制:持久化的实现者与审查者子代理、工件契约、循环算法、编排器独有的意图与工件之间的认知不对称,以及无人值守模式协议等。

实现者子代理是战术执行者,计划驱动、验证严格、对意外情况诚实。默认每个项目一个实现者,同一个子代理 ID 会跨轮次、跨里程碑恢复。审查者子代理是独立的磁盘上评估者,按 AC 驱动、感知严重程度,并对非审查工件保持只读约束。默认每个项目一个审查者,同样跨轮次、跨里程碑恢复。

使用时机

在以下情况使用该技能:已存在 projects/{project}/spec.md 与 projects/{project}/plans/plan.md(通常由 drive-create-spec 与 drive-create-plan 产出);用户希望在开 PR 前,在本地分支上把计划推进到审查干净的状态。

不适用于:产出规格或计划(交给 drive-create-project / drive-create-spec / drive-create-plan);处理 PR 审查评论(交给团队的 PR 评论处理技能);驱动 CI 失败转绿(这是另一个关注点,信号不同,是 CI 日志而非规格 AC)。

前置条件

projects/{project}/spec.md 存在且为当前版本。projects/{project}/plans/plan.md 存在并已拆分为里程碑。计划的里程碑应声明明确的验证门(测试/lint/typecheck/build 命令)。若计划尚未声明,编排器会在首次调用时推断。编排器需获得用户批准才能将工作委托给子代理。

后置条件

计划标识的每个里程碑都达到审查者在 projects/{project}/reviews/code-review.md 中的 SATISFIED 结论。code-review.md 中的验收标准记分板记录每条规格 AC 为 PASS、accepted-deferral 或 out-of-scope。分支已准备好交给团队的 PR 开启技能。

标签与命令

该技能提供三个子命令:/drive-orchestrate-plan iterate [milestone-id] 对指定或下一个待处理里程碑执行完整循环直到 SATISFIED;/drive-orchestrate-plan implement [milestone-id] 仅委托一轮实现;/drive-orchestrate-plan review 仅委托一轮审查。里程碑 ID 对应 plan.md 中的标识符,如 m1、m3。

子代理连续性

默认每个项目一个实现者子代理和一个审查者子代理。编排器跨每一轮和每个里程碑恢复相同的子代理 ID,而不是每次新建。机制取决于代理 harness。例如 Cursor 的 Task 工具暴露 resume 参数,传入先前调用返回的 agent ID 即可把新提示作为后续消息发送给该子代理,保留其完整 transcript;Claude Code 的 task 系统有等价语义;其它 harness 可能不直接暴露子代理恢复,此时可用单个长期存活的实现者 chat 与单个长期存活的审查者 chat 由编排器逐轮驱动。关键原则是:每一轮都把工作喂给同一个 chat / transcript / 子代理上下文,而不是全新的空白状态。否则每轮都从头开始,子代理会丢失此前轮次学到的一切。

多任务与后台运行

某些 harness 允许编排器把子代理放到后台运行并继续工作,Cursor IDE 是主要案例。当用户处于 Multitask Mode 时,Task 工具接受 run_in_background: true,立即返回,并在子代理完成时自动通知编排器,无需轮询。实现者轮与审查者轮都适合后台化,因为它们是每轮中最长墙钟时间的回合。但绝不可针对同一角色并行运行两个持久化子代理:每个项目只有一个实现者和一个审查者,它们是有状态的并跨轮恢复,两个并发调用会在其 transcript 上竞争并破坏连续性。循环按角色串行:实现者轮 → 等待完成 → 审查者轮 → 等待完成,即便每个单独调用是后台化的。

子代理运行期间编排器的工作

等待窗口是真实且富有成效的时间。编排器可以:预先准备下一轮委托提示;准备下一里程碑的实现范围;执行编排器自己负责的快速磁盘检查;处理用户其它问题;读取心跳而不是轮询。编排器不应:轮询后台子代理;自己并行写代码或跑验证门;委托并行子代理触碰同一 surface。

心跳在后台运行下更为重要:后台化不会消除心跳需求,反而使其更重要。编排器判断后台子代理是在取得进展还是挂起的唯一信号是心跳文件,完成通知只在成功/失败返回时触发。

为什么这很重要

每轮新建子代理会产生三种具体失败模式:程序异常看起来像工作已完成(新实现者可能发现先前轮次的提交已经覆盖了任务,但无连续性去验证这些提交是否是其自己的先前工作还是他人的零散编辑);以及其它连续性问题。

限制

该技能的详细介绍中,关于仓库中 learnings、模板文件、上游与下游 sibling 技能的具体内容,以及部分机制细节,暂未在本资料中完整提供。分类方面,该技能明确用于代码计划驱动的实现与审查编排,属于编程与开发场景。