File Organizer

---
name: file-organizer
description: 通过理解上下文、查找重复项、建议更好的结构和自动化清理任务，智能地组织你计算机上的文件和文件夹。减少认知负担，无需手动努力即可保持数字工作空间整洁。
---

# 文件整理器

此技能作为你的个人组织助手，帮助你维护干净、逻辑的文件结构，无需持续手动组织的心理负担。

## 何时使用此技能

- 你的下载文件夹一片混乱
- 你找不到文件，因为它们到处散落
- 你有重复文件占用空间
- 你的文件夹结构不再有意义
- 你想建立更好的组织习惯
- 你正在启动新项目并需要良好结构
- 你正在清理并归档旧项目

## 此技能的功能

1. **分析当前结构**：审查你的文件夹和文件以了解你有什么
2. **查找重复项**：识别系统中的重复文件
3. **建议组织方式**：根据内容提出逻辑文件夹结构
4. **自动化清理**：经你批准后移动、重命名和组织文件
5. **维护上下文**：根据文件类型、日期和内容做出明智决策
6. **减少杂乱**：识别你可能不再需要的旧文件

## 如何使用

### 从你的主目录

```
cd ~
```

然后运行 Claude Code 并请求帮助：

```
帮我组织下载文件夹
```

```
在我的文档文件夹中查找重复文件
```

```
审查我的项目目录并建议改进
```

### 特定组织任务

```
根据这些下载内容将它们组织到适当的文件夹中
```

```
查找重复文件并帮我决定保留哪些
```

```
清理我 6 个月以上未触碰的旧文件
```

```
为我的 [工作/项目/照片等] 创建更好的文件夹结构
```

## 说明

当用户请求文件组织帮助时：

1. **了解范围**

   询问澄清问题：
   - 哪个目录需要组织？（下载、文档、整个主文件夹？）
   - 主要问题是什么？（找不到东西、重复项、太乱、没有结构？）
   - 有要避免的文件或文件夹吗？（当前项目、敏感数据？）
   - 组织程度多激进？（保守 vs 全面清理）

2. **分析当前状态**

   审查目标目录：
   ```bash
   # 获取当前结构概览
   ls -la [target_directory]

   # 检查文件类型和大小
   find [target_directory] -type f -exec file {} \; | head -20

   # 识别最大文件
   du -sh [target_directory]/* | sort -rh | head -20

   # 统计文件类型
   find [target_directory] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn
   ```

   总结发现：
   - 总文件和文件夹数
   - 文件类型细分
   - 大小分布
   - 日期范围
   - 明显的组织问题

3. **识别组织模式**

   根据文件确定逻辑分组：

   **按类型**：
   - 文档（PDF、DOCX、TXT）
   - 图像（JPG、PNG、SVG）
   - 视频（MP4、MOV）
   - 压缩包（ZIP、TAR、DMG）
   - 代码/项目（包含代码的目录）
   - 电子表格（XLSX、CSV）
   - 演示文稿（PPTX、KEY）

   **按用途**：
   - 工作 vs 个人
   - 活跃 vs 归档
   - 特定项目
   - 参考资料
   - 临时/草稿文件

   **按日期**：
   - 当前年/月
   - 往年
   - 非常旧（归档候选）

4. **查找重复项**

   当请求时，搜索重复项：
   ```bash
   # 通过哈希查找完全重复
   find [directory] -type f -exec md5 {} \; | sort | uniq -d

   # 查找同名文件
   find [directory] -type f -printf '%f\n' | sort | uniq -d

   # 查找大小相似的文件
   find [directory] -type f -printf '%s %p\n' | sort -n
   ```

   对于每组重复项：
   - 显示所有文件路径
   - 显示大小和修改日期
   - 推荐保留哪些（通常是最新的或命名最好的）
   - **重要**：删除前始终请求确认

5. **提出组织计划**

   在进行更改前提出清晰计划：

   ```markdown
   # [目录]组织计划

   ## 当前状态
   - Y 个文件夹中的 X 个文件
   - 总大小 [大小]
   - 文件类型：[细分]
   - 问题：[列出问题]

   ## 提议的结构

   ```
   [目录]/
   ├── 工作/
   │   ├── 项目/
   │   ├── 文档/
   │   └── 归档/
   ├── 个人/
   │   ├── 照片/
   │   ├── 文档/
   │   └── 媒体/
   └── 下载/
       ├── 待整理/
       └── 归档/
   ```

   ## 我将进行的更改

   1. **创建新文件夹**：[列表]
   2. **移动文件**：
      - X 个 PDF → 工作/文档/
      - Y 个图像 → 个人/照片/
      - Z 个旧文件 → 归档/
   3. **重命名文件**：[任何重命名模式]
   4. **删除**：[重复项或垃圾文件]

   ## 需要你决定的文件

   - [列出你不确定的文件]

   准备执行？（是/否/修改）
   ```

6. **执行组织**

   批准后，系统地组织：

   ```bash
   # 创建文件夹结构
   mkdir -p "path/to/new/folders"

   # 移动文件并清晰记录
   mv "old/path/file.pdf" "new/path/file.pdf"

   # 使用一致模式重命名文件
   # 示例："YYYY-MM-DD - 描述.ext"
   ```

   **重要规则**：
   - 删除任何内容前始终确认
   - 记录所有移动以便可能的撤销
   - 保留原始修改日期
   - 优雅处理文件名冲突
   - 遇到意外情况时停止并询问

