前言¶
下载目录、项目归档盘、离职交接文件夹，往往混着多年材料：同一类业务文档散落在不同层级，文件夹命名也不统一。手工整理要反复打开子目录、自己定分类树，还要担心误删或覆盖原文件。
下面介绍 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。
