to-spec

1这个 skill 使用当前 conversation context 和 codebase understanding 产出 spec。**不要**访谈用户，只综合你已经知道的内容。
2 
3Issue tracker 和 triage label vocabulary 应该已经提供给你；如果没有，请让用户运行 `/setup-matt-pocock-skills`。
4 
5## 流程
6 
71. 如果还没有探索 repo，先探索它以理解 codebase 当前状态。在 spec 中始终使用项目 domain glossary vocabulary，并遵守相关 ADRs。
8 
92. 草拟你准备在哪些 seams 上测试这个 feature。优先使用现有 seams，而不是新增 seams。使用尽可能高层的 seam。如果确实需要新增 seams，尽可能在最高层提出。
10 
11Seams 越少越好，理想数量是一个。与用户确认这些 seams 是否符合预期。
12 
133. 使用下面模板写 spec，并发布到项目 issue tracker。应用 `ready-for-agent` triage label；不需要额外 triage。
14 
15<spec-template>
16 
17## Problem Statement
18 
19用户正在面对的问题，从用户视角描述。
20 
21## Solution
22 
23问题的解决方案，从用户视角描述。
24 
25## User Stories
26 
27一份很长的编号 user stories 列表。每条 user story 使用以下格式：
28 
291. As an <actor>, I want a <feature>, so that <benefit>
30 
31<user-story-example>
321. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
33</user-story-example>
34 
35这份 user stories 列表应该非常完整，覆盖 feature 的所有方面。
36 
37## Implementation Decisions
38 
39已作出的 implementation decisions 列表。可以包括：
40 
41- 将 build/modify 的 modules
42- 将 modify 的 module interfaces
43- 来自 developer 的技术澄清
44- Architectural decisions
45- Schema changes
46- API contracts
47- Specific interactions
48 
49不要包含具体 file paths 或 code snippets。它们可能很快过时。
50 
51例外：如果 prototype 产出的 snippet 比 prose 更精确地编码了某个决策（state machine、reducer、schema、type shape），可以内联到相关 decision 中，并简短说明它来自 prototype。只保留决策密集部分，不要放完整 working demo。
52 
53## Testing Decisions
54 
55已作出的 testing decisions 列表。包括：
56 
57- 什么是好测试的描述（只测试 external behavior，不测试 implementation details）
58…