---

name: file-restructurer description: | Restructure project files, reorganize folders, and modularize code. LOAD THIS SKILL WHEN: Project structure is messy | User says "整理資料夾", "重構結構", "reorganize", "模組化" | files exceed 500 lines | need DDD folder structure. CAPABILITIES: Folder reorganization, module splitting, import path updates, backup/rollback, dry-run preview.

檔案重構技能

描述

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

觸發條件

• 「重構檔案結構」
• 「整理資料夾」
• 「模組化」
• 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

2. 模組拆分

Before:
utils.py (500 行)

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

3. 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 預覽重構」