前言¶
下载目录、桌面或项目根目录里混着图片、文档、安装包和零散脚本时，手工拖进子文件夹既慢又容易漏。用脚本按扩展名批量移动可以解决问题，但每次要改规则、记路径，还要自己留一份「动了哪些文件」的清单，才能放心回滚。
下面介绍 SkillHub 上的社区 Skill「文件压缩」（坐标 @user_d581dca4/666，当前版本 v1.0.1）。它面向「指定目录内按文件类型归类」这一件事，并在官方说明里明确支持预览（dry-run）与撤销（undo），适合交给 Agent 在对话里执行，而不是自己维护一套整理脚本。
这是什么¶
「文件压缩」是发布者 user_d581dca4 在 SkillHub 提交的社区 Skill，分类为 office-efficiency，标签标明 requires_api_key=false，安装与使用不依赖额外 API Key。
名称容易让人联想到 zip 压缩，但官方简介描述的能力是：按文件类型整理指定目录中的文件，将图片、文档、视频、音频、压缩包、代码、可执行文件等自动归入对应文件夹。维护与版本信息以 SkillHub 页面为准。
核心功能¶
以下能力均来自 SkillHub 对该 Skill 的简介与元数据，未单独核实实现细节时不展开命令级行为。
- 按类型归类：对指定目录内的文件，按类型（图片、文档、视频、音频、压缩包、代码、可执行文件等）移动到对应子文件夹。
- 预览（dry-run）：在真正移动文件前可先预览将要执行的操作，降低误整理风险。
- 撤销（undo）：整理后若结果不符合预期，可通过 Skill 提供的撤销能力回退（具体交互由 Agent 读取 Skill 内
SKILL.md后执行）。
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 根据官方安装文档安装坐标 @user_d581dca4/666。文档地址为 https://skillhub.cn/install/skillhub.md。
若本机已安装 SkillHub CLI，可先检查版本，再安装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认装到 ./skills/，Agent 可能无法识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，可按安装文档执行完整安装（含 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
安装本 Skill 到对应 Agent 的 skills 目录（路径按环境替换 <skills 目录>）：
skillhub install @user_d581dca4/666 --dir <skills 目录>
安装文档中列出的常用 skills 目录示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中直接发送 SkillHub 页面提示的安装话术，由 Agent 按 skillhub.md 完成安装。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录位置；安装命令形式一致，差异以各客户端实际目录为准。
典型用法¶
官方页面未提供独立 CLI 示例外，用法应通过已启用的 Agent 触发 Skill 内说明的工作流。结合简介，可复现的意图如下（表述为对话指令，而非编造脚本接口）：
- 指定待整理目录（例如某下载文件夹或项目下的
misc目录）。 - 要求先 dry-run / 预览，确认各类文件将落入哪些子文件夹。
- 确认无误后执行正式整理。
- 若归类结果不对，要求 undo / 撤销，再调整目录或规则后重试。
示例提示（安装并启用 Skill 后）：
请使用「文件压缩」Skill：对 ~/Downloads 先 dry-run 预览按类型整理的结果，我确认后再执行，并保留可 undo 的方式。
具体子文件夹命名、扩展名映射与撤销机制以 Skill 包内 SKILL.md 为准；本文不臆造字段名或脚本路径。
适用场景与注意¶
适合谁
- 需要定期清理下载目录、共享盘或本地「杂物堆」文件夹的开发者或办公用户。
- 希望用自然语言指定目录、预览再执行，而不是每次手写
mv或维护分类脚本的团队。
限制与注意
- 能力边界以官方简介为准：是按类型移动归类，不是对文件做 zip 等压缩归档；命名与功能以简介描述为准。
- 整理前务必先 dry-run；对含未保存工作、正在被其他程序占用的目录应谨慎，避免 Agent 在无预览时直接移动。
- SkillHub 元数据：来源
community，评分 100000，下载 2448（统计以页面展示为准，会随时间变化）。 - 不涉及 API Key，但仍建议在重要目录上先小范围试跑预览。
结尾¶
「文件压缩」把「按类型整理指定目录、支持预览与撤销」封装成标准 Skill，适合挂在 Cursor、Claude Code 等支持 SkillHub 安装的 Agent 上，用对话完成目录治理。官方介绍与安装入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_d581dca4/666
- API 坐标页：https://api.skillhub.cn/user_d581dca4/666
安装文档：https://skillhub.cn/install/skillhub.md
