to-issues

拆分为 Issue

使用纵向切片（示踪弹）将计划拆分为可独立领取的 issue。

应该已向你提供 issue 跟踪器和分诊标签词汇；如果没有，请运行 /setup-utarn-skills。

流程

1. 收集上下文

根据对话中已有的上下文开展工作。如果用户传入 issue 引用（issue 编号、URL 或路径）作为参数，请从 issue 跟踪器中获取该 issue，并阅读其完整正文和评论。

2. 探索代码库（可选）

如果你还没有探索代码库，请先了解代码的当前状态。issue 标题和描述应使用项目领域词汇表中的术语，并遵守你要修改部分的 ADR。

留意可先重构代码、让实现更容易的机会。“先让改动变容易，再做容易的改动。”

3. 起草纵向切片

将计划拆分为示踪弹 issue。每个 issue 都是一个精简的纵向切片，贯穿所有集成层端到端，而不是仅涉及某一层的横向切片。

• 每个切片都应贯穿所有层（架构、API、UI、测试），交付一条范围精简但完整的路径
• 完成的切片应可独立演示或验证
• 应先完成所有预重构工作

4. 与用户确认

以编号列表的形式展示建议的拆分。对于每个切片，列出：

• 标题：简短的描述性名称
• 阻塞项：必须先完成的其他切片（如果有）
• 涵盖的用户故事：该切片涉及的用户故事（如果源材料中包含）

询问用户：

• 粒度是否合适？（太粗 / 太细）
• 依赖关系是否正确？
• 是否需要合并某些切片，或进一步拆分？

反复沟通，直到用户批准拆分方案。

5. 将 issue 发布到 issue 跟踪器

对于每个已批准的切片，使用下方的 issue 正文模板，在 issue 跟踪器中创建一个新 issue。这些 issue 已准备好交由 AFK Agent 处理，因此请添加正确的分诊标签，除非另有指示。

按依赖顺序发布 issue（先发布阻塞项），这样你就可以在“阻塞项”字段中引用真实的 issue 标识符。

## 父级

引用 issue 跟踪器中的父级 issue（如果源材料来自现有 issue；否则省略此部分）。

要构建的内容

简明描述此纵向切片的内容。描述端到端行为，而非逐层实现细节。

避免指定文件路径或代码片段——它们很快就会过时。例外情况：如果原型生成的代码片段比文字说明更精确地表达了某项决策（状态机、reducer、架构、类型形状），则将其内联放在此处，并简要注明它来自原型。只保留包含关键决策的部分——不需要可运行的演示，只需重要内容。

验收标准

• 标准 1
• 标准 2
• 标准 3

阻塞项

• 引用阻塞此 issue 的票据（如果有）

如果没有阻塞项，则填写“无——可立即开始”。

不要关闭或修改任何父级 issue。