file-organizer
通过理解上下文、查找重复文件、建议结构化和自动化清理来组织文件和文件夹。当用户提到杂乱的下载、找不到文件、重复文件、文件夹结构问题、清理任务,或请求组织/排序/整理文件和目录时使用。
name: file-organizer description: Organises files and folders by understanding context, finding duplicates, suggesting structures, and automating cleanup. Use when user mentions messy Downloads, can't find files, duplicate files, folder structure problems, cleanup tasks, or asks to organise/sort/tidy files and directories.
File Organizer
Helps maintain clean, logical file structures without manual overhead.
Workflow
1. Scope the Task
Ask if unclear:
- Which directory? (Downloads, Documents, specific path?)
- Main problem? (Chaos, duplicates, no structure, can't find things?)
- Anything to avoid? (Active projects, sensitive folders?)
- How aggressive? (Conservative vs comprehensive?)
2. Analyse Current State
Use Desktop Commander to survey:
# Overview
Get-ChildItem -Path $targetPath -Recurse | Measure-Object
# File types breakdown
Get-ChildItem -Path $targetPath -Recurse -File | Group-Object Extension | Sort-Object Count -Descending
# Largest files
Get-ChildItem -Path $targetPath -Recurse -File | Sort-Object Length -Descending | Select-Object -First 20 FullName, @{N='SizeMB';E={[math]::Round($_.Length/1MB,2)}}
# Old files (not modified in 6 months)
Get-ChildItem -Path $targetPath -Recurse -File | Where-Object { $_.LastWriteTime -lt (Get-Date).AddMonths(-6) }
Summarise: total files, type breakdown, size distribution, obvious issues.
3. Identify Organisation Patterns
Group by what makes sense for the content:
By Type: Documents, Images, Videos, Archives, Code, Spreadsheets, Installers By Purpose: Work/Personal, Active/Archive, Project-specific, Reference, Temporary By Date: Current year, Previous years, Ancient (archive candidates)
4. Find Duplicates (when requested)
# Find by identical hash
Get-ChildItem -Path $targetPath -Recurse -File | Get-FileHash | Group-Object Hash | Where-Object { $_.Count -gt 1 }
# Find by name
Get-ChildItem -Path $targetPath -Recurse -File | Group-Object Name | Where-Object { $_.Count -gt 1 }
For each duplicate set: show paths, sizes, dates, recommend which to keep. Always confirm before deleting.
5. Propose Organisation Plan
Present before making changes:
## Current State
- X files across Y folders
- [Size] total
- Issues: [list]
## Proposed Structure
[Show folder tree]
## Changes
1. Create folders: [list]
2. Move files: [summary by category]
3. Archive: [old files]
4. Delete: [duplicates - with confirmation]
## Needs Your Decision
- [Ambiguous files]
Ready to proceed?
6. Execute
After approval:
- Create folder structure first
- Move files systematically
- Log all operations
- Confirm before any deletion
- Stop and ask if anything unexpected
7. Summarise
## Complete
- Created X folders
- Organised Y files
- Freed Z GB (duplicates)
- Archived W old files
## New Structure
[Folder tree]
## Maintenance Tips
- Weekly: Sort new downloads
- Monthly: Review completed projects
- Quarterly: Check for duplicates
Common Patterns
Downloads Cleanup: Sort by type (docs→Documents, images→Pictures, installers→separate), archive old files.
Project Organisation: Separate Active from Archive, consolidate duplicates, consistent naming.
Duplicate Removal: Hash-based detection, keep newest/best-named, confirm each deletion.
Photo Organisation: By EXIF date or file date into Year/Month structure.
Key Rules
- Never delete without confirmation - even obvious duplicates
- Preserve modification dates when moving
- Stop on unexpected situations - don't assume
- Log operations for potential undo
- Archive before delete when in doubt