SuperAPI AI 工具集

to-tickets

通用与其它

查看项目

更新于 10-16 11:21

技能介绍

用途:将计划、规格说明或对话上下文拆分为一组 tracer-bullet 工单,即贯穿各层的纵向切片,每个工单声明在它之前必须完成的阻塞工单。需先由 /setup-agent-skills 提供问题跟踪器和分诊标签词汇;若未提供,应提示用户运行 /setup-agent-skills。

主要能力与流程:一、收集上下文,基于已有对话内容工作,若用户传入规格路径、工单编号或 URL 等引用,则抓取并阅读其完整正文与评论。二、可选地探索代码库以了解当前代码状态,工单标题和描述应使用项目的领域词汇表,并遵守相关 ADR;寻找预重构机会。三、拆分纵向切片:每个切片贯穿 schema、API、UI、测试等所有层,是纵向而非单层横向;完成后的切片可独立演示或验证,并控制在一个全新上下文窗口内;预重构应最先完成;每个工单给出阻塞边,无阻塞者可立即开始。宽泛重构是纵向切片的例外,按 expand–contract 排序:先扩展(在不破坏现有代码的前提下并列加入新形式),再分批迁移调用点(每个批次一个工单并被扩展阻塞),最后收缩(删除旧形式,被所有迁移批次阻塞);若批次无法各自保持绿色,可共享集成分支,并由最终 integrate-and-verify 工单统一验证。四、向用户提问:以编号列表展示拆分方案,列出标题、阻塞项、交付的端到端行为,询问粒度是否合适、阻塞边是否正确、是否需要合并或拆分,迭代至用户批准。五、发布工单:本地文件方式在 .scratch/<feature-slug>/issues/<NN>-<slug>.md 下每个工单一个文件,按依赖顺序从 01 编号,不使用合并文件;真实问题跟踪器方式按依赖顺序每个工单发布一个 issue,使用平台原生阻塞/子问题关系,否则设置 Blocked by,并默认应用 ready-for-agent 标签。不要关闭或修改任何父 issue。

工单模板包含 Parent、What to build、Acceptance criteria、Blocked by 等部分,描述端到端行为而非逐层实现,避免具体文件路径或代码片段,例外是原型中精确编码决策的片段(如状态机、reducer、schema、类型形状)可内联。

限制:官方资料未提供具体收费、价格、平台或使用步骤细节。