前言¶
下載目錄、項目歸檔盤、離職交接文件夾，往往混着多年材料：同一類業務文檔散落在不同層級，文件夾命名也不統一。手工整理要反覆打開子目錄、自己定分類樹，還要擔心誤刪或覆蓋原文件。
下面介紹 SkillHub 社區 Skill「智能文件分類整理工具 file-classifier」（座標 @user_8bc43348/file-classifier，版本 1.0.1）。它在 Agent 裏按固定流程做全量遞歸盤點、按專業領域自適應規劃目錄、規範重命名後把文件複製到用戶指定的新目錄，並強調對原目錄只讀、不改動源文件。
這是什麼¶
一句話定位：面向「整盤文件夾遷移式整理」的 Agent Skill，用 SKILL.md 約定從盤點到複製、再到校驗報告的完整步驟。
- 出品與維護：SkillHub 社區來源（
community），發佈者user_8bc43348，分類爲office-efficiency。 - 平臺信息：SkillHub 頁面顯示版本 v1.0.1；標籤
requires_api_key=false，無需 API Key。 - 統計（以腳本抓取爲準）：評分 100000，下載 1631，安裝 24。
官方入口：
- 技能頁：https://www.skillhub.cn/skills/user_8bc43348/file-classifier
- API 座標頁：https://api.skillhub.cn/user_8bc43348/file-classifier
核心功能¶
以下能力均來自官方簡介與隨包 SKILL.md，安裝後 Agent 按文檔執行。
- 全量遞歸盤點：對用戶指定的原目錄遞歸遍歷，統計文件數、目錄層級、一級子目錄分佈，並做「領域識別」摘要。
- 自適應分類規劃：優先按文件所屬專業領域匹配分類邏輯（可參考包內
references/classification-rules.md中的領域與管理類兜底規則）；單領域文件量過大時有拆分規則（如單領域超過 3000 個時的模塊拆分說明）。 - 整體單元保護：名稱或結構符合「項目 / 體系 / 合集」等特徵的文件夾，作爲不可拆分單元整體遷移，不打散內部結構。
- 規範目錄命名：規劃結果傾向「兩位數字序號 + 中文名稱」、常規最多三層目錄等約束（詳見 Skill 內規則）。
- 只讀源、複製到目標：全程禁止刪除、修改、移動原目錄文件；在新目錄創建結構後用複製完成遷移，同名衝突時加
(1)、(2)等後綴，且禁止覆蓋新目錄已有文件。 - 批次前綴與交付物：每次完整任務生成唯一前綴
YYYYMMDDNN（如2026040201），同一任務各階段輸出共用該前綴；完成後在工作空間生成盤點報告、目錄規劃、遷移明細（Markdown 與 Excel）及執行校驗報告等文件。
安裝與啓用¶
SkillHub 官方建議先按 SkillHub 安裝說明 準備 skillhub CLI，再用 --dir 指向當前 Agent 的 skills 目錄（裝錯目錄會導致技能不被加載）。
檢查 CLI：
command -v skillhub && skillhub --version
未安裝時可使用文檔中的安裝腳本（完整安裝或 --cli-only 僅 CLI，以官方頁面爲準）。
安裝本 Skill（座標須帶 @ 前綴）：
skillhub install @user_8bc43348/file-classifier --dir <你的 Agent skills 目錄>
常見路徑示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 中可執行：
skillhub install @user_8bc43348/file-classifier --dir ~/.cursor/skills/
也可在對話中讓 Agent 按官方提示安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_8bc43348/file-classifier`。
安裝完成後，在對應客戶端中啓用 Agent / Skills 能力（若環境要求重啓或重新加載 skills，以客戶端說明爲準）。
典型用法¶
Skill 要求用戶至少提供兩個路徑：原目錄（只讀源）與新目錄（整理結果寫入位置）。若只提到技能名、缺少路徑或詢問「怎麼用」，Agent 應先給出用法說明，再進入執行流程。
對話示例（路徑請換成你本機真實目錄）：
使用 file-classifier 整理文件：
原目錄：/home/user/待整理
新目錄：/home/user/整理結果
經確認路徑後，Agent 會生成當次任務前綴並大致按下列步驟推進（與 SKILL.md 一致）：
- 獲取並確認原目錄、新目錄。
- 盤點原目錄並輸出《原文件全量盤點與領域識別報告》（文檔中示例使用 PowerShell 遍歷腳本）。
- 輸出《新目錄體系與整體單元歸屬規劃》。
- 輸出《全量文件遷移明細規劃表》（含 Markdown 與 Excel）。
- 在新目錄創建結構並複製文件（示例爲
Copy-Item，含保留時間戳的示例函數）。 - 輸出《執行結果與校驗報告》，覈對複製數量與異常清單。
盤點階段官方示例腳本形態如下（路徑替換爲用戶的原目錄）：
$source = "用戶指定的原目錄路徑"
$items = Get-ChildItem -Path $source -Recurse -ErrorAction SilentlyContinue
$fileCount = ($items | Where-Object { -not $_.PSIsContainer }).Count
$dirCount = ($items | Where-Object { $_.PSIsContainer }).Count
同一任務結束後，工作空間中可出現以前綴命名的文件，例如前綴爲 2026040201 時：
2026040201_01_原文件全量盤點與領域識別報告.md2026040201_02_新目錄體系與整體單元歸屬規劃.md2026040201_03_全量文件遷移明細規劃表.md2026040201_03_全量文件遷移明細規劃表.xlsx2026040201_05_執行結果與校驗報告.md
適用場景與注意¶
適合誰
- 需要把某一整塊文件夾「歸檔到新結構」、且必須保留原盤不動的人（交接盤、項目收尾、個人資料庫整理）。
- 希望分類邏輯跟「業務領域」而不是單純按擴展名或年份做一級目錄的場景（Skill 內明確禁止僅按格式或年份做一級分類）。
限制與注意
- 執行示例以 PowerShell 爲主；在純 Linux 環境下，需由 Agent 用等價方式完成遍歷與複製，或先在 Windows / 可運行 PowerShell 的環境驗證。
- 新目錄需要足夠磁盤空間，且 Agent 對源、目標路徑具備讀寫的操作系統權限。
- 規則較細（一級目錄數量、層級、不可拆分單元等）；首次使用官方也建議先在小目錄試跑，確認規劃符合預期再處理大批量數據。
- 本 Skill 是「複製遷移 + 報告」，不是同步盤或增量備份工具；重複執行會產生新的批次前綴與新的輸出文件集。
結尾¶
file-classifier 把「盤點 → 按領域規劃目錄 → 明細表 → 只讀複製 → 校驗報告」寫進一套可重複的 Agent 流程，並用品類前綴把單次任務的所有交付物綁在一起。若你正在 SkillHub 上找辦公效率類整理能力，可從官方技能頁查看說明並安裝：https://www.skillhub.cn/skills/user_8bc43348/file-classifier。
