Community程式設計與開發github.com

設計模式 (Design Patterns)

選擇、實作、重構以及審查 22 種經典的 GoF (Gang of Four) 設計模式。適用於設計問題需要成熟結構的情境,例如物件建立、介面適配、組合、樹狀結構、走訪、狀態依賴行為、解耦、復原、存取控制、記憶體壓力等。

設計模式 (Design Patterns) 是什麼?

這個技能是一個完整的指南,涵蓋了 22 種 GoF 設計模式,主要參考自《深入淺出設計模式》(Dive Into Design Patterns)。它的核心功能分為三部分:第一,協助開發者根據特定「症狀」選擇最合適的模式;第二,指導如何在實作或重構時無痛套用模式;第三,用於審查現有程式碼,找出缺失的結構或(更常見的)過度套用的模式。此技能是語言中立的,重點是將模式的角色和步驟映射到當前專案的程式碼習慣用法,而不是直接照搬 Java 的寫法。它支援多種 Agent 平台,例如 Claude Code、Cursor 和 Codex,可以放置在專案本地的 `.opencode/skills/` 或使用者全域的 `~/.config/opencode/skills/` 目錄下。技能文件本身提供了決策樹、症狀對照表以及頭對頭的模式比較,幫助開發者在 Factory Method vs Abstract Factory 或 Strategy vs State 等相似模式之間做出精確的選擇。它也強調了使用模式的「基本規則」,例如在套用模式前必須通過三個測試,並優先選擇最簡單的有效結構。總之,這個技能不僅是一個目錄,更是一套實用的決策框架,幫助開發者在正確的時機使用正確的設計模式,避免過度工程。

相容平台✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/libkluid/.skills/tree/main/skills/design-patterns

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設計模式 (Design Patterns) 是做什麼的?

一份實用的 22 種 GoF(Gang of Four)模式指南,以《深入淺出設計模式》(Alexander Shvets, 2022)為框架。涵蓋三項任務:

  1. 選擇 — 將一個症狀轉化為一個候選清單,然後提出單一建議。
  2. 實作 / 重構 — 在不破壞行為的前提下套用模式。
  3. 審查 / 診斷 — 找出缺少的結構,以及更常見的:過度套用的結構。

這個目錄刻意保持語言中立。將角色和步驟映射到你面前程式碼庫的習慣用法;不要直接照搬 Java。

可攜性

此技能在目錄層級是自包含的。僅複製 SKILL.md 檔案就足夠了。

  • 專案本機:<repo>/.opencode/skills/design-patterns/SKILL.md
  • 使用者全域:~/.config/opencode/skills/design-patterns/SKILL.md
  • 相容位置:在 <repo>/.claude/skills/ 或 ~/.agents/skills/ 下的相同結構
  • 技能的 ID 是目錄名稱 (design-patterns);前言中的 name 僅作為顯示標籤。

何時使用此技能

  • 一個變更不斷波及到不相關的類別,或一個類別不斷為每個新情況增加分支。
  • 物件建構已變成參數、旗標或工廠的圍牆。
  • 整合一個與你的介面不符的第三方或舊有 API。
  • 以組合方式(壓縮 + 加密 + 重試 + 日誌)加入行為,這將會導致子類別層級爆炸。
  • 行為依賴於生命週期:草稿 → 審查 → 已發布,連線中 → 已連線 → 已關閉,待處理 → 已付款 → 已出貨。
  • 一個變更必須通知一個未知或變動中的消費者集合。
  • 操作、復原、排隊工作或可重播的動作需要變成物件。
  • 需要在樹狀或物件圖上加入走訪、匯出或分析功能。
  • 記憶體壓力來自於許多幾乎相同的物件。
  • 審查設計是否遭遇義大利麵式耦合或投機式抽象。

何時不該使用此技能

  • 指令碼、一次性遷移或原型,其中結構的成本超過了其生命週期。
  • 加入模式的唯一理由是「最佳實踐」、一本書或一個 lint 工具。
  • 你無法說出具體的變更是該結構預期要吸收的。
  • 該語言已經直接提供了該行為(迭代器、事件、模式匹配、依賴注入、閉包)。
  • 團隊無法維護這種間接性。一個能被理解的較簡單設計,勝過一個正確但無人理解的模式。

