前言¶

接手一個遺留項目或同事的共享盤時，常遇到這樣的目錄：文件散在十幾層嵌套裏，同名文件散落多處，下載、臨時文件和文檔混在一起。手工整理耗時且容易漏，寫腳本則要針對每個目錄定製。下面介紹的 Skill「文件智能分類整理」就是讓 Agent 直接對目標文件夾做遞歸掃描、統計分析、自動分類重組，並輸出目錄結構、遷移清單和整理報告，屬於 office-efficiency 分類。

這是什麼¶

一句話定位：把一個混亂的文件夾交給 Agent，它會先掃描統計，再按規則自動分類重組，最後給出可覈對的遷移清單和報告。

出品方爲社區開發者 user_58fad8c3，座標 @user_58fad8c3/file-smart-classify，當前版本 1.0.1，來源標記爲 community。該 Skill 無需 API Key（requires_api_key=false），在 SkillHub 上的評分爲 100000，下載 827 次。

核心功能¶

下面介紹的能力均來自官方簡介。

1、遞歸掃描與統計分析：掃描目標文件夾的完整目錄樹，統計文件分佈情況。
2、自動分類重組：在統計結果基礎上自動歸類並重組目錄。
3、三模式引擎：快速掃描、完整分類、批量多任務，按場景選模式。
4、8 條安全門禁：包括系統目錄保護、版本控制排除、備份前置等，整理前先做安全檢查。
5、偏好存儲與進化機制：記錄用戶的偏好，後續整理按偏好調整。
6、三級自適應降級方案：L1/L2/L3，環境或條件不滿足時逐級降級而不是直接失敗。
7、三類輸出物：目錄結構、遷移清單、整理報告。

觸發詞包括：文件分類、整理文件夾、文件夾整理、文件歸檔、目錄重組、文件歸類、批量分類、整理混亂文件夾、按類型整理文件。

安裝與啓用¶

這份資料裏沒有給出安裝命令、目錄或配置字段，官方頁面（https://www.skillhub.cn/skills/user_58fad8c3/file-smart-classify 與 https://api.skillhub.cn/user_58fad8c3/file-smart-classify）在本次編寫時抓取失敗，因此這裏不寫未經覈實的安裝步驟。Skill 基於通用 SKILL.md 格式，在支持該格式的客戶端中啓用後，用上面的觸發詞或直接描述任務即可調用。拿到官方頁面後應補充具體的安裝命令。

典型用法¶

資料中未提供可復現的官方示例，下面給出與簡介一致的調用思路，屬於推斷而非官方示例：

1、快速掃描：對目標目錄發起快速掃描，只看統計結果，不改動文件。
2、完整分類：確認統計結果無誤後執行完整分類，生成遷移清單。
3、按清單遷移：Agent 按遷移清單移動文件，再輸出整理報告。

需要說明的是，上述步驟只是與「三模式引擎 + 遷移清單 + 整理報告」對應的邏輯順序，並非官方文檔原文。

適用場景與注意¶

適合的場景：個人下載目錄、項目資料夾、交接過來的混亂目錄、需要批量歸檔的素材目錄。

需要注意的幾點：

1、官方簡介只聲明瞭能力，沒有給出性能數據或效果保證，大目錄的實際耗時需自行驗證。
2、安全門禁是能力聲明，正式使用前建議先在小目錄上跑一遍，確認系統目錄保護和備份前置生效。
3、遷移清單是最終產物，覈對清單之前不要當成已完成。
4、偏好存儲意味着 Skill 會記錄使用習慣，介意的話先了解其存儲位置。
5、分類策略的明細未在資料中展開，需要時直接查看該 Skill 的 SKILL.md。

結尾¶

這個 Skill 的價值在於把「掃描—統計—分類—遷移—報告」串成一條鏈，省去爲每個目錄單獨寫腳本的功夫。官方地址：https://api.skillhub.cn/user_58fad8c3/file-smart-classify ，SkillHub 頁面：https://www.skillhub.cn/skills/user_58fad8c3/file-smart-classify 。