一句话

把当前会话综合成一份 spec 发到 issue tracker：不访谈只记录已定决定，并在写码前先约定测试 seam。

何时用

• 适合：决定已经做完、工程跨多个会话要拆；matt-wayfinder 地图清完时用 /to-spec #<map_issue> 收敛它。
• 不适合：还没决定（先 matt-grill-with-docs）；一个窗口装得下的活（直接 matt-implement，跳过 spec）。

怎么用

/to-spec 把刚才讨论的方案写成 spec

1. 探查 repo 现状，全程用 GLOSSARY.md 词汇，尊重相关 ADR。
2. 先草拟测试 seam：优先现有 seam，尽量取最高层（理想数量是一个），和用户确认后再写。
3. 按模板写 spec：Problem Statement、Solution、User Stories（编号长列表）、Implementation Decisions、Testing Decisions、Out of Scope、Further Notes。
4. 发到 issue tracker，打 ready-for-agent 标签，不用再走 triage。

产出

• tracker 上一份 spec issue，含约定的测试 seam。

要点与坑

• spec 是决策记录不是做新决定的地方；没在会话里定下来的东西它不会替你问。
• Implementation Decisions 不写具体文件路径和代码片段（易过期）；例外是 prototype 里比散文更精确编码决策的片段，裁到关键部分内联并注明来源。
• seam 约定先于写码，是 matt-tdd 和 matt-code-review 共同的对齐点。

关联

• 上游：matt-grill-with-docs、matt-wayfinder · 下游：matt-to-tickets · 同类：addy-spec-driven-development
• 所属：00-matt-概览 · 工作流：W3-多会话功能、W4-大型模糊项目