refactoring-patterns

refactoring-patterns 技能為軟體代理程式提供了一套嚴謹的框架，用於在不引入錯誤的情況下提升程式碼品質。此技能專為開發人員與品質工程師設計，強調以測試為先的技術債減少策略。它指導代理程式執行識別程式碼異味、提出結構改善建議，並驗證系統在轉換前後的輸出保持一致。透過嚴格執行「三次法則 (Rule of Three)」並確保測試保持通過，此技能能防止過早抽象化與大規模重寫的常見陷阱，傾向採用能降低複雜程式庫風險的小型增量步驟。

• 自動識別如過長函式、龐大類別與過深巢狀結構等程式碼異味。

• 支援標準重構模式，包括 Extract Method、Extract Class、Introduce Parameter Object、Decompose Conditional 與 Replace Loop with Pipeline。

• 與測試執行代理程式整合，為每個原子變更提供安全網。

• 與艦隊級代理程式（如 qe-quality-analyzer 與 qe-test-refactorer）協同作業，實現 TDD 風格的重構週期。

• 透過專用的記憶體命名空間管理技術債，追蹤異味、建議與驗證記錄。

• 在開始任何重構任務前，務必確保存在完整的測試套件；若缺乏測試，請優先處理測試生成。

• 針對每個獨立的重構步驟使用原子化的 Git 提交，以簡化潛在的還原需求。

• 避免重構穩定、邏輯明確或接近關鍵專案期限的程式碼。

• 預期輸入包含待清理的程式庫、模組或特定函式；輸出由重構後的程式碼區塊以及來自 Jest、Vitest 或 pytest 等測試套件的驗證報告組成。

• 此技能嚴格禁止在重構期間進行任何行為變更、僅針對效能的調整或新增功能。