基本規則

  1. 模式是對已浮現結構的命名,而非目標。 推薦該結構;僅在解釋時使用模式名稱。
  2. 套用模式前進行三項測試。 (a) 存在具體的當下力量或症狀,而非假設性的。 (b) 現在或預計至少存在兩個合理的變體。 (c) 所增加的間接性在接下來幾次變更內就能回本。
  3. 優先選擇能工作的最小結構: 內聯程式碼 → 函式 → 參數化函式 → 介面 + 一個實作 → 介面 + 多個實作 → 完整模式。
  4. 審查時切勿在沒有證據的情況下加入模式。 引用證明了其合理性的重複、分支數量、依賴邊緣或量測到的成本。
  5. 以領域名稱命名角色,而非模式名稱。 ShippingPolicy 優於 ShippingStrategy;DocumentPublisher 優於 DocumentObserverSubject,除非模式本身是共通的詞彙。
  6. 刪除舊的路徑。 作為第二條平行路徑套用模式,卻沒有移除計劃,這只是繞了一圈的技術債。
  7. 模式可組合。 大多數真實設計都是一個模式內部包含另一個模式(Composite + Visitor, Command + Memento, Mediator + Observer)。先選擇主要力量;讓協作者跟隨。

0. 首先建立上下文

在回答這些問題之前,不要推薦任何模式。當程式碼無法回答它們時,請提問。

  • 語言與範式。 繼承密集型、基於介面、函數式或混合型?是否擁有一級函式、和類型、模式匹配、生成器、事件、DI?
  • 變更軸。 實際變化的是哪個維度:建立、演算法、結構、通訊、生命週期、儲存或傳輸?
  • 變體數量。 今天存在多少個實作?預計有多少個?(「現在一個,下個季度一個」是合理的答案。)
  • 生命週期與所有權。 誰來建立、擁有、快取和處置物件?是否有組合根或 DI 容器?
  • 並發。 實例是否跨執行緒共享?通知是否同步?指令是否排隊?
  • 持久性與分佈。 物件或事件是否必須序列化、版本化、重試或透過網路發送?
  • 效能預算。 記憶體、延遲或分配率是否已被量測和限制?
  • 測試策略。 能否在沒有真實資料庫、時鐘、檔案系統或網路的情況下測試設計?
  • 團隊慣例。 程式碼庫是否已使用模式詞彙、框架擴展點或架構邊界?

記錄答案。沒有此上下文的建議只是猜測。


1. 選擇模式

1.1 症狀 → 候選

症狀首要候選考慮替代方案
new 散落在業務邏輯中;由配置決定類型Factory MethodDI 容器、簡單工廠函式
多個相關產品必須匹配(相同主題、驅動程式、供應商)Abstract Factory每個產品使用 Factory Method、參數化工廠
建構子有許多可選參數或旗標引數Builder具名/可選參數、record + 驗證
複製物件需要知道其具體類別或私有欄位Prototype複製建構子、序列化往返
一個共享資源需要恰好一個實例和全域存取Singleton容器範圍的 singleton、模組層級實例、顯式注入
第三方/舊有介面不匹配Adapter變更你的介面、防腐層
兩個獨立維度造成子類別倍增(形狀 × 顏色、裝置 × OS)Bridge拆分為兩個參數、組合
部分-整體樹必須被統一處理Composite對資料模型進行單純的遞迴函式
行為組合導致子類別爆炸(透過 email + SMS + Slack 通知)Decorator旗標、中介軟體鏈、策略清單
用戶端淹沒在一個多類別子系統中Facade縮小模組 API、服務層
數百萬個相似物件耗盡記憶體Flyweight實習、結構體陣列、惰性資料
存取、惰性載入、快取或遠端呼叫必須是透明的Proxy顯式快取層、儲存庫、用戶端包裝器
一個請求可能由數個處理者之一處理,順序未知Chain of Responsibility中介軟體管線、有序函式清單
動作必須排隊、重試、記錄、復原或參數化Command閉包、工作佇列負載、事件溯源
走訪必須是統一且獨立於表示的Iterator語言迭代器/生成器
許多元件與許多元件通訊;無法實現可重用元件Mediator事件匯流排、應用服務、Observer
復原/回滾必須在不暴露內部結構的情況下恢復狀態Memento事件日誌、資料庫交易、寫入時複製快照
一個變更必須通知動態的消費者集合Observer訊息代理、反應式串流、訊號
大型 switch 判斷狀態;轉換散落各處State狀態機函式庫、轉換表、和類型
一項任務有多種演算法;在執行時期/配置時選擇Strategy函式參數、表格查詢、多型
相同演算法骨架,少數步驟不同Template MethodStrategy/組合、高階函式、鉤子
對穩定的物件結構進行許多不相關的操作Visitor模式匹配、外部函式、序列化器
對樹進行聚合操作Composite + Visitor遞迴摺疊、查詢 API

