implement-spec
用代码实现规范。
技能说明mattpocock/skills
用代码实现规范。
技能简介
implement-spec 是一个面向 Agent 的 SKILL,用于根据规范(spec)在代码中实现完整功能。它把规范关联的工单(tickets)视为一张带依赖关系的任务图,通过多个子代理(subagent)并行实现,最终汇总到一个 PR 分支。这个技能能显著提升多任务、多环节的代码交付效率,并降低 Agent 间的沟通成本。
使用场景
- 需要根据一份 spec 和一批 tickets 一次性完成代码实现并提交 PR
- 任务之间存在前后依赖,需要按“可执行前沿”顺序自动推进
- 希望先用探索子代理调研代码库或文档,再让多个实现子代理专注编码
- 希望通过合并、代码审查等流程自动把关,最终生成干净可审查的 PR
使用方法
该技能是一个 SKILL 目录,可在支持 SKILL 加载机制的 Agent 环境中按需启用。原文档未提供 npx、git clone 等安装命令,请按你所在 Agent 环境支持的方式载入技能。
典型使用流程:
- 阅读 spec 和相关 tickets,理解任务图结构。
- 可选:启动一个探索子代理,调研代码库或外部文档,并将 Markdown 笔记保存到仓库之外、所有子代理可访问的目录。
- 创建分支和草稿 PR,将 PR 标记为“关闭”对应的 spec issue 和 tickets。
- 对每个当前可执行的 ticket,启动一个实现子代理;子代理应在独立 worktree 和分支上工作。
- 子代理完成后,由合并子代理将它的工作合并回 PR 分支。
- 当任务前沿变化时,继续启动新的实现子代理,最大化并发。
- 所有 ticket 完成后,在 PR 分支执行
/code-review,并由一个实现子代理修复全部问题。 - 将 PR 标记为 ready for review,清理所有实现子代理的 worktree。
注意事项
- 该技能声明了
disable-model-invocation: true,模型不会自动调用它,需要由用户或上层流程显式触发。 - 子代理之间尽量少通信,沟通主要依靠指向 spec、tickets、研究笔记和提交记录的上下文指针,避免重复复制信息。
- 探索笔记应保存在仓库之外,否则可能污染代码库,或无法被后续子代理访问。