file-organizer

文件整理器

何时使用此技能

• 你的下载文件夹一片混乱
• 你找不到文件，因为它们散落各处
• 你有重复文件占用空间
• 你的文件夹结构已经不再合理
• 你想建立更好的整理习惯
• 你正在启动一个新项目，需要一个好的结构
• 你在归档旧项目之前进行清理

此技能做什么

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

说明

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

1. 了解范围

   提出澄清性问题：

   • 哪个目录需要整理？（下载、文档、整个主文件夹？）
   • 主要问题是什么？（找不到东西、重复文件、太杂乱、没有结构？）
   • 有什么文件或文件夹需要避开？（当前项目、敏感数据？）
   • 整理的力度如何？（保守 vs. 全面清理）

2. 分析当前状态

   查看目标目录：

   # Get overview of current structure
   ls -la [target_directory]
   
   # Check file types and sizes
   find [target_directory] -type f -exec file {} \; | head -20
   
   # Identify largest files
   du -sh [target_directory]/* | sort -rh | head -20
   
   # Count file types
   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. 查找重复项

   在被要求时，搜索重复项：

   # Find exact duplicates by hash
   find [directory] -type f -exec md5 {} \; | sort | uniq -d
   
   # Find files with similar names
   find [directory] -type f -printf '%f\n' | sort | uniq -d
   
   # Find similar-sized files
   find [directory] -type f -printf '%s %p\n' | sort -n
   

   对于每一组重复项：

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

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)
   

6. 执行整理

   在获得批准后，系统地进行整理：

   # Create folder structure
   mkdir -p "path/to/new/folders"
   
   # Move files with clear logging
   mv "old/path/file.pdf" "new/path/file.pdf"
   
   # Rename files with consistent patterns
   # Example: "YYYY-MM-DD - Description.ext"
   

   重要规则：

   • 删除任何内容前始终确认
   • 记录所有移动操作以便可能撤销
   • 保留原始修改日期
   • 妥善处理文件名冲突
   • 如果遇到意外情况，停下来询问

7. 提供总结和维护建议

   整理之后：

   # Organization Complete! ✨
   
   ## What Changed
   
   - Created [X] new folders
   - Organized [Y] files
   - Freed [Z] GB by removing duplicates
   - Archived [W] old files
   
   ## New Structure
   
   [Show the new folder tree]
   
   ## Maintenance Tips
   
   To keep this organized:
   
   1. **Weekly**: Sort new downloads
   2. **Monthly**: Review and archive completed projects
   3. **Quarterly**: Check for new duplicates
   4. **Yearly**: Archive old files
   
   ## Quick Commands for You
   
   # Find files modified this week
   
   find . -type f -mtime -7
   
   # Sort downloads by type
   
   [custom command for their setup]
   
   # Find duplicates
   
   [custom command]
   

   想整理另一个文件夹吗？

最佳实践

文件夹命名

• 使用清晰、描述性的名称
• 避免空格（使用连字符或下划线）
• 要具体："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 个月以上未触碰的项目
• 以后可能被引用的已完成工作
• 迁移到新系统后的旧版本
• 你犹豫是否删除的文件（先归档）