前言¶
下载目录、桌面和项目旁路文件夹里，常会堆着截图、合同 PDF、录屏和零散脚本。手工建子目录、按扩展名拖拽，一次还能忍；隔几周再整理，文件名和路径都对不上，还容易误删。
下面介绍 SkillHub 上的社区 Skill「文件自动归档助手」。它面向「一键整理」场景：在 Agent 里启用后，由模型按 Skill 说明，结合你给出的目录与偏好，按文件类型、日期或关键词把文件归到对应分类（如图片、文档、视频、代码等）。适合已经用 Cursor、Claude Code 等支持 Skills 的客户端、又不想自己写整理脚本的人。
这是什么¶
文件自动归档助手（坐标 @user_e5701557/file-auto-archiver，版本 1.0.0）是 SkillHub 社区来源（community）的办公效率类 Skill，分类为 office-efficiency。发布者为 user_e5701557。
官方简介：自动按文件类型/日期/关键词整理归档文件，支持图片、文档、视频、代码等分类，帮你一键整理杂乱文件夹。页面标注 requires_api_key=false，即安装与使用不依赖额外 API Key 配置（以 SkillHub 页面标签为准）。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 1518 次，安装计数 0（平台展示字段，不代表本地未安装）。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_e5701557/file-auto-archiver
- API 坐标页：https://api.skillhub.cn/user_e5701557/file-auto-archiver
核心功能¶
以下能力均来自官方简介与 SkillHub 元数据，未在公开页写明的细节（例如具体目录树模板、是否移动或仅复制）不在此展开。
-
按文件类型分类
支持将常见类别归入不同归档方向，简介中明确提到：图片、文档、视频、代码等。 -
按日期整理
可按日期维度组织文件（具体以 Skill 安装后的SKILL.md与工作流为准）。 -
按关键词整理
可结合文件名或你提供的关键词规则做归类。 -
一键整理杂乱文件夹
面向「整个文件夹需要收口」的场景，通过对话让 Agent 执行归档，而不是手写一长串 shell 脚本。
安装与启用¶
SkillHub 官方推荐两种方式：用 SkillHub CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按安装文档操作。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（文档中的推荐命令）：
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
说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，客户端可能识别不到。
skillhub install @user_e5701557/file-auto-archiver --dir <你的 skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，请按你本机环境选用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
若你更习惯让 AI 代为安装，SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_e5701557/file-auto-archiver`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 被加载。
典型用法¶
公开 SkillHub 页面未附带独立命令行子工具说明，典型用法是：在已启用该 Skill 的对话里，说明要整理的根目录、是否允许移动/重命名、以及你偏好的维度（类型 / 日期 / 关键词）。
可复现的对话示例（路径请换成你机器上的真实目录）：
请使用文件自动归档助手，整理 ~/Downloads/待归档：
- 图片、文档、视频、代码分到不同子目录
- 文档再按修改日期分到 YYYY-MM 子文件夹
- 文件名包含「发票」的放进 Documents/发票
- 先列出计划移动的清单，我确认后再执行
经过上面的步骤，Agent 会依据 Skill 内的 SKILL.md 与工作流执行归类。若你对误移动敏感，务必在对话中要求「先预览清单再执行」，并在小目录上试跑。
适用场景与注意¶
适合谁
- 下载区、共享盘收件夹、活动素材夹等「多类型混放」的目录需要定期收口。
- 已使用 Cursor、Claude Code、Codex 等支持 Skills 的环境，希望用自然语言描述规则而不是维护自研脚本。
- 不需要为 Skill 单独配置 API Key（
requires_api_key=false）。
限制与注意
- 来源为 community，归档逻辑与边界以安装包内
SKILL.md为准；升级前可在 SkillHub 查看版本 1.0.0 是否有更新。 - 批量移动/重命名有风险：先备份或在副本目录验证，重要文件建议先「复制归档」再清理原位置（是否在 Skill 内默认移动，以实际 Skill 说明为准）。
skillhub install的--dir必须对准当前 Agent 的 skills 目录，装错位置会导致「已安装但对话里用不了」。- 平台展示的「安装 0」是 SkillHub 统计字段，与你在本机是否安装无关。
结尾¶
文件自动归档助手把「按类型、日期、关键词整理文件夹」收敛成可在 Agent 里触发的一类办公效率 Skill，适合处理长期堆积的杂乱目录。安装与路径配置以 SkillHub 文档为准；使用前在小范围目录试跑并确认移动策略。
Skill 主页：https://www.skillhub.cn/skills/user_e5701557/file-auto-archiver
