前言¶
下載目錄、桌面和項目旁路文件夾裏，常會堆着截圖、合同 PDF、錄屏和零散腳本。手工建子目錄、按擴展名拖拽，一次還能忍；隔幾週再整理，文件名和路徑都對不上，還容易誤刪。
下面介紹 SkillHub 上的社區 Skill「文件自動歸檔助手」。它面向「一鍵整理」場景：在 Agent 裏啓用後，由模型按 Skill 說明，結合你給出的目錄與偏好，按文件類型、日期或關鍵詞把文件歸到對應分類（如圖片、文檔、視頻、代碼等）。適合已經用 Cursor、Claude Code 等支持 Skills 的客戶端、又不想自己寫整理腳本的人。
這是什麼¶
文件自動歸檔助手（座標 @user_e5701557/file-auto-archiver，版本 1.0.0）是 SkillHub 社區來源（community）的辦公效率類 Skill，分類爲 office-efficiency。發佈者爲 user_e5701557。
官方簡介：自動按文件類型/日期/關鍵詞整理歸檔文件，支持圖片、文檔、視頻、代碼等分類，幫你一鍵整理雜亂文件夾。頁面標註 requires_api_key=false，即安裝與使用不依賴額外 API Key 配置（以 SkillHub 頁面標籤爲準）。
SkillHub 統計（以抓取資料爲準）：評分 100000，下載 1518 次，安裝計數 0（平臺展示字段，不代表本地未安裝）。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_e5701557/file-auto-archiver
- API 座標頁：https://api.skillhub.cn/user_e5701557/file-auto-archiver
核心功能¶
以下能力均來自官方簡介與 SkillHub 元數據，未在公開頁寫明的細節（例如具體目錄樹模板、是否移動或僅複製）不在此展開。
-
按文件類型分類
支持將常見類別歸入不同歸檔方向，簡介中明確提到：圖片、文檔、視頻、代碼等。 -
按日期整理
可按日期維度組織文件（具體以 Skill 安裝後的SKILL.md與工作流爲準）。 -
按關鍵詞整理
可結合文件名或你提供的關鍵詞規則做歸類。 -
一鍵整理雜亂文件夾
面向「整個文件夾需要收口」的場景，通過對話讓 Agent 執行歸檔，而不是手寫一長串 shell 腳本。
安裝與啓用¶
SkillHub 官方推薦兩種方式：用 SkillHub CLI 安裝到當前 Agent 的 skills 目錄，或把安裝提示詞發給 AI 由其按安裝文檔操作。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（文檔中的推薦命令）：
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
說明見：https://skillhub.cn/install/skillhub.md
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會裝到 ./skills/，客戶端可能識別不到。
skillhub install @user_e5701557/file-auto-archiver --dir <你的 skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔，請按你本機環境選用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
若你更習慣讓 AI 代爲安裝，SkillHub 頁面提供的提示詞爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_e5701557/file-auto-archiver`。
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 被加載。
典型用法¶
公開 SkillHub 頁面未附帶獨立命令行子工具說明，典型用法是：在已啓用該 Skill 的對話裏，說明要整理的根目錄、是否允許移動/重命名、以及你偏好的維度（類型 / 日期 / 關鍵詞）。
可復現的對話示例（路徑請換成你機器上的真實目錄）：
請使用文件自動歸檔助手，整理 ~/Downloads/待歸檔：
- 圖片、文檔、視頻、代碼分到不同子目錄
- 文檔再按修改日期分到 YYYY-MM 子文件夾
- 文件名包含「發票」的放進 Documents/發票
- 先列出計劃移動的清單，我確認後再執行
經過上面的步驟，Agent 會依據 Skill 內的 SKILL.md 與工作流執行歸類。若你對誤移動敏感，務必在對話中要求「先預覽清單再執行」，並在小目錄上試跑。
適用場景與注意¶
適合誰
- 下載區、共享盤收件夾、活動素材夾等「多類型混放」的目錄需要定期收口。
- 已使用 Cursor、Claude Code、Codex 等支持 Skills 的環境，希望用自然語言描述規則而不是維護自研腳本。
- 不需要爲 Skill 單獨配置 API Key（
requires_api_key=false）。
限制與注意
- 來源爲 community，歸檔邏輯與邊界以安裝包內
SKILL.md爲準；升級前可在 SkillHub 查看版本 1.0.0 是否有更新。 - 批量移動/重命名有風險：先備份或在副本目錄驗證，重要文件建議先「複製歸檔」再清理原位置（是否在 Skill 內默認移動，以實際 Skill 說明爲準）。
skillhub install的--dir必須對準當前 Agent 的 skills 目錄，裝錯位置會導致「已安裝但對話裏用不了」。- 平臺展示的「安裝 0」是 SkillHub 統計字段，與你在本機是否安裝無關。
結尾¶
文件自動歸檔助手把「按類型、日期、關鍵詞整理文件夾」收斂成可在 Agent 裏觸發的一類辦公效率 Skill，適合處理長期堆積的雜亂目錄。安裝與路徑配置以 SkillHub 文檔爲準；使用前在小範圍目錄試跑並確認移動策略。
Skill 主頁：https://www.skillhub.cn/skills/user_e5701557/file-auto-archiver
