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