关于 implement-spec
面向编码 Agent 的技能,用于按依赖图中的工单实现规范。它协调多个子 Agent 在集成分支并行开发与合并,随后进行代码审查并完成工单处理。
主要功能
- 01读取规范与工单依赖关系
- 02安排子 Agent 并行实现
- 03合并工单分支
- 04执行代码审查并处理问题
- 05关闭工单或准备草稿 PR
适用场景
- 01交付包含多个工单的规范
- 02并行实现互不阻塞的工单
- 03协调通过 PR 关闭工单的工作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mattpocock/ skills --skill implement-spec安装后在 Claude Code 中输入/implement-spec确认已加载。
附带文件agents/openai.yaml
详细介绍
你已获得一份规格说明。该规格应关联若干工单,用于描述如何实现该规格。
问题追踪器应已提供给你。如果没有,请告诉用户运行 /setup-matt-pocock-skills。
目标是在单个集成分支上实现整份规格,并按问题追踪器关闭工作的方式解决每个工单。
工单不是步骤列表,而是带有阻塞关系的任务图。这意味着总有一个可以立即领取的前沿工单集合。
与子代理之间的通信应保持精简。主要通过上下文指针进行沟通:指向规格、工单、调研笔记和先前的提交。不要重复已经可以通过指针获取的信息。
实现者子代理应尽可能在后台运行,以实现最大并发。
步骤
- 阅读规格和工单,理解任务图。
2.(可选)使用探索子代理完成工单所需的任何探索,例如相关的代码库文件或外部文档。确保探索子代理可以保存文件,它应将 Markdown 笔记保存在仓库之外、所有后续子代理都可访问的目录中。这样实现者子代理就可以专注于实现,而无需再做探索。
-
创建集成分支。如果问题追踪器通过 PR 关闭工作,或用户提出要求,则在步骤 5 完成第一次合并后打开一个草稿 PR(没有领先 main 任何提交的分支无法发起 PR),并将其标记为关闭该规格和工单。
-
使用实现者子代理实现每个工单,每个工单使用独立的 worktree 和独立的分支。每个实现者子代理需要:
- 在开始前确认其 worktree 基于集成分支;若不是,则重置到集成分支上;
- 调用 Skill 工具并指定
tdd来构建该工单; - 在报告完成前,将集成分支的最新提交合并到自身分支。
-
每个实现者子代理完成后,使用合并子代理将其工作合并到集成分支。
-
如果这改变了可领取工单的前沿,则启动更多实现者子代理处理新的工单,以实现最大并发。
-
所有工单完成后,对集成分支调用 Skill 工具并指定
code-review。使用单个实现者子代理修复代码审查提出的所有问题。 -
如果存在草稿 PR,则将其标记为可供审查。否则,按问题追踪器关闭工作的方式解决每个工单,并报告集成分支。
-
清理所有实现者子代理的 worktree。