Issue → Implementation 是一个把已定稿 GitHub Issue 推进到可合并代码的技能,适用于本会话中即可开始构建的场景。它承接 brainstorming-to-issue 产出的持久 what/why 规格,并在不使用已提交计划文档、也不在计划上设置人工审批关卡的前提下推进实现。
用途与定位 该技能用于在已存在定稿(非 [DRAFT])GitHub Issue、并且其中已包含达成一致的规格时,把该 Issue 转化为可工作的代码。它针对的工作规模大于单个“测试并提交”的循环,例如涉及多个文件、两个或更多可独立评审的交付物,或单元之间存在接口。
核心原则 Issue 是持久的规格;计划是临时的 how。因此计划保存在每次运行的 scratch 目录中,并在最后镜像进 PR 描述,绝不提交到 docs/ 之下。执行会自动交接给 superpowers:subagent-driven-development,流程中不存在“选择哪种方式?”的提问。该技能与 brainstorming-to-issue 正好相反:后者复用 brainstorming 的对话,但把 docs/ 与 writing-plans 的尾部改道到 Issue;本技能复用 writing-plans 的生成,但把 docs/ 与人工选择尾部改道到 scratch 与自动 SDD。
何时使用
- 已存在定稿(非 [DRAFT])Issue,并且现在准备构建。
- 工作规模超过一次测试并提交:多文件、两个及以上可独立评审的交付物,或单元之间的接口。
何时不使用
- Issue 仍为 [DRAFT],或规格尚未确定 → 先使用 superpowers:brainstorming / brainstorming-to-issue。
- 改动属于琐碎改动(见入口门槛)→ 完全跳过计划,直接进入 superpowers:test-driven-development。
入口门槛 在生成任何内容前先判断。若 Issue 未定稿,则路由到 brainstorming-to-issue。若整个改动只涉及一个文件、一个逻辑独立行为,且单个评审者可以在一次红-绿-提交中把关,则跳过计划,针对该 Issue 进行内联 TDD。否则先关联 Issue,然后生成计划。琐碎性判定是可观察的:一个文件、一个逻辑独立行为、单次红-绿-提交即可把关。如果不确定是否会拆分成两个及以上可评审单元,这种不确定本身意味着它不琐碎,应当制定计划。绝不能仅因为 Issue 文本很短就跳过计划。
先关联 Issue 生成计划前,要绑定到真实跟踪项(这是临时运行容易漂移的地方):使用 gh issue view <N> 确认它确实是定稿规格且标题不带 [DRAFT] 前缀;若带有该前缀,停止并路由到 brainstorming-to-issue。按本仓库规则认领:评论 /claim(或自我指派)并标记为进行中。记录 Closes #<N>,最终写入 PR 正文。具体命令见 plan-and-dispatch.md。
生成计划(先委托,再改道) 必需的子技能:运行 superpowers:writing-plans,从 Issue 正文生成计划,包括文件结构、任务规模划分、从 Issue 需求逐字复制的全局约束、每个任务的接口(消费/产出)、细粒度 TDD 步骤,以及其自审。按该技能的描述原样生成。不要将计划保存到 docs/ 下。将其写入执行工作树内的 .superpowers/sdd/plan.md,也就是 SDD 已用于 brief 与进度账本的同一被 git 忽略的 scratch 目录。按 SDD 的嵌套忽略约定确保该路径被忽略,绝不通过编辑被跟踪的根 .gitignore 来实现(见 plan-and-dispatch.md)。不要提交计划,它是 scratch,不是被跟踪产物;它持久的归宿是最后加入的 PR 描述。不要询问“采用哪种执行方式?”,这里没有人工关卡,自动选择子代理驱动执行。Issue 是持久的 what;这份 scratch 计划是临时的 how。
自动交接至执行 必需的子技能:使用 superpowers:subagent-driven-development,把它的 scripts/task-brief 指向 .superpowers/sdd/plan.md。生成计划与派发任务 1 之间不要暂停等待批准,因为人工已经在 Issue 定稿时批准过。SDD 通过 superpowers:finishing-a-development-branch 结束,后者会打开 PR。PR 描述必须包含计划(临时的 how)与 Closes #<N>,这是计划变得持久的地方。它绝不回到 docs/,也绝不会落在 Issue 上。
常见错误与修正
- 把计划保存到 docs/superpowers/plans/(writing-plans 的默认位置):按硬覆盖改道到 .superpowers/sdd/plan.md。
- 提交计划文件:绝不提交,它是 scratch,最后放入 PR 正文。
- 询问人工“采用哪种执行方式?”:没有计划关卡,自动交给 subagent-driven-development。
- 手工重新推导任务分解:完全委托给 writing-plans 生成,不要自己重造。
- 为一个文件的琐碎改动做计划:应用入口门槛,琐碎则内联 TDD,不做计划、不跑 SDD。
- 构建 [DRAFT] Issue:未定稿,路由回 brainstorming-to-issue。
- 从未认领或关联真实 Issue:执行 gh issue view <N>,认领并标记进行中,把 Closes #<N> 带到 PR。
- 计划最终没有持久归宿(只留在丢失的上下文中):通过收尾步骤镜像到 PR 描述。
危险信号(应停止) 即将把计划写到 docs/ 下或 git 提交它;即将要求人工选择执行模式;即将在没有计划文件的情况下把 Issue 交给 SDD,或自己重新推导任务;对一个文件、一个行为的改动运行完整计划加 SDD;Issue 标题仍写着 [DRAFT];计划只存在于对话中而磁盘上没有 .superpowers/sdd/plan.md。出现这些都意味着:把计划改道到 scratch,不让人类进入计划关卡,并让 Issue(持久的 what)与 PR(持久的 how)成为唯一被持久化的产物。
限制与说明 该技能依赖 superpowers:writing-plans、superpowers:subagent-driven-development、superpowers:finishing-a-development-branch、superpowers:test-driven-development 等子技能,以及 gh 命令行与 git 分支流程。关于具体脚本、安装命令与配置,现有资料未提供更多细节。