| name | organize |
| description | 帮助用户整理文件夹结构。扫描目录、分类归档、清理冗余，输出整理方案并执行。当用户说"整理文件"、"文件夹好乱"、"归档"、"清理目录"、"/organize"时触发。 |
文件夹整理助手
功能说明
帮助用户梳理混乱的文件夹，按归属分类、统一命名、清理冗余，让目录结构一目了然。
/organize → 整理当前工作目录/organize [路径] → 整理指定目录
工作流程
第1步：扫描全貌
ls -la 查看根目录所有文件和文件夹（包括隐藏文件）- 对子目录做一层展开，了解内容
- 记录文件总数、目录总数、散落文件数
关注点：
- 散落在根目录的文件（没有归入任何子目录的）
- 命名风格不统一的目录（如有的带前缀有的不带）
- 隐藏目录/文件（判断是工具产物还是用户文件）
- 疑似重复的文件（文件名相似的用 md5 比对）
第2步：分析归属
把所有文件和目录按归属方分类。常见的归属维度：
- 按所有者：客户的 / 内部的 / 个人的
- 按类型：文档 / 代码 / 设计 / 数据 / 媒体
- 按状态：活跃的 / 归档的 / 可删除的
分类原则：
- 优先按归属方分，同一归属方的东西放一起
- 已经成体系的目录结构不动（如有明确组织的子目录）
- 工具产生的临时文件/缓存/日志，归为"可清理"类
判断"可清理"的标准：
- 隐藏目录中只有 .DS_Store 或日志文件
- 工具运行产生的缓存/临时目录（如 .playwright-mcp、node_modules 等）
- 评测/调试的中间产物，已无后续使用价值
- 重复文件中较旧的那份（需 md5 确认后才算重复）
第3步：制定方案
输出整理方案，包含：
- 目标结构：用树形图展示整理后的目录结构
- 操作清单：
- 新建哪些目录
- 哪些文件/目录移动到哪里
- 哪些目录/文件重命名
- 哪些可以删除
- 不动的部分：明确哪些保持不变、为什么
方案格式：
整理后结构：
目标目录/
├── 分类A/
│ ├── ...
├── 分类B/
│ ├── ...
└── 保留不动的/
操作清单：
- [新建] 分类A/
- [移动] xxx → 分类A/xxx
- [重命名] yyy → zzz（统一命名风格）
- [删除] .cache/（工具缓存，无保留价值）
- [不动] 保留不动的/（已有结构，无需调整）
第4步：确认后执行
必须等用户确认后再执行。用户可能：
- 同意全部 → 直接执行
- 部分调整 → 按调整后的方案执行
- 只做清理不做分类 → 只执行删除部分
执行顺序：
- 先建目录
- 再移动文件（并行移动无依赖的文件）
- 再重命名
- 最后删除
- 执行完
ls -la 验证结果
第5步：展示结果
输出整理后的目录树，标注变化。
核心原则
1. 按归属分，不按格式分
"客户A的方案.pptx" 应该放在 客户A/ 下面，而不是放在 PPT/ 下面。归属比格式重要。
2. 确认再动，不自作主张
整理方案必须给用户看过、确认后才执行。尤其是删除操作，宁可多问一句。
3. 统一命名风格
同级目录的命名风格要一致：
- 要么都带前缀，要么都不带
- 要么都用中文，要么都用英文
- 日期格式统一
4. 不动已有结构
如果某个子目录内部已经组织得很好，不要拆散重组。整理的目标是根目录清晰，不是追求完美对称。
5. 疑似重复先验证
文件名相似不代表内容相同。必须用 md5 比对确认后才能判定为重复。
6. 隐藏文件谨慎处理
以 . 开头的目录可能是工具配置（如 .claude、.git），不要随意移动或删除。只清理明确是缓存/日志的。
