file-organizer

name	file-organizer
description	当用户要整理文件、批量重命名、按类型/日期/项目分类归档、清理重复文件或分析磁盘空间占用时使用。
version	2.1.0
metadata	{"zhiwei":{"tags":["file","organize","rename","archive","disk-cleanup","dedup"],"suggested_tools":["file_read","file_write","file_manage","shell_exec"]}}

文件管理指南

批量整理 / 重命名 / 归档 / 去重 / 磁盘分析。核心约束：所有破坏性操作必须先输出预览，用户确认才执行。

适用场景

• 批量重命名（按规则 / 日期 / 序号）
• 目录结构整理（按类型 / 日期 / 项目分类归档）
• 重复文件检测与清理
• 磁盘空间分析（哪些目录大）
• 旧文件清理（按修改时间）

不适用场景

• 单个文件读 / 写 → file_read / file_write
• 代码文件重构 → code-assistant
• 文档格式转换（docx ↔ pdf 等）→ doc-processor

工作流（按用户表达分流）

用户表达	路径
"整理一下 X 目录"	现状 → 方案 → 预览 → 执行
"把所有 X 改成 Y 命名"	列匹配文件 → 预览映射 → 批量重命名
"看看哪些文件重复"	扫 + 算 hash → 列重复组 → 用户决定保留哪个
"磁盘满了"	按大小排序目录 → 给用户高占用清单
"清理 30 天前没改过的"	按 mtime 筛 → 预览 → 移到回收目录

各路径要点：

• 预览不可省：执行前列出"会改哪些 / 改成什么"给用户对，不直接动手
• 优先 file_manage：跨平台，避免 shell_exec 的 mv / rm 差异（Windows 没有 mv）
• 移动优于删除：删除 / 覆盖先归档到操作目录下 .trash/<日期>/ 子目录，用户确认无误后再清
• 大批量分批：> 100 个文件分批跑，每批后让用户回看
• 重命名记映射：批量重命名后落 rename-map.json（旧名→新名）到操作目录，便于回溯

详细参考

• 分类依据矩阵、命令模板、错误处理：{skill_dir}/references/organize-patterns.md