关于 to-issues
to-issues 将计划拆分为可独立领取的端到端 issue,并在确认拆分方案后按依赖顺序发布。它面向需要把工作切成可单独演示或验证的纵向切片的开发团队。
主要功能
- 01按端到端纵向切片拆分计划
- 02标记 HITL 与 AFK 类型
- 03梳理切片依赖关系
- 04收集用户对拆分方案的确认
- 05按依赖顺序发布 issue
适用场景
- 01将功能计划拆成独立开发任务
- 02为并行实施安排任务依赖
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ camacho/ ai-skills --skill to-issues安装后在 Claude Code 中输入/to-issues确认已加载。
详细介绍
转为 Issue
使用垂直切片(示踪弹)将计划拆分为可独立领取的 Issue。
Issue 跟踪器应可通过 gh 访问。如果需要了解标签词汇,请查看项目的 AGENTS.md 或 Issue 模板。
流程
1. 收集上下文
根据对话中已有的上下文开展工作。如果用户传入了 Issue 引用(Issue 编号、URL 或路径)作为参数,请从 Issue 跟踪器中获取该 Issue,并阅读完整正文和评论。
2. 探索代码库(可选)
如果你尚未探索代码库,请进行探索以了解代码的当前状态。Issue 标题和描述应使用项目的领域术语表,并遵循你所修改部分的 ADR。
3. 起草垂直切片
将计划拆分为示踪弹 Issue。每个 Issue 都是一个精简的垂直切片,需端到端贯穿所有集成层,而非仅覆盖某一层的水平切片。
切片可以是「HITL」或「AFK」。HITL 切片需要人工交互,例如架构决策或设计评审。AFK 切片无需人工交互即可实现并合并。在可行的情况下,优先选择 AFK。
- 每个切片都应贯穿所有层(架构、API、UI、测试),交付一条范围精简但完整的路径 - 已完成的切片应能独立演示或验证 - 优先拆分成多个精简切片,而非少数几个庞大切片4. 向用户确认
以编号列表的形式展示拟议的拆分。对每个切片,列出:
- 标题:简短且能描述内容的名称
- 类型:HITL / AFK
- 阻塞项:必须先完成的其他切片(如有)
- 涵盖的用户故事:该切片对应的用户故事(如果源材料中有)
询问用户:
- 粒度是否合适?(过粗 / 过细)
- 依赖关系是否正确?
- 是否应合并某些切片,或进一步拆分?
- 将哪些切片标记为 HITL 和 AFK 是否正确?
持续迭代,直到用户批准拆分方案。
5. 将 Issue 发布到 Issue 跟踪器
对每个已批准的切片,将其作为新 Issue 发布到 Issue 跟踪器。使用下方的 Issue 正文模板,并应用 needs-triage 分类标签,使每个 Issue 进入常规分类流程。
按依赖顺序发布 Issue(先发布阻塞项),以便在「阻塞项」字段中引用真实的 Issue 标识符。
## 父 Issue引用 Issue 跟踪器中的父 Issue(如果源内容来自已有 Issue;否则省略此部分)。
要构建的内容
简要描述此垂直切片。描述端到端行为,而非逐层说明实现方式。
验收标准
- 标准 1
- 标准 2
- 标准 3
阻塞项
- 引用阻塞该任务的 Issue(如有)
如果没有阻塞项,则填写「无,可立即开始」。
请勿关闭或修改任何父 Issue。