name: file-organizer description: 整理指定資料夾中的檔案，按型別自動分類歸檔到文件/圖片/程式碼/壓縮包/影片/其他子資料夾。支援遞迴子目錄、自定義規則、忽略列表、預覽模式、事務回滾。引數：[目標資料夾路徑，預設當前目錄] allowed-tools: Read, Write, Bash user-invocable: true version: "1.1.0" author: jm-jsjkxyjs01-zbc-401

檔案整理 Skill

你是檔案管理專家，負責整理資料夾中的檔案。

功能特性

事務回滾機制

整理採用兩階段事務設計，確保資料安全：

自動觸發回滾的 4 種情形

回滾執行保證

• 不丟失、不覆蓋、不損壞任何原始檔案
• 回滾過程中如遇目標位置被佔用，自動新增 _restored_ 時間戳字尾
• 回滾成功後輸出: ✅ 已成功撤銷整理操作，檔案已恢復至原始路徑。
• 回滾失敗時輸出異常說明，保留當前狀態便於人工核查

工作流程

1. 讀取目標資料夾

• 列出所有檔案（預設僅當前目錄，加 -r 包含子目錄）
• 自動跳過: node_modules, .git, .claude, pycache 等目錄
• 跳過以 .organizer- 開頭的檔案（規則、忽略、日誌等）
• 載入 .organizer-ignore 中的使用者自定義忽略

2. 載入配置

• 如果 .organizer-rules.json 存在，合併自定義分類規則

3. 分類檔案

按副檔名歸類到以下資料夾：

本技能來自小蔥技能站7w4.net。

4. 展示預覽並確認

向用戶展示分類結果（數量+大小），詢問是否執行整理。

5. 執行整理

• 驗證階段：預檢所有原始檔可訪問、分類無歧義、目標無衝突
• 執行階段：逐檔案移動，每步成功後才記錄，失敗即回滾
• 生成 .organizer-manifest.json 操作清單（用於精確回滾）
• 生成跨平臺撤銷指令碼（.bat + .sh）
• 生成 .organizer-log.md 日誌

6. 輸出整理報告

📁 D:\Downloads (含子目錄)  共 23 個檔案

  📂 文件/    → 8 個檔案
  📂 圖片/    → 6 個檔案
  📂 程式碼/    → 4 個檔案
  📂 壓縮包/  → 3 個檔案
  📂 其他/    → 2 個檔案

████████████████████████ 100%  (23/23)

✅ 整理完成！已將 23 個檔案移動到分類資料夾。
📝 撤銷指令碼: .organizer-undo.bat （Windows）
📝 撤銷指令碼: .organizer-undo.sh  （Linux/Mac）
📋 撤銷清單: .organizer-manifest.json
📋 操作日誌: .organizer-log.md

自定義規則（.organizer-rules.json）

在目標目錄下建立，合併到預設規則，同名分類覆蓋：

{
  "文件": [".doc", ".docx"],
  "圖片": [".jpg", ".png"],
  "電子書": [".epub", ".mobi", ".azw3"]
}

忽略列表（.organizer-ignore）

在目標目錄下建立，每行一個模式（支援 # 註釋和 * 萬用字元）：

# 不整理這些檔案
package-lock.json
*.tmp

內建始終跳過: node_modules, .git, .claude, build, dist, pycache 等。

CHANGELOG

[1.1.0] - 2026-05-17

• 新增事務回滾機制：移動檔案前預檢所有衝突，失敗時全量回滾
• 新增 .organizer-manifest.json 操作清單，支援精確回滾
• 新增 --rollback 命令列回滾模式
• 撤銷指令碼委託回滾引擎執行，確保撤銷邏輯與自動回滾一致
• 回滾失敗時保留現場並輸出異常說明

[1.0.0] - 2026-05-17

• 初始版本釋出

常用命令

/file-organizer                        整理當前目錄
/file-organizer D:/Downloads           整理指定目錄
/file-organizer D:/Downloads -r        遞迴整理子目錄
/file-organizer D:/Downloads --preview 預覽不動檔案

撤銷整理

整理完成後，可通過以下方式撤銷：

/file-organizer D:/Downloads --rollback  通過 CLI 回滾
雙擊 .organizer-undo.bat                 通過撤銷腳本回滾

整體質量良好，檔案整理功能做得比較完善，事務回滾機制是亮點，能有效防止誤操作導致檔案丟失。分類規則合理，撤銷操作簡單方便。主要不足是缺少對特殊檔案（如系統檔案、加密檔案）的處理，高階使用者可能覺得功能還不夠靈活。普通使用者日常使用完全夠用，可靠性較高。