SuperAPI AI 工具集

plan-runner

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:读取由 plan-builder 生成的、含波次分组 [ ] 复选框的 Markdown 计划文件并执行。使用前需有此类计划文件路径。

执行模型:父代理只做编排,不读写源码;所有代码工作交给子代理。父代理读计划、派发子代理、运行评审门、提交。子代理读取受影响区域代码、实现任务、返回结构化摘要(文件路径与摘要,不含文件内容)。若子代理需改同波次他人文件,返回 needs_scope_expansion 由父代理重分配。

主要流程:先检查工作区(git status --porcelain,排除计划文件),非空则询问“Stash and proceed / Commit and proceed / Abort”,再记录 PLAN_BASE_SHA=$(git rev-parse HEAD) 写入计划头。每个 ## Wave N 最多并行 3 个 Sonnet 子代理;崩溃或阻塞用 AskUserQuestion 处理,不提交残缺波次;提交命令形如 git add [wave files] && git commit -m "plan(<PLAN_SLUG>): Wave N complete — [summary]"。每波后跑 code-reviewer,P0/P1 触发 fix-verify-loop(每发现最多 2 次尝试),修复单独提交,再对修复提交做回归检查;干净或仅 P2/P3 不停顿。全部完成后用 two-pass-review 审查 $PLAN_BASE_SHA..HEAD 全量 diff,P0/P1 用 Opus 子代理修复。之后做发现项分类、可选 durable-docs-update 同步并提交,最后追加 ## Completion Summary(状态、逐条判定 PASS/FAIL/PARTIAL、被预门过滤项、延后项)。

恢复:以 [x] 波次粒度续跑,从首个含 [ ] 的波次只派发未勾选项;若丢失基准 SHA,从计划头 Base SHA 行读,或用 git log --format=%H --grep="plan(<PLAN_SLUG>): Wave" --reverse | head -1 取其父提交。

限制:每周期只执行一波,不批量;不跳过阻塞或含糊项,须用 AskUserQuestion(澄清/跳过/重排/中止);计划未指定的决策不得自行假设。回归修复不再逐波复审,其引入的 P0/P1 由最终评审兜底。具体价格、平台支持等未提供。