SuperAPI AI 工具集

to-tickets

编程与开发

查看项目

更新于 11-04 09:45

技能介绍

用途

To Tickets 用于把一份计划、规格说明或对话内容,拆解成一组可执行的工单(tickets)。它强调“纵向切片”(tracer bullet):每个切片贯穿所有相关层次,而不是只做某一层。

主要能力

  • 从对话、规格文件路径或 issue 编号/URL 收集上下文;若用户提供引用,会读取正文与评论。
  • 可选地浏览代码库以了解现状;工单标题与描述使用项目词汇表,并遵守相关区域的 ADR。
  • 识别预重构机会,以便后续实现更简单。
  • 将工作拆成纵向切片:每个切片贯穿 schema、API、UI、测试等各层,完成后可独立演示或验证,并能放入一个全新的上下文窗口。
  • 为每个工单声明阻塞边,即必须先完成的其他工单;没有阻塞的工单可立即开始。
  • 对宽范围重构(如重命名列、重新类型化共享符号)不强行套用纵向切片,而是按 expand–contract 排序:先扩展(新增形态与旧形态并存),再按影响范围分批迁移调用点,每批为独立工单且被扩展工单阻塞,最后收缩(删除旧形态),收缩工单被所有迁移批次阻塞。

使用方式

  1. 收集上下文:基于已有对话;若用户提供规格路径或 issue 编号/URL,则完整读取。
  2. 可选浏览代码库,理解现状并寻找预重构机会。
  3. 起草纵向切片,标注每个工单的阻塞关系。
  4. 以编号列表向用户展示拆解结果,每项包含标题、被谁阻塞、交付什么端到端行为;询问粒度是否合适、阻塞边是否正确、是否需要合并或拆分,迭代直到用户批准。
  5. 发布工单:
    • 本地文件:每个工单一个文件,位于 .scratch/<feature-slug>/issues/<NN>-<slug>.md,按依赖顺序从 01 编号(阻塞者在前);“被阻塞于”字段列出依赖的编号/标题;一个工单一个文件,不合并。
    • GitHub 或其他真实工单系统:按依赖顺序每工单发布一个 issue,以便阻塞边引用真实 ID;若有原生阻塞/子 issue 关系则使用,否则在“被阻塞于”中引用阻塞 issue。除非另有说明,添加 ready-for-agent 标签。

工作边界:只处理所有阻塞者均已完成、没有被任何未完成工单阻塞的工单。纯线性链条下即自上而下推进。不要关闭或修改父 issue。

本地工单模板

<NN> — <工单标题>

要构建什么: 从用户视角描述该工单使其可用的端到端行为,而非逐层实现清单。

被阻塞于: 阻塞它的工单编号/标题,或“无 — 可立即开始”。

状态: ready-for-agent

  • [ ] 验收标准 1
  • [ ] 验收标准 2

无论哪种形式,都避免文件路径与代码片段,因为它们容易过时。例外:若原型产出的片段比文字更精确地编码了某项决策,可包含并简要注明来自原型。

验证清单

  • 每个工单是否纵向(贯穿各层)且可独立演示?
  • 每个工单是否可放入一个全新上下文窗口?
  • 阻塞边是否已声明并经用户批准?
  • 宽范围重构是否按 expand–contract 排序?
  • 工单是否按依赖顺序发布(阻塞者在前)?
  • 父 issue 是否未被改动?

适用场景

需要把计划或规格转化为可逐步交付、依赖清晰的开发工单时;希望工单可由智能体接手执行时;需要对宽范围重构做安全分批推进时。

限制

资料未说明该技能对具体代码托管平台的强制要求、安装方式、付费模式或性能指标,这些暂未提供。其效果取决于上下文是否充分以及用户对拆解的确认。