SuperAPI AI 工具集

implement-spec

通用与其它

查看项目

更新于 10-15 23:42

技能介绍

用途:获得一份 spec 及其关联 tickets 后,在单个 integration branch 上实现整个 spec,并按 issue tracker 关闭工作的方式解决每个 ticket。

前置条件:Issue tracker 应已提供;若没有,提示用户运行 /setup-matt-pocock-skills。

核心思路:tickets 不是步骤清单,而是含 blocking relationships 的 task graph,因此始终存在由可领取 tickets 组成的 frontier。实现时尽量让 implementer subagents 在 background 运行以获得最大并发度。与 subagents 通信应简洁,主要通过 context pointers(指向 spec、tickets、research notes 和之前 commits)传递,不重复 pointers 已含信息。

主要步骤:

  1. 阅读 spec 和 tickets,理解 task graph。
  2. 可选用 exploration subagent 完成 tickets 所需探索(相关 codebase files 或 external documentation),并把 Markdown notes 保存到 repo 外、所有后续 subagents 可访问的目录,供 implementer 专注实现。
  3. 创建 integration branch。若 issue tracker 通过 PRs 关闭工作或用户要求开 PR,则在首次合并后打开 draft PR(不领先于 main 的 branch 无法开 PR),并标记其会关闭 spec 和 tickets。
  4. 用 implementer subagents 实现每个 ticket,各自在独立 worktree 和 branch 上工作:开始时确认 worktree 基于 integration branch,否则 reset 到它上面;调用 Skill 工具并指定 tdd 构建 ticket;报告完成前把 integration branch 的 tip 合并进自己的 branch。
  5. 每个 implementer 完成后,用 merger subagent 合并其工作到 integration branch;若改变 frontier,就启动更多 implementer subagents 处理新 tickets,以获得最大并发。
  6. 所有 tickets 完成后,在 integration branch 上调用 Skill 工具并指定 code-review,在单个 implementer subagent 中修复 code review 提出的所有问题。
  7. 若存在 draft PR,标记为 ready for review;否则按 issue tracker 关闭工作的方式解决每个 ticket,并报告 integration branch。
  8. 清理所有 implementer subagents 的 worktrees。

限制:资料未提供具体支持的平台、价格或效果信息,暂未提供。