技能介绍

要解决的问题

桌面和 Downloads/ 目录用几个月就会变成一堆无人维护的文件：截图、PDF、代码片段、临时导出的音频混在一起，找文件只能靠 ls 加回忆。手工整理成本高且不可持续；写脚本批量移动又容易误伤正在使用的项目目录。文件组织大师把这件事交给 AI 代理：给它一个目标路径和组织策略，它会先扫描、再分类、生成一份可审查的移动计划，确认后才真正落盘。

核心能力

递归扫描与元数据收集：遍历目录，记录文件名、扩展名、大小、创建/修改时间，并对内容计算 SHA-256（按需触发，用于查重）。默认跳过 .DS_Store、Thumbs.db 等隐藏/系统文件，也可在配置中包含它们。
可插拔的分类策略：默认按文件类型分组（.pdf → documents/，.png → images/，.mp3 → audio/）；也支持按修改日期（2025/01/）、按项目前缀或文件名标签推断项目、按文件名中的优先级标记（如 URGENT-report.pdf → priority-high/）。可以用 YAML 或 JSON 自定义规则覆盖或扩展。
基于内容哈希的查重：发现重复时保留最近修改的一份，旧副本进入 _duplicates/ 暂存目录，删除前先给出摘要供用户确认；可选改为指向正本的符号链接。
命名规范统一：支持 kebab-case、snake_case、日期前缀等，可去特殊字符、压缩空白、Unicode 转 ASCII，保留原扩展名；每次重命名都写入日志，操作可回退。
dry-run 优先的执行流程：默认不直接移动文件，而是先输出完整的源→目标计划并请求确认；执行时按需创建目录、原子移动，并在目标根目录写 _organization-log.json 作为回滚依据。
过期文件归档：按可配置阈值（默认 12 个月未访问/修改）把陈旧文件移入 _archive/，可选打包为 .tar.gz 或 .zip，并汇报释放的磁盘空间。

适用边界与注意点

首次使用务必从 dry-run 开始；不要在未审阅计划前直接执行。若目标目录在 Git 仓库内，优先使用 git mv 而不是原生移动，并且存在未提交改动时先提醒。默认排除 node_modules/、.git/、__pycache__/、vendor/ 等包管理器/工具管理的目录，避免破坏依赖结构。目标路径冲突时追加数字后缀（report-1.pdf）而不是静默覆盖；移动完成后用扫描阶段记录的哈希校验文件完整性。扫描时不要跟随符号链接，遇到链接先记录再询问用户意图。超大目录（>10,000 文件）需要分批处理并给出进度，权限错误则记录并跳过、最后汇总。网络盘和外部驱动器上的整理会明显更慢，中断后可能处于不一致状态，建议先复制到本地再操作。