file-master

File Master - Mac ファイル管理マスター

disk-cleaner、file-organizer、doc-mindmap の 3 つのスキルを「整理 → 分類 → 知識化」の 3 段階ワークフローとしてつなぎ、Mac のファイル管理を一度に完了します。

使用する場面

ユーザーが明確に複数段階の組み合わせフローを必要としている場合にのみ、このスキルを使用してください。 ユーザーが単一のタスク（ディスクのクリーンアップのみ、ファイル整理のみ、ドキュメント分析のみ）だけを望んでいる場合は、対応するサブスキル（disk-cleaner / file-organizer / doc-mindmap）を直接使用し、file-master は使用しないでください。

以下の場合にこのスキルを使用します：

• 組み合わせ操作を明確に要求している場合：「まずクリーンアップしてから整理して」「クリーンアップが終わったらファイルを分類して」
• 「パソコンを全面的に整理して」「ファイルの大掃除をして」（全面性・完全性を強調）と言っている場合
• クリーンアップ + 整理 + アーカイブのうち少なくとも 2 つの段階を一度に完了したい場合
• 「ディスクがもうすぐ一杯でさらに整理していないファイルが山ほどある」（複数の要望が併存）と言っている場合

このスキルを使用しないでください ユーザーが以下のように言うだけの場合：

• 「ディスクをクリーンアップ」 / 「容量を解放」 → disk-cleaner を使用
• 「ファイルを整理」 / 「ダウンロードフォルダを整理」 → file-organizer を使用
• 「ドキュメントを分析」 / 「ドキュメント変換」 → doc-mindmap を使用

トリガーキーワード: パソコンを全面整理, ワンストップ整理, ファイル大掃除, まずクリーンアップしてから整理, 完全なファイル管理フロー

機能

• 3 段階ワークフロー - 整理(容量の解放) → 分類(ファイルの仕分け) → 知識化(ドキュメントのインテリジェント分析)
• 柔軟な選択 - 3 段階すべてを実行することも、任意の段階の組み合わせを選択することも可能
• プレビュー優先 - 各段階で実行前にプレビューし、ユーザーが完全に掌控
• 段階間連携 - Phase 2 で整理したパスが自動的に Phase 3 の分析に渡されます
• 耐障害設計 - ある段階が失敗またはスキップされても、後続の段階に影響しません
• 最終レポート - 3 段階の成果を集約し、一目でわかります

使用方法

自然言語でトリガーするだけで、Claude がフロー全体を案内します：

帮我全面整理一下电脑          → 执行全部三阶段
帮我清理磁盘再整理文件        → Phase 1 + Phase 2
整理一下文件然后做个文档分析  → Phase 2 + Phase 3
只帮我做文档分析              → Phase 3

依存関係

3 つのサブスキルそれぞれの依存関係：

Phase 1 - disk-cleaner

• macOS, Homebrew
• Mole (brew install tw93/tap/mole)
• Python: pip install jinja2

Phase 2 - file-organizer

• macOS
• Python 3.8+

Phase 3 - doc-mindmap

• Python 3.10+
• markitdown: pip install 'markitdown[all]'
• Ollama: brew install ollama + ollama pull qwen2.5:3b
• requests: pip install requests

Claude ワークフロー

Claude がこのスキルを使用する際は、以下の手順に厳密に従って実行します。

第 0 步：ウェルカム + 段階の選択

ユーザーに 3 段階の概要を提示し、どの段階を実行するかを尋ねます：

Mac 文件管理大师 - 三阶段工作流

Phase 1 「清」 - 磁盘清理，释放硬盘空间 (disk-cleaner)
Phase 2 「理」 - 文件整理，归类下载文件夹 (file-organizer)
Phase 3 「知」 - 文档分析，批量转换 + 摘要 + 分类 (doc-mindmap)

请选择：
1. 全部执行（推荐）
2. 选择部分阶段
3. 只执行某个阶段

ユーザーが一部の段階を選択した場合は、実行する段階のリストを記録し、選択されなかった段階はスキップします。

---

Phase 1「整理」- ディスクのクリーンアップ

disk-cleaner スキルを使用してハードディスクの容量を解放します。

1.1 プレビュースキャン

python disk-cleaner/scripts/mole_cleaner.py --check
python disk-cleaner/scripts/mole_cleaner.py --preview

