moonbit-refactoring

moonbit-refactoring 技能為 AI 代理程式提供了一個結構化框架，用於對 MoonBit 程式碼庫執行高品質的維護工作。它專為使用 MoonBit 的開發者、函式庫維護者及團隊設計，適用於更新舊程式碼、強制執行專案架構標準或針對效能與清晰度優化現有模組。透過應用此技能，代理程式將作為專業的重構引擎，優先考慮語意正確性、API 穩定性及慣用語法表達。

• 執行整體架構審查，包括封裝結構、相依性管理及檔案大小優化，目標是將每個套件控制在 1 萬行程式碼以內。

• 透過識別冗餘的公開匯出內容、將輔助函式移至內部套件，並將公開 API 介面嚴格限制在必要範圍內，來執行 API 精簡化。

• 透過將自由函式轉換為方法來改進程式碼的易發現性與鏈式呼叫，通常會利用 #as_free_fn 巨集在轉換期間維持向後相容性。

• 透過使用 ArrayView、StringView 和 BytesView 等視圖型別來取代資料複製，從而優化記憶體使用並確保高效的資料處理。

• 推動表達式 MoonBit 特性的使用，特別是用宣告式模式匹配、巢狀匹配和 guard 子句取代指令式變更，以實現更乾淨的控制流程。

• 自動整合迴圈不變量與文件更新，確保重構過程能通過編譯器檢查與單元測試的驗證。

• 此技能需要存取整個儲存庫，並高度依賴 moon ide 工具鏈（包含 moon ide doc、moon ide find-references 和 moon ide analyze），以安全地識別專案中各項變更的影響。

• 此技能預設代理程式會遵循先進行廣泛架構改進，再進行細部重構的工作流程。

• 使用者應預期代理程式會在過程中頻繁執行 moon check 與 moon test，以保證不會出現回歸問題。

• 給予代理程式的輸入應包含需要關注的特定套件或符號，輸出的結果通常是一系列連貫的 commit，這些變更會改進套件模組化、簡化列舉建構子用法，並使程式碼庫與 MoonBit 的最佳實踐保持一致。