py-patterns

Installation
SKILL.md

Python 設計模式與架構邊界

目標與邊界

用此 skill 將業務規則、I/O、framework 與第三方服務分離,使系統可測試、可替換且容易理解。

預設從函式、模組與 composition 開始。只有在存在真實變化點、生命週期、transaction 或依賴反轉需求時才引入 pattern。小型程式不需要為了「架構完整」建立大量抽象類別。

執行流程

  1. 描述痛點:耦合、重複條件、難以測試、跨層 transaction、第三方 API 漂移或狀態混亂。
  2. 畫出依賴方向:domain 應依賴什麼抽象,I/O/framework 實作位於哪一層。
  3. 找出變化軸:策略、provider、storage、format、workflow state 或 side effect。
  4. 先建立最小 seam:函式參數、Protocol 或小型 adapter,避免一次重寫全專案。
  5. 把 lifecycle 放在組合根:client、pool、repository 與 service 在 app startup/command handler 組裝。
  6. 定義 transaction 與錯誤邊界:commit/rollback 由 use case 管理,不讓 repository 偷偷決定。
  7. 用測試驗證替換性:domain 使用 fake/in-memory implementation,adapter 有 contract test。
  8. 移除無價值抽象:若只有一個實作且沒有測試/邊界需求,保留簡單設計。
Installs
2
GitHub Stars
1
First Seen
May 8, 2026