SuperAPI AI 工具集

implement-spec

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:交付由 /create-spec 提交的 spec,把 spec 分支上的 AFK 子问题并行实现、审查,并汇总为一个草稿 PR。整个运行是 AFK(无人应答),遇到需要人决策的问题会转为 HITL 子问题并继续推进其余部分。

主要能力:作为编排者,读取 spec 及其全部子问题(标签、阻塞关系、done set),确定 frontier(阻塞者均已完成、且自身未完成的子问题),为每个 frontier 上的 AFK 子问题启动一个后台实现子代理,各自在独立 worktree 和分支上工作;子代理用 /tdd 实现,先对齐 spec 分支最新提交,再合并并跑通仓库检查;完成的分支由 merger 子代理一次一个以 squash 方式落到 spec 分支,提交信息以 Closes <owner>/<repo>#<n> 结尾作为完成标记。每落地一次就重读 frontier,启动新就绪的项。全部完成(或仅剩 HITL)后运行 /code-review,由实现子代理修复发现,最后用 /create-pr 打开以 spec 标题为标题、正文含 Closes 的草稿 PR,并清理实现用的 worktree 与分支。

必要用法:spec 是带 issue:spec 标签的问题,其子问题是原生 GitHub 子问题,带 issue:AFK 或 issue:HITL 标签,并有原生依赖阻塞关系。spec 分支名为 spec/<n>。完成判定只看提交信息结尾的 Closes 或 issue:HITL-done 标签,而非问题开启/关闭状态。遇到阻塞或需变更决策时创建 HITL 问题:gh issue create --parent <spec> --label issue:HITL --blocking <等待它的子问题> --title "<人工决定或要做的事>" --body-file <hitl.md>,正文末尾写 "Apply issue:HITL-done when finished." 当只剩 HITL 时,在 spec 上评论并停止,不做 review、不建 PR。

限制:完全无人应答,问题不会被即时回答而转为 HITL;重启后 done set 是唯一记忆;open/closed 状态不参与完成判定,只有合并才关闭问题;若资料未提供具体实现语言、依赖或环境要求,则暂未提供。