mcpField
I
implement-spec

implement-spec

github.com/mattpocockAgent 工作流305.7k300.7k 次安装1 天前更新
代码仓库

关于 implement-spec

面向编码 Agent 的技能,用于按依赖图中的工单实现规范。它协调多个子 Agent 在集成分支并行开发与合并,随后进行代码审查并完成工单处理。

主要功能

  1. 01读取规范与工单依赖关系
  2. 02安排子 Agent 并行实现
  3. 03合并工单分支
  4. 04执行代码审查并处理问题
  5. 05关闭工单或准备草稿 PR

适用场景

  1. 01交付包含多个工单的规范
  2. 02并行实现互不阻塞的工单
  3. 03协调通过 PR 关闭工单的工作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mattpocock/skills --skill implement-spec

安装后在 Claude Code 中输入/implement-spec确认已加载。

附带文件agents/openai.yaml

详细介绍

你已获得一份规格说明。该规格应关联若干工单,用于描述如何实现该规格。

问题追踪器应已提供给你。如果没有,请告诉用户运行 /setup-matt-pocock-skills。

目标是在单个集成分支上实现整份规格,并按问题追踪器关闭工作的方式解决每个工单。

工单不是步骤列表,而是带有阻塞关系的任务图。这意味着总有一个可以立即领取的前沿工单集合。

与子代理之间的通信应保持精简。主要通过上下文指针进行沟通:指向规格、工单、调研笔记和先前的提交。不要重复已经可以通过指针获取的信息。

实现者子代理应尽可能在后台运行,以实现最大并发。

步骤

  1. 阅读规格和工单,理解任务图。

2.(可选)使用探索子代理完成工单所需的任何探索,例如相关的代码库文件或外部文档。确保探索子代理可以保存文件,它应将 Markdown 笔记保存在仓库之外、所有后续子代理都可访问的目录中。这样实现者子代理就可以专注于实现,而无需再做探索。

  1. 创建集成分支。如果问题追踪器通过 PR 关闭工作,或用户提出要求,则在步骤 5 完成第一次合并后打开一个草稿 PR(没有领先 main 任何提交的分支无法发起 PR),并将其标记为关闭该规格和工单。

  2. 使用实现者子代理实现每个工单,每个工单使用独立的 worktree 和独立的分支。每个实现者子代理需要:

    • 在开始前确认其 worktree 基于集成分支;若不是,则重置到集成分支上;
    • 调用 Skill 工具并指定 tdd 来构建该工单;
    • 在报告完成前,将集成分支的最新提交合并到自身分支。
  3. 每个实现者子代理完成后,使用合并子代理将其工作合并到集成分支。

  4. 如果这改变了可领取工单的前沿,则启动更多实现者子代理处理新的工单,以实现最大并发。

  5. 所有工单完成后,对集成分支调用 Skill 工具并指定 code-review。使用单个实现者子代理修复代码审查提出的所有问题。

  6. 如果存在草稿 PR,则将其标记为可供审查。否则,按问题追踪器关闭工作的方式解决每个工单,并报告集成分支。

  7. 清理所有实现者子代理的 worktree。

评论

支持 Markdown