file-organizer

name	file-organizer
description	透過理解上下文、尋找重複項目、建議更好的結構，以及自動化清理任務，智慧地組織您電腦中的檔案和資料夾。減少認知負擔，保持您的數位工作空間整潔，無需手動費力。

檔案整理器

此技能作為您的個人整理助手，協助您維護整個電腦中清晰、合理的檔案結構，而無需持續手動整理的心理負擔。

何時使用此技能

• 您的「下載」資料夾一團混亂
• 因為檔案散落各處而找不到檔案
• 您有重複的檔案佔用空間
• 您的資料夾結構不再合理
• 您想建立更好的組織習慣
• 您正在開始新專案並需要良好的結構
• 您正在封存舊專案前進行清理

此技能的功能

1. 分析現有結構：檢視您的資料夾和檔案以了解您擁有什麼
2. 尋找重複項目：識別系統中的重複檔案
3. 建議組織方式：根據您的內容提出合理的資料夾結構
4. 自動化清理：經您同意後移動、重新命名和整理檔案
5. 維護上下文：根據檔案類型、日期和內容做出明智決策
6. 減少雜亂：識別您可能不再需要的舊檔案

如何使用

從您的主目錄開始

cd ~

然後執行 Claude Code 並尋求協助：

協助我整理「下載」資料夾

在我的「文件」資料夾中尋找重複檔案

檢視我的專案目錄並建議改進方式

特定整理任務

根據這些下載的檔案類型將它們整理到適當的資料夾中

尋找重複檔案並協助我決定要保留哪些

清理我 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. 尋找重複項目

   When requested, search for duplicates:

   # Find exact duplicates by hash
   find [directory] -type f -exec md5 {} \; | sort | uniq -d
   
   # Find files with same name
   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. 執行整理

   獲得批准後，系統化地整理：

   # 建立資料夾結構
   mkdir -p "path/to/new/folders"
   
   # 移動檔案並清楚記錄
   mv "old/path/file.pdf" "new/path/file.pdf"
   
   # 使用一致的模式重新命名檔案
   # 範例：「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
   
   ```bash
   # Find files modified this week
   find . -type f -mtime -7
   
   # Sort downloads by type
   [custom command for their setup]
   
   # Find duplicates
   [custom command]
   

   Want to organize another folder?

Examples

Example 1: Organizing Downloads (From Justin Dielmann)

User: "My Downloads folder is a mess with 500+ files. Help me organize it."

Process:

1. Analyzes Downloads folder
2. Finds patterns: work docs, personal photos, installers, random PDFs
3. Proposes structure:
   • Downloads/
     • Work/
     • Personal/
     • Installers/ (DMG, PKG files)
     • Archive/
     • ToSort/ (things needing decisions)
4. Asks for confirmation
5. Moves files intelligently based on content and names
6. Results: 500 files → 5 organized folders

Example 2: Finding and Removing Duplicates

User: "Find duplicate files in my Documents and help me decide which to keep."

Output:

# 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...]

Example 3: Restructuring Projects Folder

User: "Review my ~/Projects directory and suggest improvements."

Output:

# Analysis of ~/Projects

## Current Structure Issues
- Mix of active and archived projects (3+ years old)
- No consistent naming convention
- Some projects at root, others in random subfolders
- Duplicate folders (project-name, project-name-old, project-name-v2)

## Proposed Structure

Projects/ ├── Active/ │ ├── client-work/ │ ├── side-projects/ │ └── learning/ ├── Archive/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Templates/

## Specific Changes
1. Move 12 projects not touched since 2022 → Archive/
2. Consolidate 4 duplicate project folders
3. Rename projects to consistent format: "client-name-project-name"
4. Create Archive for old work

Want me to implement this?

Example 4: Organizing Photos by Date

User: "Organize my photo folders by year and month."

Output: Creates structure like:

Photos/
├── 2023/
│   ├── 01-January/
│   ├── 02-February/
│   └── ...
├── 2024/
│   ├── 01-January/
│   └── ...
└── Unsorted/

Then moves photos based on EXIF data or file modification dates.

Common Organization Tasks

Downloads Cleanup

Organize my Downloads folder - move documents to Documents, 
images to Pictures, keep installers separate, and archive files 
older than 3 months.

Project Organization

Review my Projects folder structure and help me separate active 
projects from old ones I should archive.

Duplicate Removal

Find all duplicate files in my Documents folder and help me 
decide which ones to keep.

Desktop Cleanup

My Desktop is covered in files. Help me organize everything into 
my Documents folder properly.

Photo Organization

Organize all photos in this folder by date (year/month) based 
on when they were taken.

Work/Personal Separation

Help me separate my work files from personal files across my 
Documents folder.

Pro Tips

1. Start Small: Begin with one messy folder (like Downloads) to build trust
2. Regular Maintenance: Run weekly cleanup on Downloads
3. Consistent Naming: Use "YYYY-MM-DD - Description" format for important files
4. Archive Aggressively: Move old projects to Archive instead of deleting
5. Keep Active Separate: Maintain clear boundaries between active and archived work
6. Trust the Process: Let Claude handle the cognitive load of where things go

Best Practices

Folder Naming

• Use clear, descriptive names
• Avoid spaces (use hyphens or underscores)
• Be specific: "client-proposals" not "docs"
• Use prefixes for ordering: "01-current", "02-archive"

File Naming

• Include dates: "2024-10-17-meeting-notes.md"
• Be descriptive: "q3-financial-report.xlsx"
• Avoid version numbers in names (use version control instead)
• Remove download artifacts: "document-final-v2 (1).pdf" → "document.pdf"

When to Archive

• Projects not touched in 6+ months
• Completed work that might be referenced later
• Old versions after migration to new systems
• Files you're hesitant to delete (archive first)

Related Use Cases

• Setting up organization for a new computer
• Preparing files for backup/archiving
• Cleaning up before storage cleanup
• Organizing shared team folders
• Structuring new project directories