SuperAPI AI 工具集

to-tickets

编程与开发

查看项目

更新于 10-15 21:46

技能介绍

用途:把计划、规格或对话拆分为一组工单,每个工单是一个 tracer-bullet 垂直切片,并声明阻塞它的其他工单,最后发布到已配置的追踪器。若规格包含 Gherkin 场景,每个工单应映射一个或多个场景,场景为权威验收标准。使用前需已提供问题追踪器与分诊标签词汇;否则提示用户运行 /mattpocock:setup-matt-pocock-skills。

主要能力与流程:1) 从对话上下文收集信息,用户传入引用(规格路径、issue 编号或 URL)时抓取并读取正文与评论。2) 可选探索代码库,工单标题描述使用项目领域词汇并遵循相关 ADR,寻找预重构机会。3) 起草垂直切片:每个切片窄但完整地穿过 schema、API、UI、测试各层,可独立演示或验证,规模适配单个新上下文窗口;预重构先行。宽泛重构是例外,按 expand–contract 排序:先扩展新形式并存,再按影响面分批迁移(每批被扩展阻塞),最后在所有迁移批次完成后收缩删除旧形式;若单批无法保持绿色,可共享集成分支并最终由集成验证工单保证绿色。4) 用 AskUserQuestion 一次性提出三个问题(粒度、阻塞边是否正确、是否合并或拆分),迭代直到用户批准。5) 发布:本地文件写入 .scratch/<feature-slug>/issues/<NN>-<slug>.md,按依赖顺序从 01 编号,每文件一个工单;真实追踪器按依赖顺序每工单一个 issue,使用原生阻塞/子 issue 关系,否则设置 Blocked by,默认打上 ready-for-agent 标签。工单模板包含 What to build、Acceptance criteria、Blocked by、Status,来源为既有 issue 时含 Parent。不要关闭或修改父 issue。

适用场景:需求或规格已明确、需要拆成可并行或按依赖推进的可交付工单时。限制:依赖已配置的追踪器与标签词汇;避免写入具体文件路径或代码片段(易过时),除非原型片段比文字更精确地编码决策,可内联并注明来源,且只保留决策相关部分。其他细节暂未提供。