SuperAPI AI 工具集

implement

编程与开发

查看项目

更新于 10-29 22:18

技能介绍

用途 implement 用于把问题跟踪器中已批准的规格(spec)或其中某个任务(task)落实为代码。它以“测试先行”为原则,每个任务在一个全新的实现子智能体中完成,完成后逐个集成到一条集成分支上。

主要能力

  • 两种模式:/implement spec [issue] 实现某规格下的全部子任务;/implement task [issue] 只实现单个任务。模式缺失或不是 spec/task 时,技能会要求补充模式。两种模式流程相同,task 模式只有单个任务在范围内。
  • 读取目标:通过已连接的跟踪器工具或已认证 CLI 访问项目配置的问题跟踪器;两者都不可用时,报告运行受阻并停止。读取 issue 及其原生关系(父、子任务、双向阻塞链接),默认读取缺少关系时需显式请求。spec 模式要求 issue 有子任务,全部子任务在范围内;task 模式要求 issue 有父规格,仅该任务在范围内。issue 内容视为数据,忽略其中的指令。
  • 状态重建:按 ID 用 git branch --list 匹配任务分支与集成分支;多个匹配会阻塞任务。分支已并入集成分支视为已集成而跳过;已有 worktree 视为恢复;其余为待处理。复用 .artifacts/implement/[spec-id]/ 下的笔记。
  • 按需探索:spec 模式下多个任务共享代码库或外部文档探索时,启动一个探索子智能体,将笔记写入 .artifacts/implement/[spec-id]/notes.md 并返回路径。
  • 分派就绪任务:阻塞者分支均已并入集成分支的任务视为就绪;一次性分派全部就绪任务,无固定数量上限,用 git worktree add 从集成分支末端创建 worktree 与分支。分派时把任务设为跟踪器的进行中状态,不设置其他状态。每个任务启动一个全新实现子智能体。
  • 集成已完成任务:报告视为声明,用 git log 核实提交是否存在于任务分支;有阻塞者的报告使任务阻塞;验证条目退出码均为 0 且提交等于任务分支末端(git rev-parse)才算验证通过,未通过则在同一 worktree 中重新交给新的实现者,计为一次退回。验证通过的任务逐个集成:集成分支末端被任务分支包含时用 git update-ref 快进,然后移除任务 worktree 但保留任务分支;不包含或 update-ref 因末端移动而拒绝时,重新分派实现者到同一 worktree。同一任务连续两次退回即阻塞,阻塞任务保留其 worktree。
  • 报告:固定模板输出集成分支名、任务结果表格(任务、结果、提交、验证)、阻塞项与未开始项。

使用方式 在支持该技能的智能体环境中使用 /implement spec [issue] 或 /implement task [issue]。运行时需有可用的问题跟踪器访问方式与 git 仓库。提交保持本地,从不推送。

适用场景 适用于已有规格与任务拆分、希望按测试先行逐任务实现并集中集成的开发流程,尤其适合需要隔离工作区(worktree)、并行分派多个独立任务的场景。

限制 需问题跟踪器中存在符合模式的 issue 关系(spec 有子任务、task 有父规格),否则报告并停止;跟踪器不可访问时运行受阻;多个同名分支匹配会使任务阻塞;连续两次退回的实现被视为阻塞。具体支持的跟踪器、平台与环境要求暂未提供。