关于 to-issues
to-issues 是将计划拆成可独立执行的纵向切片 issue 的工作技能,面向需要把需求转成可验证任务的团队。它要求先确认依赖与粒度,再经用户批准后按依赖顺序发布。
主要功能
- 01按纵向切片拆分计划
- 02让每个切片可独立验证
- 03检查依赖与任务粒度
- 04批准后按顺序发布 issue
- 05使用验收标准模板
适用场景
- 01把功能计划转为端到端任务
- 02为多个实现任务梳理阻塞关系
- 03将已批准的切片发布到 issue tracker
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ leandrocfe/ skills --skill to-issues安装后在 Claude Code 中输入/to-issues确认已加载。
详细介绍
创建 Issues
使用垂直切片(示踪弹)将计划拆分为可独立认领的 issues。
Issue 跟踪器和 triage 标签词汇表应已提供给你;如果没有,请运行 /setup-leandrocfe-skills。
流程
1. 收集上下文
根据对话中已有的上下文开展工作。如果用户提供了 issue 引用(issue 编号、URL 或路径)作为参数,请从 issue 跟踪器中获取该 issue,并阅读其完整正文和评论。
2. 探索代码库(可选)
如果你尚未探索代码库,请进行探索,以了解代码的当前状态。Issue 标题和描述应使用项目领域词汇表中的术语,并遵循你所涉及领域的 ADR。
寻找可先对代码进行预重构、从而简化实现的机会。“先让改动变简单,再做简单的改动。”
3. 起草垂直切片
将计划拆分为 示踪弹 issues。每个 issue 都是一个精简的垂直切片,贯穿所有集成层并实现端到端,而不是只覆盖某一层的水平切片。
- 每个切片都要贯穿每一层,交付范围精简但完整的路径(架构、API、UI、测试)
- 已完成的切片应可单独演示或验证
- 任何预重构都应先完成
4. 向用户确认
以编号列表展示拟议的拆分方案。对每个切片,列出:
- 标题:简短的描述性名称
- 阻塞项:必须先完成的其他切片(如有)
- 涵盖的用户故事:该切片涉及的用户故事(如果源材料中有)
询问用户:
- 粒度是否合适?(太粗 / 太细)
- 依赖关系是否正确?
- 是否应合并任何切片,或进一步拆分?
反复迭代,直到用户批准拆分方案。
5. 将 issues 发布到 issue 跟踪器
对于每个已批准的切片,使用下方的 issue 正文模板,在 issue 跟踪器中创建一个新 issue。这些 issues 已准备好交由 AFK Agent 处理,除非另有指示,否则请添加正确的 triage 标签。
按依赖顺序发布 issues(先发布阻塞项),以便在“阻塞项”字段中引用实际的 issue 标识符。
## 父级引用 issue 跟踪器中的父级 issue(如果源自现有 issue;否则省略此部分)。
要构建的内容
简要描述此垂直切片。描述端到端行为,而不是逐层描述实现方式。
避免使用特定文件路径或代码片段——它们很快就会过时。例外情况:如果原型生成的代码片段比文字说明更准确地表达了某项决策(状态机、reducer、架构、类型结构),请将其内联放在此处,并简要注明它来自原型。精简到能体现关键决策的部分——不需要可运行的演示,只保留重要内容。
验收标准
- 标准 1
- 标准 2
- 标准 3
阻塞项
- 引用阻塞该 issue 的工单(如有)
如果没有阻塞项,则写“无——可立即开始”。
请勿关闭或修改任何父级 issue。