SuperAPI AI 工具集

file-restructurer

编程与开发

查看项目

更新于 10-16 08:55

技能介绍

檔案重構技能

描述

重組專案檔案結構,整理資料夾,進行模組化重構。

觸發條件

「重構檔案結構」

「整理資料夾」

「模組化」

Workflow 中的重構步驟

重構類型

  1. 資料夾結構重組

Before: ├── app.py ├── utils.py ├── database.py ├── models.py └── tests.py

After: ├── src/ │ ├── init.py │ ├── app.py │ ├── core/ │ │ ├── init.py │ │ └── models.py │ ├── infrastructure/ │ │ ├── init.py │ │ └── database.py │ └── utils/ │ ├── init.py │ └── helpers.py └── tests/ ├── init.py └── test_models.py

  1. 模組拆分

Before: utils.py (500 行)

After: utils/ ├── init.py ├── string_utils.py ├── date_utils.py ├── file_utils.py └── validation.py

  1. Import 路徑更新

自動更新所有受影響檔案的 import 語句

執行流程

  1. 分析當前結構
  2. 生成重構計畫
  3. 預覽變更(dry-run)
  4. 使用者確認
  5. 執行重構
  6. 更新 imports
  7. 驗證功能正常
  8. 生成報告

安全機制

備份機制

自動建立備份

.backup/ └── [timestamp]/ └── [原始結構複製]

回滾機制

如需回滾,執行: git checkout HEAD -- . 或 從 .backup/[timestamp]/ 還原

輸出格式

🔧 檔案重構報告

═══════════════════════════════════════

📊 重構摘要:

  • 移動檔案:12 個
  • 新建資料夾:5 個
  • 更新 imports:23 處

═══════════════════════════════════════

📁 結構變更:

移動的檔案: 📄 utils.py → src/utils/helpers.py 📄 models.py → src/core/models.py 📄 database.py → src/infrastructure/database.py

新建的資料夾: 📁 src/ 📁 src/core/ 📁 src/infrastructure/ 📁 src/utils/ 📁 tests/

更新的 imports: 📄 app.py: 5 處 📄 test_models.py: 3 處

═══════════════════════════════════════

✅ 重構完成!

⚠️ 建議執行:

  1. 運行測試確認功能正常
  2. 檢查 IDE 是否正確識別新結構
  3. 提交變更到 Git

使用範例

「重構為 DDD 結構」 「整理 utils 資料夾」 「模組化 services.py」 「--dry-run 預覽重構」