refactoring-patterns

重構模式 (Refactoring Patterns) 技能提供了一套結構化的框架，用於在不改變系統行為的前提下改進現有軟體，解決程式碼異味 (Code Smells)。此技能專為軟體工程師、品質工程師與維護者設計，確保技術債的清理工作是有條理、安全且可驗證的。它核心原則在於重構必須始終由強大的測試套件支援，提倡「紅-綠-重構」(Red-Green-Refactor) 的工作流程，將程式碼演進過程中的風險降至最低。

透過使用此技能，使用者能將複雜或惡化的程式碼轉變為乾淨、模組化且高效的實作。它提供識別常見程式碼異味的指引（如過長的方法、過大的類別、嵌套條件式），並將其映射至經過驗證的重構技術（如提取方法、提取類別、引入參數物件、以 Pipeline 取代迴圈）。此方法優先採用小規模、漸進式的變更，並確保頻繁提交，以確保每次轉換都維持測試的完整性。

• 自動識別與解決程式碼異味：過長方法、大型類別、魔法數字、重複程式碼。

• 強制執行「三次法則」(Rule of Three) 以防止過早抽象化與不必要的程式碼複雜度。

• 與 QE 代理 (qe-code-reviewer, qe-quality-analyzer, qe-test-refactorer) 整合，針對現有測試套件驗證程式碼變更。

• 安全優先的生命週期管理：確保測試通過、進行小幅度變更、執行測試、提交進度、循環執行。

• 提供常見重構模式的最佳實踐文件：提取方法、以多型取代條件式、Pipeline 重構。

• 防範反模式：消除與「大爆炸」式重寫、缺乏測試下重構以及完美主義過度工程相關的風險。

• 當清理遺留系統、減少技術債或在功能開發期間改進程式碼可維護性時，應使用此技能。

• 嚴禁在沒有測試的情況下使用此技能；若測試覆蓋率不足，使用者必須先編寫測試。

• 非常適合搭配 Jest, Vitest, Playwright 或標準 CI/CD 測試執行器使用，以確保高信心的重構。

• 典型輸出包含更乾淨的程式碼結構、降低環路複雜度、提升可讀性，以及為未來功能開發提供更高的信心水準。

• 使用者應透過定義的記憶體命名空間 (aqe/refactoring/) 監控重構歷史，以追蹤模式與建議。