grill-with-docs skill 是什麼、怎麼用：邊拷問方案邊寫術語表和 ADR 的 Matt Pocock Skill

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

這個 Skill 做什麼

一場高質素的方案討論結束後，結論往往只留在聊天記錄裏，下一個會話的智能體什麼都不知道。grill-with-docs 解決的是「討論完要留下東西」。description：對計劃或設計做一場不依不饒的訪談，並在過程中產出文檔——ADR（架構決策記錄）和術語表。它只能手動調用。

技能本身只有一句話：同時調用 grilling 和 domain-modeling 兩個技能。前者負責問——把方案當成一棵設計樹，一輪一輪地問當前能問的所有問題，每題附推薦答案；後者負責記——它要求在設計過程中主動打磨項目的領域模型：發現你用的詞和術語表裏的定義衝突時當場指出，把含糊的說法逼成精確的術語，編造邊界場景來檢驗概念，和代碼裏的實際命名對照，術語一旦敲定就立刻寫進 GLOSSARY.md；至於 ADR，說明裏的態度是「謹慎地提議」，只有真正值得記錄的決定才寫。

怎麼安裝

grill-with-docs 隨 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）》。

怎麼用

• /grill-with-docs 後跟要討論的功能：「給訂閱加一個暫停功能」。它會先讀已有的 GLOSSARY.md 和 ADR，再開始追問。
• 討論中你說「暫停的訂閱算不算活躍用戶？」這類問題時，它會要求先把「活躍」的定義定下來並記入術語表。
• 結束後倉庫裏會多出或更新術語表與決策記錄，接下來可以用 to-spec 把討論整理成需求。

適合誰 / 侷限

適合多人長期維護、術語容易各說各話的項目，以及希望智能體在後續會話裏沿用同一套詞彙的團隊。對一次性腳本和小項目來說偏重；它會往倉庫裏寫文檔，團隊如果已有自己的文檔規範，需要先告訴它格式和位置（setup-matt-pocock-skills 會問文檔存放處）。

注意事項

• 許可：MIT。
• 會新增或修改倉庫文件：術語表和 ADR，提交前自己讀一遍。
• 依賴同庫的其他技能：單獨只裝這一個不能工作，至少要有 grilling 和 domain-modeling。