用途
该技能将 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 的跟踪器,需要用户以一段文字描述如何创建工单、嵌套父工单、链接阻塞者、应用标签,技能按描述执行。
- 工单正文避免文件路径和代码片段(除非代码片段比文字更精确地编码决策,如状态机、模式或类型形状),以免过时。