📊 页面导航

适用角色与上手难度

🎯 学习产出： 掌握规格合成流程，能把对话成果转化为结构完整、可交付的规格文档

🚀 AI 能力提升： 需求规格化

/to-spec

预计阅读时间: 3 分钟

对话合成规格。把当前对话上下文和代码库理解直接合成为规格并发布到项目 issue 追踪器。不访谈用户——只综合已经讨论过的内容。

概述

在 /grill-with-docs 把想法磨尖之后，/to-spec 把访谈成果凝固成可执行的规格。它假定追踪器和 triage 标签词汇已经配置好（否则提示运行 /setup-matt-pocock-skills）。

/to-spec

探索代码库（若还没做）：理解当前状态，规格全程使用领域词汇表词汇，尊重改动区域的 ADR
勾画测试接缝：先画要在哪里测试这个功能。优先现有接缝，用尽可能高的接缝；需要新接缝就提议在能放到的最高点。全库接缝越少越好——理想数量是一个。与用户确认接缝符合预期
写规格并发布：按模板写，发布到 issue 追踪器，打上 ready-for-agent 标签——无需额外 triage

章节	内容
Problem Statement	用户面临的问题，从用户视角
Solution	解决方案，从用户视角
User Stories	极长的编号列表："作为X，我想要Y，以便Z"（如"作为手机银行客户，我想看到账户余额，以便更好地决定支出"）
Implementation Decisions	模块/接口/架构决策/API 契约/交互方式。不写文件路径和代码片段——它们很快过时
Testing Decisions	什么构成好测试（只测外部行为）、测哪些模块、测试的先例
Out of Scope	本次规格明确不做的事
Further Notes	其它备注

原型例外

如果原型产生了比文字更精确的决策载体（状态机、reducer、schema、类型形状），可以内联进对应决策并注明来自原型。只保留决策密集的部分，不是工作演示。