codebase-design skill 是什麼、怎麼用：Matt Pocock 的「深模組」設計詞彙 Skill（接口、接縫、可測試性）

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

這個 Skill 做什麼

讓智能體「把這塊代碼設計得好一點」，它會給出一堆聽着都對的泛泛之談。codebase-design 的做法是先統一語言。description：設計深模組的共享詞彙；用戶想設計或改進模組接口、尋找加深機會、決定接縫放在哪裏、讓代碼更易測試或更便於 AI 導航時使用，其他技能需要這套詞彙時也會調用它。

核心主張是設計深模組：小接口背後有大量行為，放在乾淨的接縫上，可以通過這個接口來測試。目標是三樣——給調用方槓桿，給維護者局部性，給所有人可測試性。

技能的主體是一份術語表，並要求「嚴格使用這些詞」，不要換成組件、服務、API、邊界之類的近義詞，理由是一致的語言正是全部意義所在。例如：

• 模組：任何有接口和實現的東西，刻意不限定規模——函數、類、包，或跨層的一個切片；
• 接口：調用方為了正確使用模組必須知道的一切，不只是類型簽名，還包括不變量、調用順序約束、錯誤模式、必需的配置和性能特徵。

後面還有深與淺的對比、幾條原則（同庫其他技能引用過其中的「刪除測試」「接口就是測試面」「一個適配器只是假想的接縫，兩個才是真的」）、為可測試性而設計、被否定的幾種說法。

怎麼安裝

codebase-design 隨 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）》。

怎麼用

• 「幫我設計通知模組的接口，按深模組的思路」。
• 「這個 service 層是不是太淺了？用 codebase-design 的標準評一下」。
• 多數時候它是被 improve-codebase-architecture 等技能間接調用的。

目錄裏另有 DEEPENING.md（如何加深模組）和 DESIGN-IT-TWICE.md（把接口設計兩遍再選）兩份延伸資料。

適合誰 / 侷限

適合認同「深模組」這一路設計思想、希望智能體的設計建議更有章法的工程師，也適合當作團隊討論架構時的共同詞彙。它是一種設計立場而非客觀標準，和團隊現有的分層規範衝突時需要取捨；純詞彙與原則，不會自己去改代碼。

注意事項

• 許可：MIT。
• 不執行腳本、不改文件：參考型技能，可由模型自動觸發。
• 術語是英文定義的，中文討論時建議保留英文原詞以免歧義。