SuperAPI AI 工具集

plan-to-implementation

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:当某个开放的草稿 GitHub PR 带有针对已定稿 issue 的标记实现计划,且需要在全新上下文中开始或继续执行时使用。调用即表示用户已审阅并批准完整的标记计划评论,并选定了该仓库的 SDD 工作流,因此不再重复请求计划批准。

主要能力与状态:PR 描述、其中唯一一条带标记的计划评论以及已推送分支构成持久状态。执行模式仅为子代理驱动开发,禁止调用 Native superpowers:executing-plans,也禁止从本技能调用 gh pr create 或重建规划会话。

使用方式(恢复,每次全新进入按序执行 6 步):解析唯一一个关闭该 issue 且恰有一条含 <!-- BEGIN PLAN --> 评论的开放草稿 PR,零个或多个匹配即停止报告,不得按标题猜测;确认关联 issue 已定稿(标题无 [DRAFT] 前缀,## Brainstorm state 段无 Next: 行);确认该 PR 评论中恰有一对有序 BEGIN PLAN/END PLAN 标记;由 PR 的 headRefName 解析 worktree,始终隔离、不询问,恰一个则进入,无则按 superpowers:using-git-worktrees 为该既有分支创建,多个则停止报告,并在 worktree 内运行 gh pr checkout <M>;仅把标记之间的文本提取到 .superpowers/sdd/plan.md;若 .superpowers/sdd/plan/progress.md 存在则保留并从中恢复,否则从 Task 1 开始。

执行与冲突:派发前逐项确认门禁,然后以 superpowers:subagent-driven-development 配合 plan.md 执行。预检冲突时自愈一次:用 superpowers:writing-plans 从 issue 重新生成计划,就地编辑该评论(按评论 ID),不得重发;仍冲突则 gh pr close <M> --delete-branch,给 issue 标题加 [DRAFT],评论具体冲突,取消分配并移除 in-progress,停止并回到 brainstorming-to-issue。

中途阻塞:停止派发,在草稿 PR 描述前加 ## ⚠️ Blocked — needs human decision,说明任务、原因、冲突计划文本与所需决定,报告真实进度与测试状态,保留 Closes #N 与摘要,计划评论不动;推送已提交工作,保持草稿、分配与 in-progress,跳过最终整分支审查与测试必须通过门禁,停止,不得开第二个 PR 或重置 issue。

成功收尾:调用 superpowers:finishing-a-development-branch,跳过其完成菜单且不新建 PR;分别检查实现计划与最终审查是否要求人工验证,若需要则在现有 PR 描述中新增或更新 ## Manual testing 并给出具体步骤与预期结果,保留其他面向审查者的内容,计划评论不变,重新获取并验证描述;随后推送分支并运行 gh pr ready <M>,保留 worktree。

限制:资料未提供安装命令、收费、平台与效果信息;红旗状态(如同一分支被多个 worktree 检出)应停止报告而非询问或猜测。