About implement-spec
implement-spec is a skill for coding agents implementing a specification and its related tickets. It organizes dependency-aware work across separate worktrees and an integration branch, including review and cleanup.
Key features
- 01Read specs and map ticket dependencies
- 02Schedule implementers from the available frontier
- 03Use separate worktrees and branches per ticket
- 04Merge work and run code review
- 05Clean up implementer worktrees
Use cases
- 01Work through implementation tickets with dependencies
- 02Develop tickets in parallel and merge to an integration branch
- 03Review and fix code after ticket completion
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/implement-specin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project README你已被提供一份 spec。该 spec 应关联若干 ticket，用以描述如何实现该 spec。
应该已经为你提供了 issue 跟踪器。如果没有，请告诉用户运行 /setup-matt-pocock-skills。
目标是整份 spec 在一条集成分支上实现完成，每张 ticket 都按 issue 跟踪器关闭工作的方式解决。
这些 ticket 不是一份步骤清单。它们是一张任务图，彼此之间存在阻塞关系。这意味着始终存在一个前沿（frontier）：可立即被领走的 ticket。
与子智能体之间的通信应保持精简。通信主要通过上下文指针：指向 spec、ticket、研究笔记与历史 commit。无需重复指针已经能触达的信息。
实施者子智能体应尽可能在后台运行，以获得最大并发。
步骤
-
阅读 spec 与 ticket，理解任务图。
-
（可选）使用一个探查子智能体完成 ticket 所需的探查工作：相关的代码库文件或外部文档。确保该探查子智能体能够保存文件：它应把 Markdown 笔记保存在仓库之外、所有后续子智能体都能访问的目录中。这让实施者子智能体可以专心实现，而非探查。
-
创建集成分支。如果 issue 跟踪器通过 PR 关闭工作，或者用户要求一个 PR，则在步骤 5 的第一次合并之后开一个 draft PR（一个在 main 之上没有 commit 的分支开不了 PR），并标记为关闭对应的 spec 与 ticket。
-
使用实施者子智能体逐一实现每张 ticket，每个都在自己的 worktree、自有的分支上工作。每个实施者子智能体：
- 开始前先确认其 worktree 基于集成分支，如果不是则重置到该分支；
- 调用 Skill 工具并传入
tdd来构建 ticket； - 在报告完成之前，把集成分支的顶部合并进自己的分支。
-
一旦某个实施者子智能体完成，使用一个合并子智能体将其工作合并进集成分支。
-
如果这改变了可领取 ticket 的前沿，立刻启动更多实施者子智能体去处理新出现的 ticket。这保证了最大并发。
-
所有 ticket 完成后，对集成分支调用 Skill 工具并传入
code-review。用一个实施者子智能体一次性修复 code review 提出的全部问题。 -
如果存在 draft PR，将它标记为 ready for review。否则，按 issue 跟踪器关闭工作的方式逐张解决 ticket，并报告集成分支。
-
清理所有实施者子智能体的 worktree。