---
name: organize
description: 帮助用户整理文件夹结构。扫描目录、分类归档、清理冗余，输出整理方案并执行。当用户说"整理文件"、"文件夹好乱"、"归档"、"清理目录"、"/organize"时触发。
metadata:
  status: active
  status_updated_at: "2026-10-06"
---

# 文件夹整理助手

## 功能说明

帮助用户梳理混乱的文件夹，按归属分类、统一命名、清理冗余，让目录结构一目了然。

- `/organize` → 整理当前工作目录
- `/organize [路径]` → 整理指定目录

---

## 工作流程

### 第1步：扫描全貌

1. `ls -la` 查看根目录所有文件和文件夹（包括隐藏文件）
2. 对子目录做一层展开，了解内容
3. 记录文件总数、目录总数、散落文件数

**关注点**：
- 散落在根目录的文件（没有归入任何子目录的）
- 命名风格不统一的目录（如有的带前缀有的不带）
- 隐藏目录/文件（判断是工具产物还是用户文件）
- 疑似重复的文件（文件名相似的用 md5 比对）

### 第2步：分析归属

把所有文件和目录按**归属方**分类。常见的归属维度：

1. **按所有者**：客户的 / 内部的 / 个人的
2. **按类型**：文档 / 代码 / 设计 / 数据 / 媒体
3. **按状态**：活跃的 / 归档的 / 可删除的

**分类原则**：
- 优先按归属方分，同一归属方的东西放一起
- 已经成体系的目录结构不动（如有明确组织的子目录）
- 工具产生的临时文件/缓存/日志，归为"可清理"类

**判断"可清理"的标准**：
- 隐藏目录中只有 .DS_Store 或日志文件
- 工具运行产生的缓存/临时目录（如 .playwright-mcp、node_modules 等）
- 评测/调试的中间产物，已无后续使用价值
- 重复文件中较旧的那份（需 md5 确认后才算重复）

### 第3步：制定方案

输出整理方案，包含：

1. **目标结构**：用树形图展示整理后的目录结构
2. **操作清单**：
   - 新建哪些目录
   - 哪些文件/目录移动到哪里
   - 哪些目录/文件重命名
   - 哪些可以删除
3. **不动的部分**：明确哪些保持不变、为什么

**方案格式**：

```
整理后结构：
目标目录/
├── 分类A/
│   ├── ...
├── 分类B/
│   ├── ...
└── 保留不动的/

操作清单：
- [新建] 分类A/
- [移动] xxx → 分类A/xxx
- [重命名] yyy → zzz（统一命名风格）
- [删除] .cache/（工具缓存，无保留价值）
- [不动] 保留不动的/（已有结构，无需调整）
```

### 第4步：确认后执行

**必须等用户确认后再执行**。用户可能：
- 同意全部 → 直接执行
- 部分调整 → 按调整后的方案执行
- 只做清理不做分类 → 只执行删除部分

执行顺序：
1. 先建目录
2. 再移动文件（并行移动无依赖的文件）
3. 再重命名
4. 最后删除
5. 执行完 `ls -la` 验证结果

### 第5步：展示结果

输出整理后的目录树，标注变化。

---

## 核心原则

### 1. 按归属分，不按格式分

"客户A的方案.pptx" 应该放在 `客户A/` 下面，而不是放在 `PPT/` 下面。归属比格式重要。

### 2. 确认再动，不自作主张

整理方案必须给用户看过、确认后才执行。尤其是删除操作，宁可多问一句。

### 3. 统一命名风格

同级目录的命名风格要一致：
- 要么都带前缀，要么都不带
- 要么都用中文，要么都用英文
- 日期格式统一

### 4. 不动已有结构

如果某个子目录内部已经组织得很好，不要拆散重组。整理的目标是根目录清晰，不是追求完美对称。

### 5. 疑似重复先验证

文件名相似不代表内容相同。必须用 md5 比对确认后才能判定为重复。

### 6. 隐藏文件谨慎处理

以 `.` 开头的目录可能是工具配置（如 .claude、.git），不要随意移动或删除。只清理明确是缓存/日志的。