前言¶

下载目录、桌面或项目旁的临时文件夹里，常会堆着混在一起的文档、截图、压缩包和安装包。手工按后缀建子目录再拖动，步骤重复，也容易漏文件或误移正在使用的路径。若希望把「读目录 → 按类型分桶 → 移动 → 汇总」交给对话里的 Agent 按固定流程执行，可以安装 SkillHub 上的社区 Skill「文件整理助手」（@user_c73fb2fe/file-organizer-skill-v2）。它用通用 SKILL.md 描述工作流，不依赖额外 API Key。

这是什么¶

「文件整理助手」是 SkillHub 社区发布者 user_c73fb2fe 维护的 Agent Skill，坐标 @user_c73fb2fe/file-organizer-skill-v2，当前页面版本为 1.0.1，分类为 knowledge-management，来源标记为 community。Skill 元数据标明 requires_api_key=false。

一句话定位：在用户提供的目标文件夹路径下，按文件扩展名把文件归入文档、图片、代码、压缩包、视频等子目录，并输出整理报告。Skill 声明可用工具为 Read、Write、Bash，且支持用户直接唤起（user-invocable: true）。

核心功能¶

以下能力均来自该 Skill 包内的 SKILL.md 工作流说明。

1. 扫描目标目录：读取指定文件夹中的文件列表。
2. 按扩展名分类，内置规则包括：
   - 文档：.doc / .docx / .pdf / .txt / .md
   - 图片：.jpg / .png / .gif / .svg / .webp
   - 代码：.js / .py / .html / .css / .ts
   - 压缩包：.zip / .rar / .7z / .tar.gz
   - 视频：.mp4 / .avi / .mov / .mkv
3. 创建子文件夹并移动：为每个类别建子目录，将文件移入对应位置。
4. 整理报告：完成后输出汇总说明。

Skill 的 description 字段将参数约定为「目标文件夹路径」，便于在对话里直接指定要整理的目录。

安装与启用¶

下面介绍两种常见安装方式：用 skillhub CLI 装到当前 Agent 的 skills 目录，或把官方提示词交给 Agent 自行安装。

1. 安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档 执行完整安装：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会落到 ./skills/，Agent 可能无法加载。

skillhub install file-organizer-skill-v2 --namespace user_c73fb2fe --dir <skills 目录>

各客户端常用路径（摘自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 中可示例为：

skillhub install file-organizer-skill-v2 --namespace user_c73fb2fe --dir ~/.cursor/skills/

3. 通过对话让 Agent 安装¶

SkillHub 技能页提供的安装话术为：请 Agent 根据 https://skillhub.cn/install/skillhub.md，安装 @user_c73fb2fe/file-organizer-skill-v2。

安装后通常需要重启或重新加载 Agent，以便识别新 Skill（以你所用客户端的文档为准）。

典型用法¶

经过上面的步骤启用 Skill 后，在对话中说明要整理的路径即可。Skill 描述中的参数为「目标文件夹路径」，例如：

用文件整理助手整理 ~/Downloads 里的文件，按 Skill 里的分类规则归档。

Agent 应按 Skill 内五步流程执行：列举文件 → 按扩展名归类 → 创建子文件夹 → 移动文件 → 输出整理报告。若路径含空格或中文，在让 Agent 执行 shell 时注意正确引用路径。

适用场景与注意¶

适合谁

• 需要定期清理下载目录、桌面或共享盘根目录的用户。
• 希望 Agent 按固定扩展名表分类，而不是每次重新口述规则的场景。

限制与注意

• Skill 正文只列出了上述扩展名集合；未列出的类型不会自动进入这五类，移动前宜先确认目录内容，或让 Agent 说明未匹配文件的处理方式。
• 工作流会直接创建子目录并移动文件，Skill 内未描述「仅预览、不改动」模式；重要目录请先备份，或在对话中明确要求先列出计划再执行。
• 允许使用 Bash 与 Write，整理范围应限定在你指定的目标文件夹，避免误动系统目录或正在开发的项目根目录。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 1561；安装量等数字以 SkillHub 展示为准，会随时间变化。

结尾¶

「文件整理助手」把按扩展名分桶、建子目录和写报告写进 SKILL.md，适合把重复的本地归类工作交给 Agent。无需 API Key，通过 SkillHub 即可安装。

• 技能页：https://www.skillhub.cn/skills/user_c73fb2fe/file-organizer-skill-v2
• API 坐标页：https://api.skillhub.cn/user_c73fb2fe/file-organizer-skill-v2
• 安装说明：https://skillhub.cn/install/skillhub.md