folder-organizer

フォルダー整理

ファイルをスキャン、分析、整理するスキルです。ファイルに手を加える前に、完全な再整理計画を作成します。

---

基本原則：先に計画し、実行は後から

ユーザーが計画全体を明示的に承認する前に、ファイルの名前変更、移動、コピー、削除を行ってはいけません。

必ず計画全体を提示し、肯定的な返答を待ってください。

---

フェーズ 1 — スキャンと一覧作成

ファイルの場所を特定します。

場所	アクセス方法
会話にアップロード済み	/mnt/user-data/uploads/ を確認
ユーザーが指定したローカルパス	bash_tool を使って ls -lah <path> を実行
口頭で説明された	ファイルのアップロードまたはパスの提示をユーザーに依頼

スキャンを実行して、以下を報告します。

# Count files and get basic stats
find <target_dir> -type f | wc -l
find <target_dir> -type f -name "*" | sort
ls -lah <target_dir>

簡単な概要を提示します。

• 📁 ファイルの合計数
• 見つかったファイル形式（拡張子別の内訳）
• すぐに判別できる重複ファイルや空ファイル

---

フェーズ 2 — ファイルごとの分析

各ファイルについて、以下を特定します。

項目	提示する内容
📌 内容	ファイルの内容または用途（テキストファイルは読み取り、バイナリファイルは名前や拡張子から推測）
🏷 推奨ファイル名	わかりやすく説明的な名前。小文字とハイフンまたはアンダースコアを使用し、該当する場合は日付を含める
📂 推奨フォルダー	論理的なカテゴリ名
🗑 削除可能？	冗長、空、一時的、または重複しているように見えるファイルにフラグを付ける

ファイル名の規則：

• 小文字を使い、区切り文字には - または _ を使用
• 内容がわかる情報を含める：report.xlsx ではなく 2024-q3-sales-report.xlsx
• 拡張子は変更しない

フォルダー名の規則：

• 短く、名詞を使う：reports/、assets/、drafts/、archives/
• 必要な場合を除き、フォルダーの階層は 2 段階を超えないようにする

---

フェーズ 3 — グループ化と構成の提案

すべてのファイルを分析した後、以下を提示します。

1. グループ化したまとまり — トピック、プロジェクト、または種類ごとに関連するファイル
2. 提案するフォルダーツリー — 次のようなツリー図で表示します。

   📁 organized/
   ├── 📁 reports/
   │   ├── 2024-q1-sales.xlsx
   │   └── 2024-q3-forecast.pdf
   ├── 📁 assets/
   │   ├── logo-primary.png
   │   └── banner-homepage.jpg
   └── 📁 drafts/
       └── proposal-v2.docx
   

3. 削除するファイル — 理由を添えて別に一覧表示
4. まとめるファイル — ZIP にまとめられるグループ（例：プロジェクトのすべてのアセット）

---

フェーズ 4 — 確認ゲート

計画全体を提示して、次のように尋ねます。

「以上が整理計画の全容です。実行前にご確認ください。分類、ファイル名、フォルダー名の変更をご希望の場合は、そのままお知らせください。」

(英語：「以上が完全な再整理計画です。実行前にご確認ください。カテゴリ、ファイル名、フォルダー名を変更したい場合はお知らせください。」)

ユーザーが「はい」／「確認」／「実行」、またはそれに相当する返答をするまで、先に進んではいけません。

---

フェーズ 5 — 実行（確認後のみ）

確認が取れたら、計画を実行します。

# Example: create folders and move files
mkdir -p <output_dir>/reports
mv "<source>/old-name.xlsx" "<output_dir>/reports/2024-q3-sales.xlsx"
# ... etc

実行後：

• 結果の最終的なファイルツリーを表示
• 移動または名前を変更したファイルの数を示し、完了を報告

---

例外的なケース

状況	対応
ファイルの内容を読み取れない（バイナリ、暗号化）	ファイル名や拡張子から推測し、「手動確認が必要」とフラグを付ける
名前変更後にファイル名が重複する	-2、-3 の接尾辞を付ける
ユーザーが ZIP をアップロードする	先に展開してから、内容を分析する
ファイルが見つからない	再アップロードするか、パスを確認するようユーザーに依頼
フォルダー内のファイルが非常に多い（100 個以上）	まず種類ごとのグループにまとめて概要を示し、ファイルごとの詳細が必要かユーザーに尋ねる

---

出力言語

ユーザーの言語に合わせます。ユーザーが繁体字中国語（繁體中文）で書いた場合は、繁体字中国語で返答します。英語で書いた場合は、英語で返答します。