To Tickets Agentic 是一个把计划、规格说明或对话拆解为工单(ticket)的技能,核心思路是产出“曳光弹式”的垂直切片,每张工单都必须声明自己的阻塞项、实现通道和测试接缝。
用途
它用于把一份计划、spec、issue 或一段对话,转化为一系列可独立演示或验证的小工单。每张工单要穿过所有受影响的层,切出一条窄但完整的路径,并且能放进一个全新的智能体上下文中。这样可以避免大块难以验证的工作,让依赖关系和执行通道变得明确。
使用前应配置好问题跟踪器和 triage 标签词汇。如果缺少这些配置,可以运行 /setup-agent-skills。
主要能力
- 收集上下文:使用当前对话;当用户提供 spec、issue 或 URL 时读取其完整正文和评论;读取相关领域文档与 ADR。
- 按需探索代码:了解现有的接缝、可能的重叠以及预重构机会。原则是先让改动变容易,再做容易的改动。
- 草拟垂直切片。每张工单必须:穿过每个受影响层,切出一条窄但完整的路径;可独立演示或验证;能放进一个全新的智能体上下文;声明自己的阻塞边;把前置性的预重构拆分为更早的工单。
- 对于无法作为垂直切片一次性变绿的宽泛机械式重构,使用 expand-contract 工单:先用新形式扩展(expand),按影响范围分批迁移调用方,在所有迁移完成后再收缩(contract)。
- 与用户一起分配通道。
- 发布工单到本地跟踪器或真实跟踪器。
使用方式
-
收集上下文。使用当前对话;当用户提供 spec、issue 或 URL 时,读取其完整正文和评论;读取相关领域文档与 ADR。
-
按需探索。探索足够的代码以理解现有接缝、可能的重叠以及预重构机会。先让改动变容易,再做容易的改动。
-
草拟垂直切片。每张工单必须切出窄但完整的路径、可独立演示或验证、能放进一个全新的智能体上下文、声明阻塞边,并把预重构拆为更早的工单。宽泛的机械式重构无法作为垂直切片变绿时,使用 expand-contract 工单。
-
与用户确认通道。呈现带编号的草稿,每张工单展示标题、阻塞项、交付的行为、建议通道以及待测试的接缝。需要确认:粒度和阻塞边;合并或进一步拆分;AFK 通道还是 attended 通道;共享同一执行前沿的工单之间的文件或模块重叠。
通道判断的标准是接缝:
- AFK:公共接缝已经存在或现在已确定,因此可以在工单中命名。
- Attended:接缝或接口设计仍是需要人工判断的问题。
处于同一前沿的工单必须接触互不相交的区域。即使两张工单在逻辑上并不互为前置,只要存在重叠,也要在它们之间加一条阻塞边;共享文件上的并行自主运行会产生本可避免的合并冲突。
迭代直到用户批准每张工单和通道。
- 发布。每个标题前缀 [Ticket],且只加一次。
- 本地跟踪器:在 .scratch/<feature>/issues/<NN>-<slug>.md 下按依赖顺序每张工单写一个文件。
- 真实跟踪器:按依赖顺序创建工单,在可用时作为父项的原生子项挂接,然后在第二轮连接原生阻塞边。确认父项列出了所有子项。
给 AFK 工单打配置好的 ready-for-agent 标签,给 attended 工单打 ready-for-human 标签。保持父 spec 不变且处于打开状态。
子问题(sub-issue)关系与阻塞(blocked-by)关系不同:前者把工作归组到父项之下,后者控制执行顺序。
工单模板:
[Ticket] <title>
Parent
<parent reference, when one exists>
What to build
<the end-to-end behavior this ticket delivers>
Acceptance criteria
- [ ] <observable criterion>
Seams under test
- <public interface and behavior, or "Attended. Seams to be agreed at the keyboard">
Blocked by
- <blocking ticket, or "None. Can start immediately">
命名接口和行为,而不是文件路径。只有当原型片段比散文更精确地记录某个已定决策时,才可以包含原型片段。
发布完成的判定标准:每张已批准的工单都已存在、带有正确的通道标签和接缝、在适用时已挂接到父项,并且每条阻塞边都已体现。
适用场景
适合把复杂计划、spec 或讨论拆成可独立验证的小步工单,并需要明确工单之间的依赖关系、执行通道(自主运行还是人工参与)以及并行执行时的文件重叠控制。也适用于需要在本地跟踪器或真实问题跟踪器中成体系地发布工单的情况。
限制
资料未提供该技能的具体安装步骤、收费或价格信息、支持的具体跟踪器列表、运行环境要求以及与其他技能的兼容性说明,这些暂未提供。