7. **提供摘要和维护提示**

   组织后：

   ```markdown
   # 组织完成！✨

   ## 更改内容

   - 创建 [X] 个新文件夹
   - 组织 [Y] 个文件
   - 通过删除重复项释放 [Z] GB
   - 归档 [W] 个旧文件

   ## 新结构

   [展示新文件夹树]

   ## 维护提示

   要保持井井有条：

   1. **每周**：整理新下载
   2. **每月**：审查并归档已完成项目
   3. **每季度**：检查新重复项
   4. **每年**：归档旧文件

   ## 适合你的快速命令

   ```bash
   # 查找本周修改的文件
   find . -type f -mtime -7

   # 按类型整理下载
   [为其设置的自定义命令]

   # 查找重复项
   [自定义命令]
   ```

   想组织另一个文件夹吗？
   ```

## 示例

### 示例 1：组织下载（来自 Justin Dielmann）

**用户**："我的下载文件夹一团糟，有 500+ 个文件。帮我整理。"

**过程**：
1. 分析下载文件夹
2. 发现模式：工作文档、个人照片、安装程序、随机 PDF
3. 提出结构：
   - 下载/
     - 工作/
     - 个人/
     - 安装程序/（DMG、PKG 文件）
     - 归档/
     - 待整理/（需要决定的事项）
4. 请求确认
5. 根据内容和名称智能移动文件
6. 结果：500 个文件 → 5 个有组织的文件夹

### 示例 2：查找和删除重复项

**用户**："在我的文档中查找重复文件并帮我决定保留哪些。"

**输出**：
```markdown
# 发现 23 组重复项（共 156 MB）

## 重复组 1："proposal.pdf"
- `/Documents/proposal.pdf`（2.3 MB，修改于：2024-03-15）
- `/Documents/old/proposal.pdf`（2.3 MB，修改于：2024-03-15）
- `/Desktop/proposal.pdf`（2.3 MB，修改于：2024-03-10）

**建议**：保留 `/Documents/proposal.pdf`（正确位置中最新的）
删除其他 2 个副本吗？

[继续所有重复项...]
```

### 示例 3：重构项目文件夹

**用户**："审查我的 ~/Projects 目录并建议改进。"

**输出**：
```markdown
# ~/Projects 分析

## 当前结构问题
- 活跃和归档项目混在一起（3+ 年前的）
- 没有一致的命名约定
- 一些项目在根目录，其他在随机子文件夹中
- 重复文件夹（project-name、project-name-old、project-name-v2）

## 提议的结构

```
Projects/
├── 活跃/
│   ├── client-work/
│   ├── side-projects/
│   └── learning/
├── 归档/
│   ├── 2022/
│   ├── 2023/
│   └── 2024/
└── 模板/
```

## 具体更改
1. 移动 12 个自 2022 年未触碰的项目 → 归档/
2. 合并 4 个重复项目文件夹
3. 将项目重命名为一致格式："client-name-project-name"
4. 为旧工作创建归档

想让我实施这个吗？
```

### 示例 4：按日期组织照片

**用户**："按年份和月份组织我的照片文件夹。"

**输出**：创建如下结构：
```
Photos/
├── 2023/
│   ├── 01-January/
│   ├── 02-February/
│   └── ...
├── 2024/
│   ├── 01-January/
│   └── ...
└── 未整理/
```

然后根据 EXIF 数据或文件修改日期移动照片。

## 常见组织任务

### 下载清理
```
组织我的下载文件夹 - 将文档移至文档，
图像移至图片，保持安装程序独立，归档
3 个月以上的文件。
```

### 项目组织
```
审查我的项目文件夹结构，帮我分离活跃
项目和应该归档的旧项目。
```

### 重复项删除
```
在我的文档文件夹中查找所有重复文件，帮我
决定保留哪些。
```

### 桌面清理
```
我的桌面堆满文件。帮我将所有内容
适当地组织到文档文件夹中。
```

### 照片组织
```
根据拍摄日期按日期（年/月）组织
此文件夹中的所有照片。
```

### 工作/个人分离
```
帮我分离我的文档文件夹中的
工作文件和个人文件。
```

## 专业提示

1. **从小处开始**：从一个混乱的文件夹（如下载）开始建立信任
2. **定期维护**：每周对下载运行清理
3. **一致命名**：对重要文件使用"YYYY-MM-DD - 描述"格式
4. **积极归档**：将旧项目移至归档而非删除
5. **保持活跃独立**：在活跃和归档工作之间保持清晰边界
6. **信任过程**：让 Claude 处理东西放哪里的认知负担

## 最佳实践

### 文件夹命名
- 使用清晰、描述性的名称
- 避免空格（使用连字符或下划线）
- 要具体："client-proposals"而非"docs"
- 使用前缀排序："01-current"、"02-archive"

### 文件命名
- 包含日期："2024-10-17-meeting-notes.md"
- 要描述性："q3-financial-report.xlsx"
- 避免名称中的版本号（改用版本控制）
- 移除下载产物："document-final-v2 (1).pdf" → "document.pdf"

### 何时归档
- 6 个月以上未触碰的项目
- 可能稍后引用的已完成工作
- 迁移到新系统后的旧版本
- 你犹豫是否删除的文件（先归档）

## 相关用例

- 为新计算机设置组织
- 准备备份/归档文件
- 存储清理前清理
- 组织共享团队文件夹
- 构建新项目目录