Advanced
1 hour
How to 重構你的程式碼庫 with Eigent
移除無用程式碼並現代化舊有模式,同時不改變行為—— 以小步、可審閱的方式逐步進行。
What you need
- Eigent 桌面應用程式
- 程式碼庫存取權(本機或已連接的 repo)
- 測試套件或 CI pipeline
Best for
- 有無用程式碼、過大模組或過時抽象層,令日常修改成本高的程式碼庫
- 需要在原地現代化程式碼,但又不想把工作變成整體遷移的團隊
- 為新功能或團隊上手作準備的工程師
Starter Prompt
現代化並重構這個程式碼庫。 要求: - 除非我明確要求功能變更,否則請保留行為不變。 - 先識別拖慢修改速度的無用程式碼、重複路徑、過大的模組、過時的抽象層,以及舊有模式。 - 對每個建議的步驟,說明目前行為、結構性改進,以及應該證明行為維持穩定的驗證檢查。 - 將工作拆成可審閱的小型重構步驟,例如刪除無用程式碼、簡化控制流程、抽取 helper,或以 repo 目前的慣用方式取代過時模式。 - 除非重構本身需要,否則保持 public API 穩定。 - 如有任何 framework migration、dependency upgrade、API 變更或架構搬遷,請指出並將其拆分成獨立的 migration 任務。 請提出一個執行計劃。
運作方式
- 先請 Eigent 在編輯前繪製該區域的地圖 — 找出雜訊模組、重複邏輯、未使用程式碼和過時模式。
- 一次只選一個清理主題 — 移除未使用程式碼、簡化控制流程、現代化過時模式,或拆分大型檔案。
- 在 Eigent 修補檔案之前,先要求它說明目前行為、結構性改進,以及證明行為維持穩定所需的最小檢查。
- 每完成一個步驟後,先檢視並執行最小且最有用的檢查,再進行下一個清理,而不是一次把整個清理合併成一個 diff。
- 除非為了完成清理而必須,否則將堆疊變更、依賴遷移和架構搬遷分開處理。
更多可嘗試的提示
- 這個區域有哪些檔案有最多無用程式碼或未使用的 exports?
- 找出所有重複同樣邏輯的地方,並提議一個統一的整合點。
- 這個模組中的哪些舊有模式與 repo 目前的慣用方式不一致?
- 在不改變其 public API 的前提下,將這個過大的檔案拆成更小、責任明確的部分。
如何使用
先請 Eigent 繪製這個雜亂區域的地圖 — 它會在碰任何程式碼之前先找出最高價值的清理機會。一次只處理一個主題,並在進入下一步前審閱每個 diff。每一輪之後,使用你的測試套件或 CI 作為驗證檢查。如果 Eigent 提出堆疊遷移或依賴變更,請將其標記為獨立任務,並保持目前的重構只聚焦於結構。
預期輸出
一份按優先次序排列的清理計劃、一系列小型、聚焦的 diff(每個步驟一個),以及每個步驟的驗證摘要,說明改了什麼,以及哪個檢查可確認行為穩定。
限制
- 當該區域已有測試套件或清晰的行為合約可供驗證時,效果最佳。
- 大型 monorepo 會更適合一次只聚焦一個 service 或模組。
- 架構變更、runtime 升級和 framework 遷移應該分開處理——把它們和重構混在一起會令 diff 難以審閱。