前言¶
下載目錄、桌面或項目根目錄裏混着文檔、截圖、壓縮包和安裝包時，手工拖拽分類既慢又容易漏。用腳本可以批量移動，但要自己維護擴展名列表和目錄結構，改規則還要改代碼。下面介紹 SkillHub 上的社區 Skill file-organizer（座標 @user_e4ae361c/file-organizer，當前版本 1.0.1）：在 Agent 裏用自然語言指定目標文件夾，由 Skill 按內置分類、修改日期或自定義映射完成歸檔，並支持先試跑再真正移動文件。
這是什麼¶
file-organizer 面向「整夾整理」場景：對指定目錄中的文件做分類歸檔，移動到對應子文件夾，而不是處理單個文件的複製、重命名等零散操作。
- 來源：SkillHub 社區（
community），發佈者user_e4ae361c - 分類：office-efficiency（辦公效率）
- 依賴：標籤標明
requires_api_key=false，無需額外 API Key
官方頁面：SkillHub - file-organizer；技能元數據接口：https://api.skillhub.cn/user_e4ae361c/file-organizer
核心功能¶
以下能力均來自官方簡介，安裝後由 Agent 按 Skill 內 SKILL.md 指引執行。
按擴展名智能分類¶
支持 30+ 種常見擴展名的歸類，覆蓋文檔、圖片、代碼、壓縮包、視頻、音頻、電子書、字體、設計文件、配置文件、可執行文件、數據文件等類型，歸檔到對應子目錄。
按修改日期歸檔¶
可按文件修改時間建立 年 / 月 / 日 層級目錄，適合照片、日誌、按天下載的文件等按時間回溯的場景。
自定義分類映射¶
除默認類型劃分外，可配置自定義「擴展名或規則 → 目標文件夾」的映射，適應團隊或個人的命名習慣。
試運行預覽¶
提供預覽模式：只展示將要移動的路徑與分類結果，不實際改動磁盤上的文件，適合先確認規則再執行。
空文件夾清理與統計報告¶
整理完成後可清理空目錄，並輸出處理結果統計，便於覈對移動數量與分類分佈。
觸發邊界（官方說明）¶
適合觸發：文件夾太亂需要整理、按類型歸類、批量移動到不同子文件夾、整理下載目錄、歸類文檔 / 照片 / 代碼等。
不宜觸發：僅針對單個文件的操作，或不需要分類歸檔的場景。
安裝與啓用¶
SkillHub 推薦通過 CLI 安裝到當前 Agent 能識別的 skills 目錄；也可用自然語言讓 AI 按官方安裝文檔完成安裝。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可用官方一鍵腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝 file-organizer¶
安裝時必須用 --dir 指向當前環境的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。
skillhub install @user_e4ae361c/file-organizer --dir <你的 skills 目錄>
常見客戶端 skills 路徑（以 SkillHub 安裝文檔 爲準）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目下 .windsurf/skills/ |
也可向 Agent 發送官方頁面提供的安裝提示，讓其根據 https://skillhub.cn/install/skillhub.md 安裝 @user_e4ae361c/file-organizer。
安裝後按所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
官方未在頁面列出固定 CLI 子命令；實際使用方式是在對話中說明目標路徑和整理策略，由 Agent 調用本 Skill 執行。下面示例均對應官方描述的能力，表述可按需要調整。
按類型整理下載目錄（建議先預覽）
- 說明目錄，例如：
~/Downloads。 - 要求先走試運行：「只預覽，不要移動文件，按類型歸類會放到哪些子文件夾」。
- 確認無誤後再要求正式整理並生成統計報告。
按修改日期歸檔照片或日誌
說明目標文件夾，並要求按文件修改日期建立 年/月/日 層級；若需例外類型，可同時說明自定義映射（例如某類擴展名仍進「文檔」而不是按日期分）。
整理後收尾
在正式執行後，可要求清理空文件夾並輸出本次移動的文件數量與分類彙總。
適用場景與注意¶
適合誰
- 本機或共享盤上目錄長期堆積、擴展名混雜的用戶。
- 需要 repeatable 規則（類型 + 可選日期 + 自定義映射）、且希望用對話改策略而不是改腳本的人。
使用注意
- 正式移動前優先使用試運行預覽，避免誤歸檔重要文件。
- Skill 面向批量分類整理；單文件操作應直接用系統或 Agent 常規文件能力，不必啓用本 Skill。
- 社區來源 Skill，安裝前可在 SkillHub 頁面查看版本與說明；當前頁面展示版本爲 v1.0.1。
結尾¶
file-organizer 把「按類型、按日期、按自定義規則歸檔整夾文件」封裝成 Agent Skill，並強調預覽、空目錄清理與結果統計，適合整理下載目錄和雜項文件夾。需要安裝或查看詳情時，可訪問 SkillHub 技能頁 或元數據地址 https://api.skillhub.cn/user_e4ae361c/file-organizer。
