py-patterns
Installation
SKILL.md
Python 設計模式與架構邊界
目標與邊界
用此 skill 將業務規則、I/O、framework 與第三方服務分離,使系統可測試、可替換且容易理解。
預設從函式、模組與 composition 開始。只有在存在真實變化點、生命週期、transaction 或依賴反轉需求時才引入 pattern。小型程式不需要為了「架構完整」建立大量抽象類別。
執行流程
- 描述痛點:耦合、重複條件、難以測試、跨層 transaction、第三方 API 漂移或狀態混亂。
- 畫出依賴方向:domain 應依賴什麼抽象,I/O/framework 實作位於哪一層。
- 找出變化軸:策略、provider、storage、format、workflow state 或 side effect。
- 先建立最小 seam:函式參數、Protocol 或小型 adapter,避免一次重寫全專案。
- 把 lifecycle 放在組合根:client、pool、repository 與 service 在 app startup/command handler 組裝。
- 定義 transaction 與錯誤邊界:commit/rollback 由 use case 管理,不讓 repository 偷偷決定。
- 用測試驗證替換性:domain 使用 fake/in-memory implementation,adapter 有 contract test。
- 移除無價值抽象:若只有一個實作且沒有測試/邊界需求,保留簡單設計。