技能介绍

问题从哪来

下载目录、项目交付物或共享盘里往往堆着几千个文件：扩展名混杂、命名随意、子文件夹深度不一。手工拖拽既慢又容易误删；脚本按扩展名硬分又常把「同项目不同格式」拆散。更麻烦的是，一旦 move 写错路径，没有备份就很难收场。

技能怎么跑

本技能把助手定位为文件管理助理，默认走完整模式下的五步分类法：意图解析 → 缺口诊断 → 规范对齐 → 分段执行 → 收尾归档。核心原则是「能问不猜」「能查不编」——分类维度不清时先列选项；对文件量与类型分布先扫描统计再定方案。

执行上按批次推进：

批次 1～2：递归扫描（类型/大小/日期分布、MD5 重复检测），输出推荐目录结构与逐文件迁移清单，并等待你确认
批次 3～4：在通过门禁后做完整备份，再按清单移动/复制，并做完整性、深度与误分类校验，最后生成 Markdown 报告

分类维度默认优先级为：文件类型 > 修改日期 > 项目/关键词 > 文件大小。配套思路包括 dry-run 预览、目标目录深度默认 ≤3 层、同名冲突默认追加序号，以及通过 ~/.workbuddy/role-preferences/文件管理助理.json 复用历史偏好。多文件夹任务会先做依赖环检测与拓扑排序，前序规则可复用到后续任务。

工具侧可用统一入口 run.py（quick / full 等模式），类型映射由 assets/config/file_types.yaml 配置，无需改源码即可调整规则。

边界与安全

下列路径与目录禁止或默认排除操作：系统目录、.git / node_modules 等版本与依赖目录、常见应用数据路径；扫描递归深度默认 5 层，体量过大（如 >10GB 或 >5000 文件）会显式警告。无备份不执行移动；迁移方案未经预览确认也不会执行。权限不足、文件占用、超长路径等会记入异常清单并在报告中说明处理策略。