这个Skill 能自己整理电脑文件|一键虾用 & workbuddy可用

这篇就是它的说明书

一个帮你按「项目」而不是「文件类型」整理本地文件的 AI Skill。
适用于：[[CodeBuddy]] IDE 插件/WorkBuddy 桌面版

一键直达，下载或者贴给你的workbuddy就可以了！
https://github.com/leawhatever-superbubu/project-file-organizer

这个 Skill 能做什么？

你电脑上的 Downloads、Desktop、Documents 是不是堆满了各种散落文件？这个 Skill 可以：

扫描
你指定的目录，采样文件内容
AI 分类
—按项目/主题自动归类（不是按 .pdf .docx 归类，而是按「XXX项目」「YYY方案」归类）
生成报告
—先给你看分类计划，不会直接动你的文件
确认后执行
—你确认 OK 了才会真正移动文件

核心原则：先审后动，绝不擅自移动文件。

安装方式

方式一：手动放入目录（推荐，最简单）

[[CodeBuddy]] IDE 插件用户

把整个project-file-organizer文件夹放到你项目的.codebuddy/skills/目录下：

你的项目/└── .codebuddy/    └── skills/        └── project-file-organizer/   ← 放这里            ├── SKILL.md            ├── scripts/            └── ...

或者放到用户级目录（所有项目都能用）：

# macOS / Linuxmkdir-p ~/.codebuddy/skillscp-r project-file-organizer ~/.codebuddy/skills/# Windows# 复制到 %USERPROFILE%\.codebuddy\skills\ 下

WorkBuddy 桌面版用户

WorkBuddy 兼容 CodeBuddy 的 Skills 技能体系。操作方式：

打开 WorkBuddy
进入设置 → Skills 管理
点击右上角「导入 Skill」按钮
选择project-file-organizer文件夹导入

或者手动把文件夹放到 WorkBuddy 的 Skills 目录中。

方式二：从 GitHub 克隆

# 放到用户级 skills 目录cd ~/.codebuddy/skillsgit clone https://github.com/leawhatever-superbubu/project-file-organizer.git

方式三：CodeBuddy IDE 内导入

打开 CodeBuddy IDE 插件
进入设置 → Skills
点击右上角「导入 Skill」
粘贴 GitHub 仓库地址

配置（可选）

如果需要自定义 AI 模型或扫描参数：

cd project-file-organizercp config.example.json config.json# 编辑 config.json，填入你的 AI API 配置

不配置也能用，Skill 会使用 CodeBuddy/WorkBuddy 内置的 AI 能力。

怎么用？

安装好之后，直接在 CodeBuddy 或 WorkBuddy 的对话框里用自然语言说就行：

常用指令示例

你说的话	Skill 会做什么
`帮我整理一下 ~/Downloads`	扫描下载目录，按项目分类
`扫描一下桌面和文档，按项目归类`	多目录联合扫描
`整理 ~/Desktop，把工作相关的归到一起`	带意图提示的智能分类
`Organize my Downloads by project`	英文也支持

完整流程

你：帮我整理一下 ~/DownloadsAI：好的，我来扫描 ~/Downloads...    [扫描中，采样文件内容...]AI：扫描完成，共发现 156 个文件。以下是分类计划：    📁 MoneyBu项目 (23个文件)      - moneybu-design-v3.fig      - api-spec-final.pdf      - ...    📁 Q2营销方案 (15个文件)      - 2025Q2-campaign-brief.docx      - ...    📁 个人/杂项 (8个文件)      - ...    请确认是否按此计划执行？你：确认，执行吧AI：[移动文件中...] 完成！已整理 156 个文件到 12 个项目文件夹。

注意事项

隐私安全
所有处理在本地完成，文件不会上传到任何服务器
AI 分类
仅发送文件名和少量文本片段给 AI 模型进行分类判断
不可逆操作
移动文件前一定要仔细检查分类报告
建议先小范围试
第一次建议用一个小目录试试效果

遇到问题？

Skill 没有自动触发—确认文件夹已正确放置在.[[codebuddy]]/skills/下，重启 CodeBuddy/WorkBuddy
分类不准确
—可以在对话中给 AI 更多上下文，比如「这些主要是 XX 项目和 YY 项目的文件」
需要自定义分类规则
—查看
references/classification_strategy.md

License: MIT — 自由使用、修改、分发