refactoring

重構技能是一個自主的工程助理，旨在維持高品質的程式碼標準。它主要針對與循環複雜度、認知負荷和可維護性指數相關的檢查器（Linter）錯誤進行響應。作為靜態分析工具與簡潔程式碼原則之間的橋樑，該代理系統地處理龐大的函數或混亂的邏輯，以確保程式碼庫保持可讀性、可擴展性和規範性。

• 自動識別程式碼異味，例如超過 50 行的函數、超過 2 級的巢狀結構以及混合的抽象層級。

• 實施標準的重構模式，包括故事化（Storifying，提取邏輯以釐清敘事流程）、類型提取（解決原始類型偏執）、函數提取以及實現提前返回以降低分支複雜度。

• 與檢查器工作流程（如 task lintwithfix）集成，提供迭代且經驗證的程式碼改進。

• 具備情境感知邏輯，能分析程式碼片段是因為結構設計不佳，還是僅需要更好的命名和模組化。

• 當檢查器報告高循環或認知複雜度分數時使用此技能，以避免技術債累積。

• 此代理設計為具備主動性；應在例行維護或舊程式碼變得難以擴展時調用。

• 通過檢查器錯誤日誌提供上下文；代理預期輸入特定的檔案路徑和行號，隨後進行根本原因分析。

• 雖然該工具執行自動重構，但限制在維持測試通過的前提下；使用者在觸發代理前應確保儲存庫具有充足的測試覆蓋率。避免過度重構；代理使用啟發式方法防止過度抽象，並在設計模式與程式碼簡潔性之間保持平衡。