file-restructurer

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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill automates the complex process of project restructuring and code modularization. It helps developers transform disorganized codebases into clean, maintainable architectures by reorganizing folders, splitting oversized modules, and automatically updating import paths. With built-in safety features like dry-run previews and automated backups, it ensures structural improvements are performed without breaking project functionality.

Use Cases

  • Refactoring monolithic source files (500+ lines) into smaller, specialized modules to improve code readability and maintainability.
  • Migrating a flat or messy project structure to professional architectural patterns like Domain-Driven Design (DDD) or layered architecture.
  • Automating the tedious task of updating all internal import statements across a codebase after moving files or renaming directories.
  • Performing safe, large-scale folder reorganizations with the ability to preview changes and rollback if the new structure doesn't meet requirements.
namefile-restructurer
description|
LOAD THIS SKILL WHENProject structure is messy | User says "整理資料夾", "重構結構", "reorganize", "模組化" | files exceed 500 lines | need DDD folder structure.
CAPABILITIESFolder 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 預覽重構」