Reference · User-invoked · 编排层 / 主流程

to-tickets 速查

把定稿的计划 / spec / 对话拆成带 blocking edges 的 tracer-bullet 票，发布到配置好的工单系统。 完整教学见 Lesson 0010； 原文见 SKILL.md、 agents/openai.yaml、 docs/engineering/to-tickets.md。

一句话

拆成垂直切片的票（穿透 schema / API / UI / tests，各自可独立演示、 装得进一个 fresh context window），每张声明 Blocked by， 你批准后才发布；前置：跑过 /setup-matt-pocock-skills。 只能人手输入 /to-tickets 启动（disable-model-invocation: true + allow_implicit_invocation: false）。

何时伸手 / 何时别用

• 伸手：计划或 spec 已定稿，工程量超过一个会话；可带 spec 路径 / issue 编号 / URL 作参数。
• 没写成 spec → 先 grill-with-docs → to-spec。
• 一张票装得下 → 直接 implement，可跳过本步。
• 外来原始 issue → triage；迷雾大工程 → wayfinder（雾散后在 to-spec 并回主流程）。

核心词汇

Tracer bullet / Vertical slice

窄但完整的路径，穿透所有层；完成即可独立演示或验证。反面：horizontal slice（整层做完，所有层落地前无物可用）。

Blocking edge

每张票声明「哪些票必须先完成」。无 blocker = 可立即开工。docs：边才是整套拆法的意义（the whole point）。

Frontier

所有 blocker 均已完成、现在可开工的票集合。纯线性链 = 从上往下。

Prefactor

拆票前排第一的准备性重构：「Make the change easy, then make the easy change.」

Wide refactor / Blast radius

单一机械改动（改列名、改共享符号类型）波及全库，无垂直切片能落地保持绿 → 垂直切片唯一例外。

五步流程

1. Gather context：就地取材；传了引用就抓回正文 + 全部评论。
2. Explore codebase（可选）：票标题用领域术语表词汇、尊重 ADR；找 prefactor 机会。
3. Draft vertical slices：四规则（窄而完整穿各层 / 独立可演示 / 装进一个 fresh window / prefactor 最先）+ 标 blocking edges。
4. Quiz the user：编号列表展示 Title / Blocked by / What it delivers；问粒度、边、合并拆分；批准前不发布。
5. Publish：按 setup 配置的 tracker 发；票相同，只差边的形状。

宽重构：expand–contract

Expand   新形态加在旧形态旁边，并存不删
Migrate   按爆炸半径分批迁调用点（per package / directory），每批一票，
          都被 expand 阻塞；旧形态仍在 → 批间 CI 保持绿
Contract  无调用者后删旧形态；被每一张 migrate 票阻塞
变体：批次无法各自保绿 → 共享 integration branch，
      全部阻塞最后的 integrate-and-verify 票，绿只在那里兑现

发布：两种 tracker

模板字段：What to build（用户视角的端到端行为，非逐层清单）、 Blocked by、Status、验收标准复选框；远程版多一节 Parent（原料是已有 issue 时）。

三条铁规矩

1. 不碰父 issue：Do NOT close or modify any parent issue.
2. 不写文件路径 / 代码片段（过时快）；例外：prototype 产出的决策片段（状态机、reducer、schema、类型形状）可内联并注明出处，只留决策浓度高的部分。
3. 每票一个新会话执行：Work the frontier one ticket at a time with /implement, clearing context between tickets.

会改什么

• 写：本地 → .scratch/<feature>/issues/*.md 一批新文件；远程 → 一批新 issue + blocking 关系 + 标签。
• 不写：业务代码、spec、CONTEXT.md / ADR、父 issue。
• 产出的票不要再过 /triage——生来 ready-for-agent。

下一步

• 前沿上每张票 → 新会话 /implement（内部 tdd → code-review → 提交）。
• 远程 tracker 想并行 → 前沿票同时各派一个 agent。
• 拆票前会话逼近 smart zone → 先 /handoff 再继续。

微调入口（症状 → 改哪段）