SuperAPI AI 工具集

implement-spec

编程与开发

查看项目

更新于 11-01 02:28

技能介绍

用途 implement-spec 用于在已有规格(spec)及关联工单(tickets)的前提下,把整个规格落到一个集成分支上,最终交付一个经过验证、可评审的 PR。它要求问题跟踪器已就绪;若未提供,会提示用户运行 /setup-matt-pocock-skills。无论工单存放在哪个跟踪器,交付都必须以 PR 形式完成,仅有本地分支或已推送提交不算完成。

主要能力

  1. 任务图调度:工单不是步骤清单,而是带阻塞关系的任务图,因此总有处于前沿、可立即抓取的工单;技能据此并行启动实现子代理以最大化并发。
  2. 子代理隔离与上下文管理:每个实现子代理在独立工作树、独立分支上运行,启动时使用全新上下文窗口;子代理之间沟通稀疏,优先通过指向规格、工单、研究笔记和既往提交的上下文指针传递信息,避免重复。
  3. 可选探索阶段:可用探索子代理调研相关代码库文件或外部文档,并把 Markdown 笔记保存在仓库外、后续子代理可访问的目录,让实现子代理专注实现。
  4. 进度与跟踪器状态分离:工单的“已整合”以其实现在集成分支上为准,据此释放依赖工单;即便对应 issue 仍处开放状态。恢复执行时从提交和任务图重建进度。
  5. 代码评审与修复:所有工单实现整合后,在集成分支上针对选定基线调用 code-review 技能,由新的实现子代理统一修复问题并运行相关检查。
  6. PR 交付与远程验证:推送最终集成分支,创建或更新 PR,填充规格、工单、交付行为摘要与验证结果,将草稿标记为可评审,并从远程状态核验 PR 处于开放且可评审、头/基分支与记录一致、头提交与本地最终集成提交一致、正文链接规格与全部已实现工单、以及规格与子工单在 PR 未合并期间保持开放且不处于终态。

使用方式 先读取规格与工单理解任务图,识别托管仓库、推送远程与 PR 基线分支(未指定时用仓库默认分支),并预检托管工具是否已认证、能否推分支和开 PR,失败时报告具体访问阻塞。然后从选定基线创建集成分支或恢复已有集成分支,记录头分支与目标基线;首次合并后推送集成分支并在无 PR 时开草稿 PR(空集成分支无法开 PR),正文链接规格与每个工单。每个工单使用新的实现子代理:确认工作树基于集成分支(否则重置),调用 Skill 工具的 tdd 构建工单,报告前把集成分支最新提交合并进自身分支,且保持跟踪项开放;返回后由 merger 子代理合并到集成分支并记录为已整合。之后按前沿变化继续启动实现子代理。

提交与关闭规则 实现提交和中间 PR 使用 Refs #<number> 或普通链接;自动关闭引用只保留给最终集成 PR 正文,且需在 PR 合并后才关闭。若跟踪器或选定基线不支持合并时关闭,则保持条目开放、链接到最终 PR,并说明关闭需要经核验的合并;创建 PR 不等于可以手动关闭条目。

适用场景 适用于已有规格与工单、希望以并行、可追溯方式完成实现并产出可评审 PR 的工程流程,尤其适合工单间存在阻塞依赖、需要最大化并发并严格区分“进度”与“完成”的项目。

限制 需要可用的问题跟踪器与已认证、能推分支和开 PR 的托管工具,否则报告访问阻塞。空集成分支不能开 PR,需先完成首次合并。若自动化或代理动作提前把条目置为终态,须报告受影响条目与状态迁移作为阻塞,保留分支与工作树,并将本次运行标记为不完整。最终验证以远程状态为准,仅凭分支名不构成 PR;推送、创建、更新、标记就绪或验证任一失败,均需保留集成分支与工作树、报告失败操作与具体阻塞,并标记发布不完整,重试时先查询已有 PR。清理只针对本次运行创建的实现与合并工作树,保留无关工作树和集成分支。PR 保持开放等待评审,合并需要单独的用户指令;已关闭但未合并的 PR 不算数。

输出 成功验证后报告 PR URL、其基线与头分支、验证结果以及任何剩余的非阻塞限制,将结果描述为已实现并等待 PR 合并,规格与子工单仍保持开放。