前言¶

下載目錄、桌面或項目根目錄裏混着 PDF、截圖、壓縮包和安裝包時，手工拖進子文件夾既慢又容易漏。寫一次性腳本可以，但每次改規則都要動代碼。下面介紹 SkillHub 上的社區 Skill「文件整理」，讓對話式 Agent 在本地按擴展名（或自定義規則）把文件歸到對應子目錄。

這是什麼¶

「文件整理」是 SkillHub 座標 @user_1a377f33/file-organize 下的 Agent Skill，當前版本 1.0.0，來源爲 community，分類 dev-programming，由發佈者 user_1a377f33 維護。它面向通用 SKILL.md 格式：安裝後寫入 Agent 的 skills 目錄，由模型在合適語境下加載說明並執行整理流程。

官方簡介：整理文件夾中的文件，按類型分類到對應子文件夾；支持按擴展名（文檔、圖片、視頻、壓縮包、安裝程序、代碼等）自動分類，也可自定義規則。頁面標註 requires_api_key=false，不依賴額外 API Key。

核心功能¶

依據 SkillHub 與 API 頁面已公開說明，可覈實的能力如下：

1. 按類型分子目錄：在指定文件夾內，把文件移動到與類型對應的子文件夾，而不是隻列清單。
2. 內置擴展名分類：覆蓋文檔、圖片、視頻、壓縮包、安裝程序、代碼等常見類別（具體擴展名映射以 Skill 包內 SKILL.md 爲準）。
3. 自定義規則：除默認按擴展名分類外，可按用戶說明調整歸類方式（例如單獨目錄、合併某幾類擴展名）。
4. 意圖觸發：當用戶提到「整理文件」「分類文件」「組織文件夾」「清理下載」，或英文「file organizer」「organize」等表述時，Agent 應選用此 Skill。

安裝與啓用¶

SkillHub 官方頁面給出的安裝指引是：讓 AI 根據安裝文檔安裝座標 @user_1a377f33/file-organize。底層流程對應 SkillHub 安裝與優先源配置。

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、安裝到當前 Agent 的 skills 目錄¶

安裝技能時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄；默認裝到 ./skills/ 可能不會被識別。官方文檔列出的常見路徑包括：

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

示例（將座標替換爲頁面上的 @user_1a377f33/file-organize，目錄按你的環境修改）：

skillhub install user_1a377f33/file-organize --dir ~/.cursor/skills/

也可直接向 Agent 發送 SkillHub 頁面提供的提示詞：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_1a377f33/file-organize`。

安裝完成後，按你所用客戶端要求重啓或刷新 Agent，使新 Skill 生效。

典型用法¶

公開資料未附帶獨立 CLI 子命令；用法是在 Agent 對話中說明目標目錄與規則，由 Skill 指導 Agent 在本地移動文件。可復現的表述方式如下。

默認按類型整理某一目錄（路徑換成你的實際文件夾）：

用文件整理 Skill，把 /home/me/Downloads 裏的文件按類型分到子文件夾。

強調清理下載目錄（對應官方觸發詞）：

幫我清理下載文件夾，按文檔、圖片、視頻、壓縮包分類。

自定義規則（在官方「可自定義規則」範圍內用自然語言說明）：

整理 ~/Desktop：所有 .md 和 .txt 放進「文檔」，安裝包 .deb/.AppImage 放進「安裝程序」，其餘按默認類型分類。

執行前建議讓 Agent 先列出將要移動的文件與目標子目錄，確認後再執行，避免誤移正在使用的文件。

適用場景與注意¶

適合誰：需要定期整理下載目錄、桌面或共享盤根目錄的開發者；希望用對話改分類規則、而不是每次改腳本的人。

限制與注意：

• 社區來源（community），行爲細節以 Skill 包內 SKILL.md 爲準；升級前可在 SkillHub 查看版本 1.0.0 是否有更新說明。
• 文件移動不可逆於「撤銷」之外的操作層面，重要目錄先備份或先在副本目錄試跑。
• 已抓取資料顯示評分 100000、下載 7743 次（SkillHub 統計會隨時間變化，以頁面爲準）。
• 未要求 API Key，但 Agent 仍需具備讀寫本地文件系統的權限；在沙箱或受限環境中可能無法完成移動。

結尾¶

「文件整理」把「按擴展名歸檔 + 可選自定義規則」封裝成 Agent Skill，適合用自然語言處理雜亂的本地文件夾。安裝與座標以 SkillHub 爲準：

• 技能頁：https://www.skillhub.cn/skills/user_1a377f33/file-organize
• API 條目：https://api.skillhub.cn/user_1a377f33/file-organize