1.2 限制條件過濾器

在決勝局之前套用這些。它們能消除的模式錯誤選擇比任何模式比較都多。

  • 靜態 vs 動態變更。 Strategy, State, Bridge 和 Proxy 允許執行時期替換。Template Method 和基於繼承的 Factory Method 在編譯時期固定行為。
  • 單一物件 vs 一組物件。 Factory Method 建立一個產品;Abstract Factory 建立一個相容的產品族;Builder 逐步組裝一個複雜產品。
  • 包裝 vs 替換 vs 簡化。 Decorator 保留介面並增加行為;Proxy 保留介面並控制存取;Adapter 變更介面;Facade 定義一個新的、更簡單的介面來封裝多個物件。
  • 推送 vs 拉取 vs 路由。 Observer 廣播給所有訂閱者;Mediator 透過一個協調者路由互動;Chain of Responsibility 傳遞請求直到有人處理。
  • 狀態 vs 演算法。 State 物件彼此認識並觸發轉換;Strategy 物件是獨立的,由客戶端選擇。
  • 結構 vs 操作。 Composite 組織物件;Visitor 在該組織之上增加操作;Iterator 提供走訪方式。
  • 記憶體 vs CPU。 Flyweight 以 CPU 和複雜性換取 RAM;Proxy 快取以新鮮度和延遲換取重複工作。
  • 處理邊界。 遠端 Proxy、Command 序列化和跨程序的 Observer 會增加錯誤模式(重試、排序、冪等性),而進程內模式則沒有。

1.3 對比決勝局

配對選擇前者當選擇後者當
Factory Method / Abstract Factory單一產品類型;子類別或配置選擇具體類別必須建立多個相關產品並保持相容
Abstract Factory / Builder產品立即作為一個產品族返回一個複雜產品逐步組裝並在最後返回
Factory Method / Builder變化在於 建立哪個類別變化在於 如何配置一個複雜物件
Builder / Prototype建構必須逐步驗證一個完全配置的物件已存在,應該被複製
Adapter / Bridge事後改造不相容的程式碼預先設計兩個獨立的層次結構
Adapter / Facade必須將一個介面轉換為另一個許多子系統呼叫必須被折疊成一個簡單的 API
Decorator / Proxy在執行時增加或移除責任;客戶端組合包裝器控制存取、生命週期、快取或遠端;代理管理服務
Decorator / Chain of Responsibility每個包裝器都執行並增加行為處理者可能停止鏈
Composite / Decorator目標是帶有統一葉/容器操作的樹目標是節點上的額外責任,而非聚合
Facade / Mediator單向簡化;子系統不知道外觀雙向協調;同事知道並呼叫中介者
Mediator / Observer集中協調邏輯和星狀拓撲一對多廣播,無集中策略
Strategy / State演算法是獨立的;客戶端切換狀態觸發它們自己的轉換並彼此依賴
Strategy / Command問題是 如何 執行一個任務問題是 什麼 請求要執行、儲存或復原
Strategy / Template Method行為透過組合在執行時因物件而異行為透過繼承在編譯時因子類別而異
Chain of Responsibility / Observer恰好一個處理者應該動作所有訂閱者都應被通知
Memento / Command需求是狀態恢復需求是請求封裝、排隊或重播
Memento / Prototype必須保留封裝性且需要歷史記錄簡單物件的簡單複本就足夠
Iterator / Visitor需求是走訪順序和存取需求是跨越多個元素類型的操作
Visitor / Strategy在穩定的元素層次結構上的許多操作一個在上下文上可互換的演算法
Flyweight / Singleton許多由狀態鍵控的不可變共享實例整個進程只有一個可變實例
Composite / Flyweight層次結構和統一操作很重要共享葉節點狀態是記憶體問題

1.4 決策樹

