用途
implement-spec 用于实现 /to-spec 与 /to-tickets 的产出。它接收一份规格说明,该规格应带有描述如何实现的工单,目标是在单一集成分支上完成整个规格的实现,并按问题跟踪器关闭工作的方式解决每一个工单。
主要能力
- 任务图调度:工单不是步骤列表,而是带阻塞关系的任务图,因此始终存在一批可被领取的就绪工单,可据此持续启动新的实现子代理以获得最大并发。
- 问题跟踪器解析:解析顺序为:用户明确指令;否则 docs/agents/issue-tracker.md(由 /setup-skills 写入);否则本地 markdown,位于 .scratch/<feature-slug>/tickets/。
- 按工单选择模型与努力度:每个工单含 > Difficulty: 行。在 Claude Code 上取 (Claude Code) 前的名称,在 Cursor 上取 (Cursor) 前的名称,并兼容旧工单中用破折号替代冒号的分隔符。解析顺序:识别到的模型名(含 opus、sonnet、haiku,大小写不敏感)→ 档位(Heavy 为 Opus、Standard 为 Sonnet、Light 为 Haiku)→ 缺失或无法解析时用 Sonnet。所有因缺失或无法解析导致的 Sonnet 回退需记录并在最终报告中列出。
- 努力度约束:每个 Sonnet 与 Opus 派生都传 effort: medium,不超过此值;Haiku 派生不设 effort。该规则也覆盖运行中调用的技能(tdd、review-axes)所派生的子代理。Heavy 工单在 Opus 上以 medium 运行,无人工关卡。
- 无工单子代理:探索子代理与合并子代理以 Sonnet、medium 运行。修复子代理(第 7 步共享状态失败、第 8 步审查发现)使用涉及工单中最强的模型(Haiku < Sonnet < Opus),下限为 Sonnet medium;无法确定涉及工单时用 Sonnet medium。
- 宿主限制:若宿主无法按派生设置模型,或对含 Sonnet/Opus 派生的运行无法按派生设置 effort(纯 Haiku 运行无需 effort 控制),则在派生任何子代理之前停止,告知用户并建议改用 /implement。绝不回退到会话自身的模型或 effort。
- 沟通方式:与子代理的往来沟通应稀疏,主要通过上下文指针(规格、工单、研究笔记、先前提交),不重复指针已可获取的信息。
使用方式
- 读取规格与工单,理解任务图。
- (可选)用探索子代理完成工单所需的探索——相关代码库文件或外部文档;按模型与努力度规则运行;确保其可保存文件,把 markdown 笔记保存到仓库外、后续子代理均可访问的目录。
- 创建集成分支。若跟踪器通过 PR 关闭工作或用户要求,则在第 5 步第一次合并后开启草稿 PR(主分支无领先提交的分支无法开 PR),标记为关闭该规格与工单。
- 用实现子代理实现每个工单,各自在独立 worktree 与分支上,按工单指定的模型与 effort 运行。每个实现子代理:开始前确认其 worktree 基于集成分支,否则重置到该分支;调用 Skill 工具的 tdd 构建工单,只运行隔离测试(单元与纯逻辑,不触及共享状态);编写工单所需的共享状态测试(数据库、API、e2e、共享端口/文件/队列/外部服务等)但不运行;报告完成前把集成分支最新提交合并进自己的分支。
- 实现子代理完成后,用合并子代理将其工作合入集成分支。若这改变了可用工单的前沿,则启动更多实现子代理处理新工单。
- 全部工单完成并合并后,在集成分支上串行运行一次共享状态测试(无其他子代理运行)。并行实现共享同一数据库、端口与服务,若在第 4 至 6 步运行会互相破坏数据。所有失败在单个修复实现子代理中处理,之后仅重跑失败测试。
- 在集成分支上调用 Skill 工具的 review-axes,把规格路径作为其 spec 参数。在单个修复实现子代理中修复审查提出的所有问题;若修复触及共享状态测试覆盖的代码,之后串行重跑这些测试。
- 若存在草稿 PR,标记为可审查;否则按跟踪器关闭工作的方式解决每个工单,并报告集成分支及工单、模型、effort 表格。在本地 markdown 跟踪器上,解决工单指在主检出(非 worktree)中修改其文件:依据第 7 步 Spec 报告与该工单已合并的工作,把集成分支已实现的每条验收标准改为 - [x],未满足的保留 - [ ],当所有框都勾选后设 Status: ready-for-human;仍有未勾选框的工单保持原状态并列入报告。这是 /archive-feature 归档特性前检查的内容。
- 清理所有实现子代理 worktree。
适用场景
适用于已有规格与任务图式工单、希望并行落地实现并统一集成、审查与关闭流程的开发工作流。
限制
宿主必须能按派生设置模型;含 Sonnet/Opus 派生的运行还须能按派生设置 effort,否则应在派生任何子代理前停止并建议改用 /implement,不得回退到会话模型或 effort。共享状态测试必须串行运行,不能与并行实现阶段同时进行。价格、平台支持范围等细节暂未提供。