domain-modeling skill 是什麼、怎麼用：讓智能體維護項目術語表（GLOSSARY.md）和 ADR 的 Matt Pocock Skill

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

這個 Skill 做什麼

同一個東西，產品叫「工作區」，後端表名叫 team，前端組件叫 org——人還能靠默契溝通，智能體讀到這種代碼庫就會不斷誤解。domain-modeling 讓智能體承擔起「把詞說準」的職責。description：構建並打磨項目的領域模型；在討論代碼庫術語、編寫或修改 GLOSSARY.md、記錄或修改 ADR 時使用。

說明裏先劃了一條界線：僅僅讀術語表來獲取詞彙不算這個技能——那是任何技能都該有的一行習慣；這個技能是在你改變模型時用的，是主動的功夫。它規定了設計會話中的幾個動作：

• 對照術語表提出質疑：你的說法和已有定義衝突時當場指出；
• 把含糊的語言磨尖：逼着把「大概是用戶」變成確切的術語；
• 討論具體場景：構造邊界情況來檢驗概念是否站得住；
• 與代碼交叉核對：看實際命名是否與術語一致；
• 即時更新 GLOSSARY.md：術語一敲定就寫，不留到最後；
• 謹慎地提議 ADR：只在決定確實值得記錄時才寫。

文件結構也有約定：多數倉庫只有一個上下文；如果根目錄存在 GLOSSARY-MAP.md，說明有多個上下文，由它指向各自的位置。文件在需要時才創建。

怎麼安裝

domain-modeling 隨 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）》。

怎麼用

• 「我們一會兒說會員、一會兒說訂閱用戶，幫我把這塊的術語理清楚」。
• 討論新功能時它會自動介入：「你說的『項目』和術語表裏的 Project 是一回事嗎？」
• 「把剛才決定用事件溯源的理由記成一條 ADR」。

目錄裏有 GLOSSARY-FORMAT.md 和 ADR-FORMAT.md 兩份格式說明。

適合誰 / 侷限

適合業務概念多、多人協作、並且長期讓智能體參與開發的項目——術語表寫好後，後續每個會話都受益。小工具和腳本用不上；它會在討論中頻繁「打斷」你較真用詞，趕進度時可能覺得煩；術語表需要人來把關，它記下的定義錯了，後面會一路錯下去。

注意事項

• 許可：MIT。
• 會新增或修改倉庫裏的 Markdown 文件，不執行腳本。
• grill-with-docs、to-spec、to-tickets 等技能都會用到它維護的詞彙。