スキャン結果をユーザーに提示します。クリーンアップ可能な容量のサイズと分類を含みます。

1.2 クリーンアップレベルの選択

请选择清理档位：
1. Air - 最安全，只清浏览器缓存和日志
2. Pro - 推荐，平衡安全与空间
3. Max - 最大化释放空间
4. 跳过此阶段

1.3 クリーンアップの実行

ユーザーがレベルを選択したら実行します：

python disk-cleaner/scripts/mole_cleaner.py --clean --tier <air|pro|max> --confirm

1.4 Phase 1 のまとめ

どれだけの容量を解放したかを報告し、Phase 2 に進みます。

---

Phase 2「分類」- ファイルの整理

file-organizer スキルを使用してファイルを仕分けします。

2.1 プレビュースキャン

python file-organizer/scripts/file_organizer.py --status

ダウンロードフォルダ内のファイル状況をユーザーに提示します。

2.2 整理モードの選択

请选择整理模式：
1. 手动模式 - 创建智能文件夹，自己拖拽整理
2. 自动模式 - 自动按类型分类到桌面文件夹
3. 跳过此阶段

2.3 整理の実行

手動モード：

python file-organizer/scripts/file_organizer.py --manual

自動モード：

# 先预览
python file-organizer/scripts/file_organizer.py --auto --dry-run
# 用户确认后执行
python file-organizer/scripts/file_organizer.py --auto

自動モードの実行後、整理したパスは自動的に disk-cleaner のホワイトリストに書き込まれ、整理済みのファイルを保護します。

2.4 Phase 2 のまとめ

何個のファイルを整理したか、どのようなカテゴリに分けたかを報告します。出力パスを記録します（例：~/Desktop/已整理文件-YYYYMMDD/）。これは Phase 3 で使用します。

---

Phase 3「知識化」- ドキュメント分析

doc-mindmap スキルを使用してドキュメントのインテリジェント分析を行います。

3.0 対象ディレクトリの決定

• Phase 2 を実行済みの場合：Phase 2 の出力パスを自動的に使用
• Phase 2 をスキップした場合：どのディレクトリを分析するかをユーザーに尋ねる

3.1 ドキュメントのプレビュー

python doc-mindmap/scripts/doc_converter.py <目标路径> --preview

ドキュメントのリスト、種類の分布、重複ファイルの検出結果を表示します。

3.2 変換の実行

python doc-mindmap/scripts/doc_converter.py <目标路径> --convert --confirm

3.3 要約の生成

python doc-mindmap/scripts/doc_converter.py <目标路径> --summarize

3.4 三次元分類

# 先展示分类结果
python doc-mindmap/scripts/doc_converter.py <目标路径> --organize

AI が提案したファイル名を使用するかどうかをユーザーに尋ねます。同意した場合：

python doc-mindmap/scripts/doc_converter.py <目标路径> --organize --rename

3.5 Finder プレビュー

分類ディレクトリを Finder でプレビューするかどうかをユーザーに尋ねます：

cp -a <.summaries/schemes> ~/Desktop/文档分类-$(date +%Y%m%d)
open ~/Desktop/文档分类-$(date +%Y%m%d)

3.6 Phase 3 のまとめ

何件のドキュメントを変換したか、いくつの要約を生成したか、分類結果の概要を報告します。

---

最終まとめ

3 段階の成果を集約し、ユーザーに提示します：

=== Mac 文件管理大师 - 完成报告 ===

Phase 1「清」: 释放了 X.XX GB 磁盘空间
Phase 2「理」: 整理了 N 个文件到 M 个分类
Phase 3「知」: 转换了 K 个文档，生成 K 份摘要，三维度分类完成

所有阶段执行完毕！

スキップした段階には「スキップ済み」と注記し、失敗した段階にはエラー原因を注記します。

エラー処理

• ある段階の依存関係が未インストールの場合、ユーザーにインストールコマンドを提示し、その段階をスキップして続行するかどうかを尋ねます
• ある段階の実行でエラーが発生した場合、エラー情報を記録し、次の段階に進むかどうかをユーザーに尋ねます
• Phase 3 は Ollama のローカルモデルに依存しているため、未インストールの場合は要約と分類のステップをスキップし、変換のみを行います

クレジット

• disk-cleaner - ディスクのクリーンアップ
• file-organizer - ファイルの整理
• doc-mindmap - ドキュメントのインテリジェント分析