to-issues

to-issues 技能概览

to-issues 的作用

to-issues 会把计划、规格说明或 PRD 拆成可以逐个推进的 issue-tracker 任务。to-issues 技能专为 tracer-bullet 式的垂直切片设计，因此每个 issue 都应该代表一条薄而完整的端到端路径，而不是某一层的大块横向工作。

适合谁用

如果你需要的是真正可以直接执行的实现任务，尤其是产品开发、重构、迁移或功能交付，to-issues 很适合。它尤其适用于你希望 issue tracker 真实反映执行顺序、依赖关系和负责人，而不是只堆出一个松散待办池的场景。

它和其他方式有什么不同

to-issues 的核心价值在于它对“切片”的纪律性：它更偏好可以独立领取的 issue，并且在相关时会跨越 schema、API、UI 和 tests。它还会区分 AFK 切片和 HITL 切片，这能帮助你把可合并的工作和需要人工审核或决策的事项分开。

如何使用 to-issues 技能

安装与配置

使用 npx skills add mattpocock/skills --skill to-issues 安装 to-issues 技能。在使用之前，先确认你的 issue tracker、labels 和 triage 术语已经对 agent 可用；这个技能默认这些前置条件已经存在，并明确提示如果没有，可能需要先运行 /setup-matt-pocock-skills。

提供正确的输入

要获得最佳的 to-issues usage，请提供你希望拆解的源材料：简短计划、spec、PRD，或者带评论的链接 issue。若你引用的是已有 ticket，请附上 issue number、URL 或路径，这样 agent 就能抓取完整正文和评论，而不是只根据标题猜。

建议工作流

先从当前对话上下文出发，再让技能补齐缺失信息，必要时检查代码库，然后生成 tracer-bullet 切片。一个好的 to-issues guide 做法，是要求输出的 issues 满足以下条件：

• 范围窄，但端到端完整
• 使用项目自己的术语命名
• 按真实依赖关系排序，而不是按文件结构排序
• 可在无需人工输入时标记为 AFK

先读哪些文件和线索

在评估或扩展 to-issues 时，先看 SKILL.md，因为当前仓库并没有配套的 README.md、AGENTS.md 或辅助规则文件。真正有用的信号在流程说明和垂直切片规则里，所以应重点看过程部分，而不是去找隐藏脚本或额外配置。

to-issues 技能 FAQ

to-issues 只用于 Issue Tracking 吗？

大体上是的。to-issues 明确面向 issue tracking 和工作拆分，不适合泛泛头脑风暴或写路线图。如果你需要的是 release notes、架构文档，或者不打算放进 issue tracker 的任务清单，通用提示词可能更合适。

使用前我应该提供什么？

最好的输入是：清晰的计划、当前代码库上下文，以及任何重要的 tracker 规范，比如 labels 或 triage 规则。没有这些，to-issues 也能拆出 issues，但标题质量会更弱，顺序准确性也会下降，还更容易出现范围不匹配。

对新手友好吗？

可以，只要你能把工作描述清楚。这个技能负责把更大的目标转成可执行的切片；但新手仍然会因为提供一个具体目标，并要求使用项目自己的术语来输出 issues，而受益很多。

什么时候不该用？

如果你只需要一个快速 todo list，或者工作本身太模糊、没法切片，或者根本没有 issue tracker，就不要用 to-issues。如果你想要的是一张大 ticket，而不是多个可独立交付的 issue，它也不合适。

如何改进 to-issues 技能

提供更强的源材料

提升 to-issues 结果的最好方式，是给它一份清晰的事实来源：PRD 的某一段、设计说明，或者你希望拆解的那张确切 issue。还要把会影响实现的约束写清楚，比如发布要求、应用内受影响的区域，或者工作必须遵守的 ADR。

要求切片质量，而不只是数量

一个常见失败模式，是产出过宽、过层级化，或者彼此过度依赖的 tickets。你可以明确要求 to-issues 输出优先考虑端到端切片、让每个 ticket 都能被演示，并把 AFK 工作和 HITL 决策分开，这样队列才会保持可执行。

迭代标题、范围和顺序

第一轮之后，调整 issue 标题，让它们更贴合团队术语，并收紧那些仍然显得过于横向的 ticket。如果拆分结果已经接近目标但还不够准确，可以要求重写：调整依赖顺序、拆分有风险的切片，或把 acceptance criteria 写得更具体，以适配你使用的 tracker。