主要力量是什麼?
├─ 建立物件
│  ├─ 哪個具體類別由子類別/配置選擇?        → Factory Method
│  ├─ 多個相關產品必須匹配?                  → Abstract Factory
│  ├─ 一個複雜物件,多個可選部分或步驟?       → Builder
│  └─ 複製一個現有已配置的物件?              → Prototype
│     └─ 真正只有一個共享實例?                → Singleton(最後手段)
├─ 適配或組織結構
│  ├─ 來自你控制範圍外的不相容介面?           → Adapter
│  ├─ 兩個獨立維度導致子類別倍增?             → Bridge
│  ├─ 具有統一操作的部分-整體樹?              → Composite
│  ├─ 在執行時以組合方式增加/移除行為?        → Decorator
│  ├─ 為客戶端簡化複雜的子系統?               → Facade
│  ├─ 記憶體中有太多近乎相同的物件?           → Flyweight
│  └─ 控制存取、生命週期、快取或遠端?         → Proxy
└─ 行為與通訊
   ├─ 數個處理者之一,順序未知?                 → Chain of Responsibility
   ├─ 請求必須是物件:排隊、重試、復原、重播?   → Command
   ├─ 走訪而不暴露表示?                       → Iterator
   ├─ 多對多通訊需要協調者?                    → Mediator
   ├─ 在不破壞封裝的情況下恢復先前狀態?         → Memento
   ├─ 通知動態的訂閱者集合?                    → Observer
   ├─ 行為隨生命週期狀態而改變?                → State
   ├─ 多個可互換的演算法?                       → Strategy
   ├─ 演算法骨架固定,部分步驟可變?             → Template Method
   └─ 對穩定的物件結構進行許多不相關的操作?     → Visitor

2. 實作或重構為模式

2.1 安全套用規則

  1. 單步執行。 一次抽取一個角色、一個職責或一個參考。每次變更後執行測試。
  2. 先內化再抽取。 從阻塞測試通過開始。然後抽取介面、參數,最後是角色物件。
  3. 偏好轉接器而非修改。 當你無法更改目標時,Adapter 模式更好。實作一個新的介面,並將原始物件作為依賴項傳入。
  4. 注入工廠。 不要讓一個類別直接直接 new 一個可設定行為。透過建構子或設定器注入工廠、策略或狀態。
  5. 單向參考。 子節點不應持有父節點的參考。觀察者不應持有主題的參考。如果需要,請求它。

2.2 重構常見的「非模式」

你看到的可能是重構為
if type == "A" 在整個類別中遺失的 Factory Method一個 create 方法和具體的建立者子類別
建構子中有 8 個以上參數,多數為可選遺失的 BuilderBuilder 類別,帶有逐步建構方法
switch (state) 在每個方法中遺失的 State每個狀態一個類別,委派呼叫
if (condition) doA else doB 且條件從外部設定遺失的 StrategyStrategy 介面,建立時注入
類別同時實作 drawCircle、drawSquare、drawTriangle遺失的 Visitor接受一個 Visitor 介面並讓每個訪問者實作形狀
List<Handler> 且一個 for 迴圈呼叫全部Chain 換成了 Observer決定:一個處理者停止嗎?(Chain)還是全部處理?(Observer)
class Logger extends Compressor extends Encryptor extends Retrier遺失的 Decorator一個包裝器的建構子接受一個 Component
CustomerRepository 全是靜態方法,對資料庫進行直接 SQL 查詢過早的最佳化注入資料來源;讓儲存庫實作一個介面
一個 ShapeFactory 使用 if type 返回 Circle、Square、Triangle完全可以;這是一個簡單工廠僅當新形狀意味著修改工廠時才需要 Factory Method

2.3 組合:常見場景

訂單圖案常見用途
Composite 包含 Visitor走訪樹以進行匯出、驗證、渲染
Command 包含 Memento可復原的操作(編輯器、交易)
Mediator 包含 Observer協調者監聽元件;元件不互相認識
Chain of Responsibility 包含 Command中介軟體管線將請求包裝為可重試的工作
Facade 後方有 Abstract Factory外觀建立不同的產品族(測試 vs 正式環境)
Bridge 兩端都有 Strategy平台抽象化,兩端交換演算法

3. 審查與診斷

3.1 缺少模式

掃描程式碼庫尋找上述的「非模式」表格。尋找:

  • 類別因 type 欄位而膨脹。 → 建議使用 Factory Method、Strategy 或 State。
  • 建構子參數超過 6 個。 → 檢查是否可以萃取一個 Builder 或參數物件。
  • if/else 或 switch 鏈比語言基準長。 → 部分可能變成 Strategy 或 State。
  • 一個類別超過 3 個「職責」關鍵字(連線、驗證、記錄、重試)。 → Decorator 或 Chain of Responsibility。
  • 難以測試的靜態方法或 Singleton。 → 注入一個介面。
  • 樹狀走訪與業務邏輯混合。 → Visitor 或 Iterator。

