前言¶

下載目錄、桌面或項目旁的臨時文件夾裏，常會堆着混在一起的文檔、截圖、壓縮包和安裝包。手工按後綴建子目錄再拖動，步驟重複，也容易漏文件或誤移正在使用的路徑。若希望把「讀目錄 → 按類型分桶 → 移動 → 彙總」交給對話裏的 Agent 按固定流程執行，可以安裝 SkillHub 上的社區 Skill「文件整理助手」（@user_c73fb2fe/file-organizer-skill-v2）。它用通用 SKILL.md 描述工作流，不依賴額外 API Key。

這是什麼¶

「文件整理助手」是 SkillHub 社區發佈者 user_c73fb2fe 維護的 Agent Skill，座標 @user_c73fb2fe/file-organizer-skill-v2，當前頁面版本爲 1.0.1，分類爲 knowledge-management，來源標記爲 community。Skill 元數據標明 requires_api_key=false。

一句話定位：在用戶提供的目標文件夾路徑下，按文件擴展名把文件歸入文檔、圖片、代碼、壓縮包、視頻等子目錄，並輸出整理報告。Skill 聲明可用工具爲 Read、Write、Bash，且支持用戶直接喚起（user-invocable: true）。

核心功能¶

以下能力均來自該 Skill 包內的 SKILL.md 工作流說明。

1. 掃描目標目錄：讀取指定文件夾中的文件列表。
2. 按擴展名分類，內置規則包括：
   - 文檔：.doc / .docx / .pdf / .txt / .md
   - 圖片：.jpg / .png / .gif / .svg / .webp
   - 代碼：.js / .py / .html / .css / .ts
   - 壓縮包：.zip / .rar / .7z / .tar.gz
   - 視頻：.mp4 / .avi / .mov / .mkv
3. 創建子文件夾並移動：爲每個類別建子目錄，將文件移入對應位置。
4. 整理報告：完成後輸出彙總說明。

Skill 的 description 字段將參數約定爲「目標文件夾路徑」，便於在對話裏直接指定要整理的目錄。

安裝與啓用¶

下面介紹兩種常見安裝方式：用 skillhub CLI 裝到當前 Agent 的 skills 目錄，或把官方提示詞交給 Agent 自行安裝。

1. 安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 安裝文檔 執行完整安裝：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安裝本 Skill¶

安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會落到 ./skills/，Agent 可能無法加載。

skillhub install file-organizer-skill-v2 --namespace user_c73fb2fe --dir <skills 目錄>

各客戶端常用路徑（摘自官方安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

在 Cursor 中可示例爲：

skillhub install file-organizer-skill-v2 --namespace user_c73fb2fe --dir ~/.cursor/skills/

3. 通過對話讓 Agent 安裝¶

SkillHub 技能頁提供的安裝話術爲：請 Agent 根據 https://skillhub.cn/install/skillhub.md，安裝 @user_c73fb2fe/file-organizer-skill-v2。

安裝後通常需要重啓或重新加載 Agent，以便識別新 Skill（以你所用客戶端的文檔爲準）。

典型用法¶

經過上面的步驟啓用 Skill 後，在對話中說明要整理的路徑即可。Skill 描述中的參數爲「目標文件夾路徑」，例如：

用文件整理助手整理 ~/Downloads 裏的文件，按 Skill 裏的分類規則歸檔。

Agent 應按 Skill 內五步流程執行：列舉文件 → 按擴展名歸類 → 創建子文件夾 → 移動文件 → 輸出整理報告。若路徑含空格或中文，在讓 Agent 執行 shell 時注意正確引用路徑。

適用場景與注意¶

適合誰

• 需要定期清理下載目錄、桌面或共享盤根目錄的用戶。
• 希望 Agent 按固定擴展名表分類，而不是每次重新口述規則的場景。

限制與注意

• Skill 正文只列出了上述擴展名集合；未列出的類型不會自動進入這五類，移動前宜先確認目錄內容，或讓 Agent 說明未匹配文件的處理方式。
• 工作流會直接創建子目錄並移動文件，Skill 內未描述「僅預覽、不改動」模式；重要目錄請先備份，或在對話中明確要求先列出計劃再執行。
• 允許使用 Bash 與 Write，整理範圍應限定在你指定的目標文件夾，避免誤動系統目錄或正在開發的項目根目錄。
• SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 1561；安裝量等數字以 SkillHub 展示爲準，會隨時間變化。

結尾¶

「文件整理助手」把按擴展名分桶、建子目錄和寫報告寫進 SKILL.md，適合把重複的本地歸類工作交給 Agent。無需 API Key，通過 SkillHub 即可安裝。

• 技能頁：https://www.skillhub.cn/skills/user_c73fb2fe/file-organizer-skill-v2
• API 座標頁：https://api.skillhub.cn/user_c73fb2fe/file-organizer-skill-v2
• 安裝說明：https://skillhub.cn/install/skillhub.md