前言¶
下载目录、桌面或项目根目录里混着文档、截图、压缩包和安装包时，手工拖拽分类既慢又容易漏。用脚本可以批量移动，但要自己维护扩展名列表和目录结构，改规则还要改代码。下面介绍 SkillHub 上的社区 Skill file-organizer（坐标 @user_e4ae361c/file-organizer，当前版本 1.0.1）：在 Agent 里用自然语言指定目标文件夹，由 Skill 按内置分类、修改日期或自定义映射完成归档，并支持先试跑再真正移动文件。
这是什么¶
file-organizer 面向「整夹整理」场景：对指定目录中的文件做分类归档，移动到对应子文件夹，而不是处理单个文件的复制、重命名等零散操作。
- 来源：SkillHub 社区（
community），发布者user_e4ae361c - 分类：office-efficiency（办公效率）
- 依赖：标签标明
requires_api_key=false，无需额外 API Key
官方页面：SkillHub - file-organizer；技能元数据接口：https://api.skillhub.cn/user_e4ae361c/file-organizer
核心功能¶
以下能力均来自官方简介，安装后由 Agent 按 Skill 内 SKILL.md 指引执行。
按扩展名智能分类¶
支持 30+ 种常见扩展名的归类，覆盖文档、图片、代码、压缩包、视频、音频、电子书、字体、设计文件、配置文件、可执行文件、数据文件等类型，归档到对应子目录。
按修改日期归档¶
可按文件修改时间建立 年 / 月 / 日 层级目录，适合照片、日志、按天下载的文件等按时间回溯的场景。
自定义分类映射¶
除默认类型划分外，可配置自定义「扩展名或规则 → 目标文件夹」的映射，适应团队或个人的命名习惯。
试运行预览¶
提供预览模式：只展示将要移动的路径与分类结果，不实际改动磁盘上的文件，适合先确认规则再执行。
空文件夹清理与统计报告¶
整理完成后可清理空目录，并输出处理结果统计，便于核对移动数量与分类分布。
触发边界（官方说明）¶
适合触发：文件夹太乱需要整理、按类型归类、批量移动到不同子文件夹、整理下载目录、归类文档 / 照片 / 代码等。
不宜触发：仅针对单个文件的操作，或不需要分类归档的场景。
安装与启用¶
SkillHub 推荐通过 CLI 安装到当前 Agent 能识别的 skills 目录；也可用自然语言让 AI 按官方安装文档完成安装。
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、安装 file-organizer¶
安装时必须用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install @user_e4ae361c/file-organizer --dir <你的 skills 目录>
常见客户端 skills 路径（以 SkillHub 安装文档 为准）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下 .windsurf/skills/ |
也可向 Agent 发送官方页面提供的安装提示，让其根据 https://skillhub.cn/install/skillhub.md 安装 @user_e4ae361c/file-organizer。
安装后按所用客户端要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
官方未在页面列出固定 CLI 子命令；实际使用方式是在对话中说明目标路径和整理策略，由 Agent 调用本 Skill 执行。下面示例均对应官方描述的能力，表述可按需要调整。
按类型整理下载目录（建议先预览）
- 说明目录，例如：
~/Downloads。 - 要求先走试运行：「只预览，不要移动文件，按类型归类会放到哪些子文件夹」。
- 确认无误后再要求正式整理并生成统计报告。
按修改日期归档照片或日志
说明目标文件夹，并要求按文件修改日期建立 年/月/日 层级；若需例外类型，可同时说明自定义映射（例如某类扩展名仍进「文档」而不是按日期分）。
整理后收尾
在正式执行后，可要求清理空文件夹并输出本次移动的文件数量与分类汇总。
适用场景与注意¶
适合谁
- 本机或共享盘上目录长期堆积、扩展名混杂的用户。
- 需要 repeatable 规则（类型 + 可选日期 + 自定义映射）、且希望用对话改策略而不是改脚本的人。
使用注意
- 正式移动前优先使用试运行预览，避免误归档重要文件。
- Skill 面向批量分类整理；单文件操作应直接用系统或 Agent 常规文件能力，不必启用本 Skill。
- 社区来源 Skill，安装前可在 SkillHub 页面查看版本与说明；当前页面展示版本为 v1.0.1。
结尾¶
file-organizer 把「按类型、按日期、按自定义规则归档整夹文件」封装成 Agent Skill，并强调预览、空目录清理与结果统计，适合整理下载目录和杂项文件夹。需要安装或查看详情时，可访问 SkillHub 技能页 或元数据地址 https://api.skillhub.cn/user_e4ae361c/file-organizer。