3.2 過度套用的模式(更常見!)

證據可能發生什麼建議
一個介面,一個實作,且第二個實作從未被排程投機式介面合併;僅在使用點注入
AbstractFactory 建立一個在程式碼中各處都成對使用的單一產品抽象過多替換為 Factory Method 或一個簡單工廠函式
Visitor 包含一個方法的 switch,但元素類別從未增加不必要的 Visitor使用多型方法或在元素上使用模式匹配
Observer 附加了一個回呼,該回呼是在同一個類別中處理的回呼像一個 lambda 一樣呼叫它
Singleton 的多個實例(同一程式碼庫中)模式誤用為每個用途注入一個不同的範圍
Decorator 鏈未用於組合;所有包裝器都在每個請求上執行過度工程化的清單使用一個列表並迭代它,或僅內聯
Proxy 除了委派之外不做任何事沒有代理行為刪除;直接使用服務
Command 物件被建立但從未排隊、記錄或復原不必要的封裝直接呼叫方法,除非你需要佇列

3.3 審查的 5 分鐘檢查清單

  • 所有條件分支是否與一個領域概念相對應,該概念目前正在變化?或是為了假設性的未來?
  • 我能否將每個分支或實作命名為業務領域中真正的事物?「生產策略」 vs. 「Stage」 vs. 「開發」是領域名稱。
  • 間接性是否透過減少複製、避免雙重維護或增加可測試性來證明其自身價值?
  • 如果我內聯所有介面並刪除抽象類別,測試會更難寫或程式碼更難修改嗎?
  • 是否存在一個更簡單的語言內建機制(回呼、事件、協程、生成器、特質、型別類別)可以做同樣的事?

4. 模式目錄

每種模式都是一個表格:

部分內容
意圖一句話說明。
適用於症狀和力量。
結構類別/角色。
建議實作語言中立;使用你語言中的對應機制。
範例當前程式碼庫中的具體範例(AI 填入)。
與…比較最接近的替代方案的連結。

4.1 建立型模式(5 種)

模式意圖
Factory Method定義一個用於建立物件的介面,但讓子類別決定要實例化哪個類別。
Abstract Factory提供一個用於建立相關或依賴物件家族的介面,而無需指定它們的具體類別。
Builder將一個複雜物件的建構與其表示分離,使相同的建構過程可以建立不同的表示。
Prototype指定使用原型實例來建立的物件種類,並透過複製這個原型來建立新的物件。
Singleton確保一個類別只有一個實例,並提供一個全域存取點。

4.2 結構型模式(7 種)

模式意圖
Adapter將一個類別的介面轉換為客戶端期望的另一個介面。
Bridge將抽象部分與其實作部分分離,使它們可以獨立地變化。
Composite將物件組合成樹狀結構以表示部分-整體層次結構。
Decorator動態地為一個物件附加額外的職責。
Facade為子系統中的一組介面提供一個統一的簡化介面。
Flyweight透過共享來有效地支援大量細粒度的物件。
Proxy為另一個物件提供一個代理或佔位符以控制對它的存取。

4.3 行為型模式(10 種)

模式意圖
Chain of Responsibility透過給予多個物件處理請求的機會,來避免請求的發送者與接收者之間的耦合。
Command將一個請求封裝為一個物件,從而允許你使用不同的請求、佇列或記錄請求來參數化客戶端。
Iterator提供一種方法順序存取一個聚合物件中的各個元素,而又不暴露其底層表示。
Mediator定義一個封裝一組物件如何互動的物件。
Memento在不違反封裝的情況下捕獲並外部化一個物件的內部狀態,以便稍後可以將物件恢復到此狀態。
Observer定義物件之間的一對多依賴關係,以便當一個物件改變狀態時,所有依賴它的物件都會被自動通知和更新。
State允許一個物件在其內部狀態改變時改變其行為。
Strategy定義一系列演算法,將每個演算法封裝起來,並使它們可以互換。
Template Method在一個方法中定義一個演算法的骨架,並將一些步驟延遲到子類別中。
Visitor表示一個作用於一個物件結構中各個元素的操作。

相關技能