SuperAPI AI 工具集

gs-openspec-to-tickets

编程与开发

查看项目

更新于 11-15 17:33

技能介绍

用途

该技能将 OpenSpec 变更拆解为可独立交付的垂直切片工单(称为“追踪弹”),每个切片覆盖从数据模型、API、界面到测试的完整路径,并声明阻塞它的其他工单。发布目标为项目配置的跟踪器:GitHub、Linear、Jira 或本地 Markdown。每个变更会创建一个父工单,其下的切片作为子工单嵌套。

主要能力

  • 接收一个或多个变更名称(或散文列表)。未指定时,运行 openspec list --json 并询问用户选择活跃变更。
  • 对每个变更执行 openspec validate <change>,失败则报告错误并排除该变更。
  • 若 openspec/changes/<change>/tickets.md 已存在,则视为已拆分工单,报告路径并排除该变更。
  • 从 AGENTS.md、CLAUDE.md 或指向的文档中解析跟踪器及其目标(如 GitHub 仓库、Linear 团队、Jira 项目键)。未找到时询问用户并可选记录到这些文件中。
  • 读取对应跟踪器文件(tracker-github.md、tracker-linear.md、tracker-jira.md、tracker-local.md)以获取后续操作命令。
  • 解析标签:默认使用 Matt Pocock 的标签集(needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix);若存在 docs/agents/triage-labels.md 则覆盖映射。技能仅应用 ready-for-agent 和 ready-for-human。
  • 完整读取变更内容:proposal.md、design.md(若存在)、specs/ 下的所有规格增量、tasks.md。列出所有场景作为覆盖目标。
  • 探索代码库,使用项目词汇并遵循 ADR,识别可简化变更的前置重构。
  • 起草垂直切片:每个切片窄但完整贯穿各层,可独立演示或验证,适合单个上下文窗口。切片包含标题、所属变更、阻塞工单(可跨变更)、交付行为、覆盖场景(验收标准为场景的 WHEN/THEN 复选框)、标签(ready-for-human 或 ready-for-agent)。
  • 对于宽泛重构,采用扩展-收缩序列:扩展工单添加新形式,迁移工单分批切换调用点(均被扩展工单阻塞),收缩工单删除旧形式(被所有迁移批阻塞);必要时共享集成分支并以最终集成验证工单收尾。
  • 向用户展示合并的拆分列表,询问粒度、阻塞关系、合并/拆分、人工标签是否正确,迭代直至用户批准。批准前不发布任何内容。
  • 发布前确保标签存在。按依赖顺序发布工单(阻塞者优先),每个切片嵌套在变更父工单下,应用标签,并在跟踪器支持时原生链接阻塞关系。用户传入的父工单不会被关闭、重标记或编辑。
  • 为每个已发布变更写入 openspec/changes/<change>/tickets.md 索引,包含跟踪器、父工单、工单表格(编号、标识、标题、标签、阻塞者、覆盖场景)。

使用方式

命令格式:/gs-openspec-to-tickets <change> [<change> ...]。也可接受变更名称的散文列表。未指定变更时,技能会运行 openspec list --json 并询问选择。用户还可传入已有跟踪器工单作为某变更的父工单,技能会保留其正文、标签和状态不变。

适用场景

  • 需要将 OpenSpec 变更拆解为可独立执行、可演示的工单时。
  • 希望工单之间具有明确阻塞关系并按依赖顺序发布时。
  • 项目使用 GitHub、Linear、Jira 或本地 Markdown 作为工单跟踪器时。
  • 需要为自动化代理(ready-for-agent)或人工实现(ready-for-human)标注工单时。

限制

  • 变更必须通过 openspec validate 校验,否则被排除。
  • 已存在 tickets.md 的变更不会被重新拆分;用户需删除该文件后重跑。
  • 跟踪器未命名且无法从文档中发现时,需要用户手动指定。
  • 对于非 GitHub/Linear/Jira/本地 Markdown 的跟踪器,需要用户以一段文字描述如何创建工单、嵌套父工单、链接阻塞者、应用标签,技能按描述执行。
  • 工单正文避免文件路径和代码片段(除非代码片段比文字更精确地编码决策,如状态机、模式或类型形状),以免过时。