SuperAPI AI 工具集

execute-plan

通用与其它

查看项目

更新于 10-16 03:04

技能介绍

用途:按 plan.md 中按波次分组的待办任务实现功能。触发条件:用户说 run the plan、execute the plan 或 implement it,且 meta/specs/NNN-slug/ 下存在由 write-plan 生成、含波次化 [ ] 任务的 plan.md,或需要续跑部分执行的计划。不适用:尚无波次(改用 write-plan)、设计未定(改用 tech-design)、计划状态已 FROZEN。

主要能力与执行模型:父智能体作为编排者,读取 plan.md 与 spec.md,派发子智能体、运行审查关卡并提交;自身不读源码或写代码(第 5 步文档同步除外),仅在 2.5 步(提升)与第 6 步(发布关卡)编辑 spec.md。子智能体(实现者)接收计划路径、被指派任务 ID、任务引用的 AC-NNN-XX 文本、相关结构大纲片段及既有 [Implementation] 日志条目;写入前先解析目标路径并读取 .claude/rules/ 中匹配的规则。

模型选择:优先用户指定的模型;否则满足全部条件的逻辑任务用 Sonnet(改动完全指定且沿用既有模式、涉及文件已知有界、无未决行为/架构/契约选择、不涉及 schema/迁移/认证/安全/并发/支付/破坏性数据/公开共享外部接口、派发中给出可验证检查),任一条件不满足或用不清楚则用 Opus;同任务不降级,出现新范围/耦合/歧义可升级。

沟通与网关:子智能体返回 files_changed、summary、discoveries,不返回文件内容。自治网关在决策可追溯到 D-NNN-XX、AC-NNN-XX、引用 spec 行或 file:line 且置信度 ≥0.80 时自动解决,否则按 Tier 1 规格、Tier 2 调查(只读 finder 与 solver)、Tier 3 升级逐级处理,自动解决记入 Execution Log。

波次执行:读取最新计划,处理 staleness 检查与 Base SHA,检查工作区,运行每个波次的任务并并行派发,收集结果、记录发现、勾选任务并提交(提交信息 git commit -m "plan(<PLAN_SLUG>): Wave N complete — [brief summary]")。崩溃/超时、验证失败、契约修改、新功能放置与破坏性操作必须询问用户。

审查策略:默认单波次审查;仅当相邻两波均低风险可逆、合计不超过 4 个文件、依赖局部明确、不触及 schema/迁移/并发写/认证/权限/安全边界/支付/破坏性数据/公开接口且无遗留审查债务时,才两波次合并审查。审查者按规模与风险选择 R1(契约与正确性,必选)、R2(跨任务与回归)、R3(数据完整性,触及 schema/迁移/并发写时),最多三名;发现按严重级处理,P0/P1 走 fix-verify-loop,P2/P3 记为 deferred 条目。

[AC-affecting] 发现触发第 2.5 步提升,必须用户批准后才修改契约,不得自动应用;计划中引用被修订 AC 的未勾选任务需逐条给出 keep/amend/drop 处置。

限制:未提供价格、平台支持、性能数据等事实;使用需符合上述前置条件与用户确认关卡,且代码、注释与提交信息规则须按资料执行。