file-organizer

ファイル整理

このスキルを使う場面

• ダウンロードフォルダーが散らかっている
• ファイルがあちこちに散在していて見つけられない
• 重複ファイルが容量を圧迫している
• フォルダー構成がわかりにくくなっている
• よりよい整理習慣を身につけたい
• 新しいプロジェクトを始めるにあたり、適切な構成が必要
• 古いプロジェクトをアーカイブする前に整理したい

このスキルでできること

1. 現在の構成を分析：フォルダーとファイルを確認し、現在の内容を把握します
2. 重複ファイルを検出：システム内の重複ファイルを特定します
3. 整理方法を提案：内容に基づいて、論理的なフォルダー構成を提案します
4. 整理を自動化：承認を得てファイルを移動、名前変更、整理します
5. コンテキストを考慮：ファイルの種類、日付、内容に基づいて適切に判断します
6. 散らかりを減らす：もう必要ない可能性が高い古いファイルを特定します

手順

ユーザーからファイル整理の支援を依頼された場合：

1. 対象範囲を把握する

   確認のための質問をします：

   • どのディレクトリを整理しますか？（ダウンロード、書類、ホームフォルダー全体など）
   • 主な問題は何ですか？（見つけられない、重複がある、散らかりすぎている、構成がないなど）
   • 対象外にするファイルやフォルダーはありますか？（進行中のプロジェクト、機密データなど）
   • どの程度整理しますか？（控えめな整理か、徹底的な整理か）

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）

   目的別：

   • 仕事用と個人用
   • 進行中とアーカイブ
   • プロジェクト別
   • 参考資料
   • 一時ファイル／作業用ファイル

   日付別：

   • 今年／今月
   • 過去の年
   • 非常に古いファイル（アーカイブ候補）

4. 重複ファイルを検出する

   依頼された場合は、重複ファイルを検索します：

   # Find exact duplicates by hash
   find [directory] -type f -exec shasum -a 256 {} \;
   

Group by the digest field using a filename-safe script; the full output line includes paths.

Identical hashes are candidates: compare bytes and metadata before any removal.

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. **整理計画を提案する**

変更を加える前に、明確な計画を提示します：

```markdown
# 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]
   

   別のフォルダーも整理しますか？

ベストプラクティス

フォルダー名

• 明確で説明的な名前を使います
• スペースは避けます（ハイフンまたはアンダースコアを使います）
• 具体的な名前を使います：「docs」ではなく「client-proposals」
• 順序を示す接頭辞を使います：「01-current」、「02-archive」

ファイル名

• 日付を含めます：「2024-10-17-meeting-notes.md」
• 内容がわかる名前を使います：「q3-financial-report.xlsx」
• ファイル名にバージョン番号を含めるのは避けます（代わりにバージョン管理を使います）
• ダウンロード時に付いた余分な文字列を削除します：「document-final-v2 (1).pdf」→「document.pdf」

アーカイブするタイミング

• 6か月以上更新されていないプロジェクト
• 後で参照する可能性がある、完了済みの作業
• 新しいシステムへの移行後の古いバージョン
• 削除をためらうファイル（まずアーカイブします）

例

ユーザーの依頼：

ダウンロードフォルダーを予測しやすい構成に整理し、まず移動案を提示してください。ファイルは削除しないでください。

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。