檔案重構技能
描述
重組專案檔案結構,整理資料夾,進行模組化重構。
觸發條件
「重構檔案結構」
「整理資料夾」
「模組化」
Workflow 中的重構步驟
重構類型
- 資料夾結構重組
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
- 模組拆分
Before: utils.py (500 行)
After: utils/ ├── init.py ├── string_utils.py ├── date_utils.py ├── file_utils.py └── validation.py
- Import 路徑更新
自動更新所有受影響檔案的 import 語句
執行流程
- 分析當前結構
- 生成重構計畫
- 預覽變更(dry-run)
- 使用者確認
- 執行重構
- 更新 imports
- 驗證功能正常
- 生成報告
安全機制
備份機制
自動建立備份
.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 處
═══════════════════════════════════════
✅ 重構完成!
⚠️ 建議執行:
- 運行測試確認功能正常
- 檢查 IDE 是否正確識別新結構
- 提交變更到 Git
使用範例
「重構為 DDD 結構」 「整理 utils 資料夾」 「模組化 services.py」 「--dry-run 預覽重構」