to-spec

技能简介

to-spec 能将当前对话中的讨论内容自动转化为一份结构化规格说明（Spec），并发布到项目的 issue 追踪器。它无需额外访谈，直接综合对话中已产生的共识和代码库理解，快速产出可供 Agent 执行的 spec，并自动打好 triage 标签。

使用场景

• 在对话中完成功能讨论后，想立即生成一份规范 spec 并提交到 issue tracker。
• 需要将零散的需求讨论整理为包含用户故事、实现决策、测试决策的完整文档。
• 希望 spec 遵循项目领域词汇、ADR 和现有测试接缝，便于后续开发。
• 需要为 Agent 准备带有 ready-for-agent 标签的待办 issue。
• 在完成代码库探索后，快速沉淀实现与测试方案。

使用方法

本技能依赖预先配置的 issue tracker 和 triage 标签词汇。如果未配置，请先运行：

/setup-matt-pocock-skills

在对话中直接启用技能后，它会自动执行：

1. 探索代码库（如尚未探索），使用项目领域词典中的术语，并遵守相关 ADR。
2. 设计测试接缝——优先复用现有接缝，选择最高层级的接缝，理想数量为一个；并与你确认这些接缝是否符合预期。
3. 按照标准模板生成 spec，发布到项目 issue tracker，同时应用 ready-for-agent 标签，无需额外 triage。

注意事项

• 不要访谈用户，只综合对话中已经讨论过的内容。
• Implementation Decisions 部分不要包含具体文件路径或完整代码片段；除非某段原型代码比文字更能表达决策，且需注明来自原型并精简到关键部分。
• 测试接缝需先与用户确认，再发布 spec。
• 用户故事列表应尽量详尽，覆盖功能的各个方面。