SuperAPI AI 工具集

openspec-ship-tickets

编程与开发

查看项目

更新于 11-12 05:05

技能介绍

用途

openspec-ship-tickets 负责交付由 openspec-to-tickets 为 OpenSpec 变更发布的票据。用户以编排者身份输入变更名或票据引用,技能将每张票据送入统一的票据流水线,最终在运行分支上每张票据对应一个提交,并为整个运行创建一个草稿拉取请求。

主要能力

  • 输入解析:接受变更名(交付该变更 tickets.md 中所有开放票据)、票据引用(如 #12、ENG-123、PROJ-7、<change>#03)或空参数(列出有 tickets.md 的活跃变更并询问)。
  • 前置准备:解析运行时已安装的技能(openspec-apply-change、openspec-verify-change、openspec-archive-change、openspec-sync-specs、goodreview、git),从 tickets.md 解析跟踪器并读取 tracker-ops.md,从跟踪器拉取票据正文、状态、标签和阻塞项。
  • 顺序规划:丢弃已完成票据,将需要人工处理的票据保留为未完成阻塞项,计算可执行前沿(frontier)。
  • 六步票据流水线:应用(按票据范围实现并勾选 tasks.md 条目)、验证(只读,按 CRITICAL/WARNING/SUGGESTION 输出报告)、修复验证问题、审查(goodreview)、修复审查问题、提交(每票一个提交,正文以票据引用结尾)。
  • 变更关闭:某变更最后一张开放票据落地后,执行整体验证、修复问题、同步 delta specs(如存在且未被阻塞)并归档,全部合并为一个提交。
  • 拉取请求:前沿清空后创建一个草稿 PR,包含本次运行的全部提交。
  • 恢复契约:失败命令视为待调查证据而非自动阻塞;在范围内修复格式、lint、编译警告和实现导致的测试失败;连续三次无实质进展的修复尝试后才返回阻塞。
  • 模式:默认串行模式一次处理一张票据,每步一个子代理;--threads 为每张票据在独立分支上并行运行子代理,--parallel <n> 限制并发数(默认 3)。

使用方式

命令形式为 /openspec-ship-tickets <change|ticket> [...] [--threads] [--parallel <n>] [--store <id>]。无参数时列出活跃变更并询问要交付哪一个,这是启动前唯一会问的问题。--store <id> 会传递给运行中所有 OpenSpec 命令。--worker <ticket> --base <branch> 是线程模式子任务的内部入口。

适用场景

适用于已由 openspec-to-tickets 生成票据、需要按依赖关系批量实施并交付的 OpenSpec 变更;适合希望将实现、验证、审查、提交与归档流程标准化、并自动生成草稿 PR 的团队。

限制

技能本身不直接实现、验证、审查、归档、提交或创建 PR,这些均由子代理完成;子代理不写入跟踪器,由编排者负责。默认模式不创建或切换分支与工作树。遇到需求冲突、变更产品行为或范围扩大时返回阻塞。票据跟踪器 CLI 或 MCP 不可用时停止。运行中若出现未完成的编辑,会停止批次并保留检出状态,不创建拉取请求。