# Implement Spec

在代码中实现 /to-spec 与 /to-tickets 的产物。

- Repository: https://github.com/devcxl/mattpocock-skills-zh (522 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add devcxl/mattpocock-skills-zh --skill implement-spec -g -a claude-code -y`
Codex: `npx skills add devcxl/mattpocock-skills-zh --skill implement-spec -g -a codex -y`
Cursor: `npx skills add devcxl/mattpocock-skills-zh --skill implement-spec -g -a cursor -y`
Gemini CLI: `npx skills add devcxl/mattpocock-skills-zh --skill implement-spec -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add devcxl/mattpocock-skills-zh`

## Description

在代码中实现 /to-spec 与 /to-tickets 的产物。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

你已被提供一份 spec。该 spec 应关联若干 ticket，用以描述如何实现该 spec。

应该已经为你提供了 issue 跟踪器。如果没有，请告诉用户运行 `/setup-matt-pocock-skills`。

目标是整份 spec 在一条**集成分支**上实现完成，每张 ticket 都按 issue 跟踪器关闭工作的方式解决。

这些 ticket 不是一份步骤清单。它们是一张**任务图**，彼此之间存在阻塞关系。这意味着始终存在一个**前沿（frontier）**：可立即被领走的 ticket。

每个子智能体都应从一个全新的上下文窗口开始。

与子智能体之间的通信应保持精简。通信主要通过**上下文指针**：指向 spec、ticket、研究笔记与历史 commit。无需重复指针已经能触达的信息。

**实施者子智能体**应尽可能在后台运行，以获得最大并发。

## 步骤

1. 阅读 spec 与 ticket，理解任务图。

2. （可选）使用一个**探查子智能体**完成 ticket 所需的探查工作：相关的代码库文件或外部文档。确保该探查子智能体能够保存文件：它应把 Markdown 笔记保存在仓库之外、所有后续子智能体都能访问的目录中。这让**实施者子智能体**可以专心实现，而非探查。

3. 创建集成分支。如果 issue 跟踪器通过 PR 关闭工作，或者用户要求一个 PR，则在步骤 5 的第一次合并之后开一个 draft PR（一个在 main 之上没有 commit 的分支开不了 PR），并标记为关闭对应的 spec 与 ticket。

4. 每张 ticket 都使用一个全新的**实施者子智能体**来实现，每个都在自己的 worktree、自有的分支上工作。每个实施者子智能体：
   - 开始前先确认其 worktree 基于集成分支，如果不是则重置到该分支；
   - 调用 Skill 工具并传入 `tdd` 来构建 ticket；
   - 在报告完成之前，把集成分支的顶部合并进自己的分支。

5. 一旦某个**实施者子智能体**完成，使用一个**合并子智能体**将其工作合并进集成分支。

6. 如果这改变了可领取 ticket 的**前沿**，立刻启动更多**实施者子智能体**去处理新出现的 ticket。这保证了最大并发。

7. 所有 ticket 完成后，对集成分支调用 Skill 工具并传入 `code-review`。用一个全新的**实施者子智能体**一次性修复 code review 提出的全部问题。

8. 如果存在 draft PR，将它标记为 ready for review。否则，按 issue 跟踪器关闭工作的方式逐张解决 ticket，并报告集成分支。

9. 清理所有**实施者子智能体**的 worktree。

