to-spec skill 是什麼、怎麼用：把當前對話整理成需求規格並發布到 issue 跟蹤器的 Matt Pocock Skill

本文根據 mattpocock/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 64.2 萬次；所在倉庫 mattpocock/skills 在 GitHub 約 28.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

和智能體聊了半小時，方案基本清楚了，但「清楚」只存在於這次對話裏。to-spec 把它落成文。description：把當前對話變成一份規格並發布到項目的 issue 跟蹤器——不做訪談，只綜合你們已經討論過的內容。它只能手動調用。

說明裏第一句就強調：不要再向用戶提問，把已知的東西綜合起來即可（提問是 grill-me 那一步的事）。它需要事先知道 issue 跟蹤器和標籤約定，沒有的話會提示你先運行 /setup-matt-pocock-skills。

流程是：先探索倉庫了解現狀，全程使用項目術語表裏的詞彙，並尊重相關的 ADR；然後勾勒打算在哪些接縫上測試這個功能——優先用已有的接縫、盡量選最高層的位置，接縫越少越好，說明裏說理想數量是一個——這一步會和你確認；最後按固定模板寫規格並發布。模板的小節是：問題陳述、解決方案、用戶故事、實現決定、測試決定、不在範圍內的事項、補充說明。

怎麼安裝

to-spec 隨 mattpocock/skills 整套安裝。Claude Code 用插件（命令來自倉庫 README）：

text
claude plugin install mattpocock-skills@claude-plugins-official

Codex 先 codex plugin marketplace add mattpocock/skills 再 codex plugin add mattpocock-skills@mattpocock；Cursor、OpenCode 等用 npx skills@latest add mattpocock/skills，在列表裏勾選需要的技能。README 提醒兩點：插件和 skills.sh 兩種方式每個工具只選一種，否則每個技能會出現兩份；勾選時帶上 setup-matt-pocock-skills，並在每個倉庫裏先運行一次，它會問你用哪個 issue 跟蹤器、分診用哪些標籤、文檔存在哪裏——庫裏不少技能依賴這份配置，也會互相調用。

倉庫整體介紹和其他安裝方式，詳見本站《mattpocock/skills 是什麼、怎麼安裝：Matt Pocock 的工程師 Skills（grill-me、tdd、to-spec）》。

怎麼用

• 討論結束後輸入 /to-spec，它會給出測試接縫的設想讓你確認，然後在跟蹤器裏創建一條規格 issue。
• 典型鏈路：/grill-with-docs 把方案問清 → /to-spec 落成規格 → /to-tickets 拆成任務。
• 用本地文件當跟蹤器時，規格會寫成倉庫裏的文件（位置取決於你在 setup 時的回答）。

適合誰 / 侷限

適合習慣先聊透再動手、並且用 issue 管理工作的開發者和小團隊。它只綜合對話裏已有的內容：討論本身有漏洞，規格也會有同樣的漏洞；它對「測試接縫」的強調帶着作者的工程觀點，不寫自動化測試的項目會覺得這部分多餘。

注意事項

• 許可：MIT。
• 會向 issue 跟蹤器寫入內容（對團隊可見），需要本機已配置好對應的命令行工具或集成。
• 流程裏明確要求和你確認的是測試接縫；規格全文建議發佈後立即通讀，有出入及時改。