前言¶

下载目录、桌面或项目根目录里混着 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