SuperAPI AI 工具集

gs-openspec-ship-tickets

编程与开发

查看项目

更新于 11-15 16:33

技能介绍

用途:该技能是 OpenSpec 工单交付的编排者。它接手工单生成步骤产出的工单,把每张工单沿固定的六步流水线推进,最终以一次提交落到运行分支,并在所有工单完成后对变更做收尾,最后打开一个草稿 Pull Request。

主要能力:

  1. 输入解析:支持变更名(处理该变更 tickets.md 中全部未完成工单)、工单引用(#12、ENG-123、PROJ-7、<change>#03,单独处理该工单)以及无参数时列出有 tickets.md 的活跃变更并询问要交付哪一个。
  2. 调度:默认串行模式,一次一张工单,每步一个子代理;--threads 启用线程模式,每个工单在独立子分支并行运行;--parallel <n> 限制并发子线程数,默认 3。
  3. 前置准备:解析所需技能路径、解析工单跟踪器并读取其命令、加载工单正文/状态/标签/阻塞项、规划执行顺序,把工单归类为完成、前沿、等待阻塞或等待人工。
  4. 工单流水线六步:Apply(按工单范围实现)、Verify(只读核对验收标准与场景测试)、Fix verify issues、Review(按 gs-review 出报告)、Fix review issues、Commit(按 gs-git-commit 为每张工单生成一次提交,提交信息包含工单标题与引用)。
  5. 变更收尾:最后一张工单落地后,依次执行整变更验证、修复问题、按 openspec-archive-change 归档并提交,必要时先同步 delta specs。
  6. 恢复契约:失败命令需先读诊断,在范围内修复;同一失败连续三次无实质进展才返回阻塞;阻塞需给出 EVIDENCE、ATTEMPTED、NEEDED 字段。

使用方式:以 /gs-openspec-ship-tickets <change|ticket> [...] [--threads] [--parallel <n>] [--store <id>] 调用。--store 会传给运行中所有 OpenSpec 命令;--worker <ticket> --base <branch> 是线程模式子任务的内部入口。运行时需能找到 openspec-apply-change、openspec-verify-change、openspec-archive-change、openspec-sync-specs、gs-review、gs-git-commit、gs-pull-request 等技能,否则停止并指出缺失技能。

适用场景:已用 OpenSpec 管理变更与工单、希望自动化推进多张相互依赖工单并统一提交与开 PR 的团队流程。

限制:仅编排,不直接实现、验证、审查、归档、提交或开 PR;子代理不得写跟踪器,跟踪器写入由编排者负责;默认模式不创建或切换分支与工作树;需可用的工单跟踪器 CLI 或 MCP,否则停止;遇到需求冲突、范围扩张或需授权决策时作为阻塞返回;具体支持的跟踪器、运行时及配置细节暂未提供。