file-organizer

文件整理

这项技能充当你的个人整理助手，帮助你在电脑上维护整洁、合理的文件结构，无需时刻手动整理，减轻心智负担。

何时使用这项技能

• 你的 Downloads 文件夹乱成一团
• 文件散落各处，让你找不到
• 有重复文件占用了空间
• 你的文件夹结构已经不再合理
• 你想养成更好的整理习惯
• 你要开始一个新项目，需要合适的目录结构
• 你要清理旧项目并归档

这项技能的功能

1. 分析当前结构：检查你的文件夹和文件，了解现有内容
2. 查找重复文件：识别系统中的重复文件
3. 提出整理建议：根据你的内容提出合理的文件夹结构
4. 自动清理：经你批准后，移动、重命名和整理文件
5. 保留上下文：根据文件类型、日期和内容做出明智的决定
6. 减少杂乱：找出你可能不再需要的旧文件

使用方法

从你的主目录开始

cd ~

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

Help me organize my Downloads folder

Find duplicate files in my Documents folder

Review my project directories and suggest improvements

特定整理任务

Organize these downloads into proper folders based on what they are

Find duplicate files and help me decide which to keep

Clean up old files I haven't touched in 6+ months

Create a better folder structure for my [work/projects/photos/etc]

说明

安全警告：这项技能涉及移动和删除文件。删除任何文件前，必须始终明确征求用户确认。移动大量文件时，确保有办法撤销操作或记录操作。

当用户请求文件整理帮助时：

1. 了解范围

   提出澄清问题：

   • 哪个目录需要整理？（Downloads、Documents、整个主文件夹？）
   • 主要问题是什么？（找不到文件、有重复文件、太杂乱、缺乏结构？）
   • 有没有要避开的文件或文件夹？（当前项目、敏感数据？）
   • 希望整理到什么程度？（保守整理还是全面清理）

2. 分析当前状况

   检查目标目录，了解：

   • 文件和文件夹总数
   • 文件类型分布
   • 大小分布
   • 日期范围
   • 明显的整理问题

3. 识别整理规律

   根据文件确定合理的分类方式：

   按类型：

   • 文档（PDF、DOCX、TXT）
   • 图片（JPG、PNG、SVG）
   • 视频（MP4、MOV）
   • 归档文件（ZIP、TAR、DMG）
   • 代码/项目（包含代码的目录）
   • 电子表格（XLSX、CSV）
   • 演示文稿（PPTX、KEY）

   按用途：

   • 工作与个人
   • 进行中与归档
   • 特定项目
   • 参考资料
   • 临时/草稿文件

   按日期：

   • 当前年份/月份
   • 之前的年份
   • 很久以前的文件（可考虑归档）

4. 查找重复文件

   用户提出请求时，使用可用的系统工具搜索重复文件。

   注意：除非确定当前环境，否则避免使用平台专属标志（例如 Linux/Windows 上的 find -printf 或 md5）。

   方法：

   • 完全重复：比较文件哈希值（根据操作系统使用 shasum、cksum 或 md5sum）。
   • 名称重复：查找文件名相同的文件。
   • 大小重复：先查找大小相同的文件。

   对每组重复文件：

   • 显示所有文件路径
   • 显示文件大小和修改日期
   • 建议保留哪些文件（通常保留最新的或命名最合适的）
   • 重要：删除前始终征求确认

5. 提出整理方案

   在做出更改前，先给出清晰的方案：

   # Organization Plan for [Directory]
   
   ## Current State
   
   - X files across Y folders
   - [Size] total
   - File types: [breakdown]
   - Issues: [list problems]
   
   ## Proposed Structure
   
   [Directory]/
   ├── Work/
   │ ├── Projects/
   │ ├── Documents/
   │ └── Archive/
   ├── Personal/
   │ ├── Photos/
   │ ├── Documents/
   │ └── Media/
   └── Downloads/
   ├── To-Sort/
   └── Archive/
   
   ## Changes I'll Make
   
   1. **Create new folders**: [list]
   2. **Move files**:
      - X PDFs -> Work/Documents/
      - Y images -> Personal/Photos/
      - Z old files -> Archive/
   3. **Rename files**: [any renaming patterns]
   4. **Delete**: [duplicates or trash files]
   
   ## Files Needing Your Decision
   
   - [List any files you're unsure about]
   
   Ready to proceed? (yes/no/modify)
   

示例

示例 1：整理下载内容（来自 Justin Dielmann）

用户：“我的 Downloads 文件夹里乱糟糟的，有 500 多个文件。帮我整理一下。”

流程：

1. 分析 Downloads 文件夹
2. 找出规律：工作文档、个人照片、安装程序、零散的 PDF
3. 提出目录结构：
   • Downloads/
     • Work/
     • Personal/
     • Installers/（DMG、PKG 文件）
     • Archive/
     • ToSort/（需要决定如何处理的内容）
4. 请求确认
5. 根据文件内容和名称智能地移动文件
6. 结果：将 500 个文件整理到 5 个文件夹中

示例 2：查找并删除重复文件

用户：“在我的 Documents 文件夹里查找重复文件，并帮我决定保留哪些文件。”

输出：

# Found 23 Sets of Duplicates (156 MB total)

## Duplicate Set 1: "proposal.pdf"

- `/Documents/proposal.pdf` (2.3 MB, modified: 2024-03-15)
- `/Documents/old/proposal.pdf` (2.3 MB, modified: 2024-03-15)
- `/Desktop/proposal.pdf` (2.3 MB, modified: 2024-03-10)

**Recommendation**: Keep `/Documents/proposal.pdf` (most recent in correct location)
Delete the other 2 copies?

[Continue for all duplicates...]

最佳实践

文件夹命名

• 使用清晰、描述性强的名称
• 避免使用空格（使用连字符或下划线）
• 指定具体内容：“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 个月或更长时间未处理的项目
• 之后可能会用到的已完成工作
• 迁移到新系统后留下的旧版本
• 不确定是否该删除的文件（先归档）