mac-software-storage-cleanup

Mac ソフトウェアストレージのクリーンアップ

概要

macOS にインストールされているソフトウェアとストレージ使用状況を監査し、優先順位を付けたクリーンアップの提案を作成します。リスクの低いクリーンアップは、確認後にのみ実行します。このスキルでは、アプリのインベントリ、キャッシュのクリーンアップ、シミュレーターデータ、中リスクのアプリケーションデータを分けて扱い、破壊的な操作を明示し、可能な限り元に戻せるようにします。

使用する場合

次の場合にこのスキルを使用します。

• ユーザーが /Applications、~/Applications、Homebrew Formula、または Homebrew Cask にインストールされているソフトウェアを確認したい
• アプリや一般的なキャッシュの場所について、サイズ順にストレージ使用量を確認したい
• ~/Library/Caches や ~/Library/Developer/CoreSimulator など、リスクの低いパスをクリーンアップしたい
• リスクの低いクリーンアップと中リスクのクリーンアップを明確に分けた、ストレージ回復の提案を求めている

使用しない場合

次の場合はこのスキルを使用しないでください。

• ストレージ管理ではなく、特定のアプリを1つアンインストールしたい
• 明示的な確認なしでアプリケーションデータを直接削除するよう求めている
• macOS 以外の環境である、または対象のパスが適用されない

手順

1. まず scripts/report_sizes.sh を実行し、インストール元と主なストレージ消費項目の一覧を作成します。
2. クリーンアップ候補を優先順位に応じて分類します。
   • 優先度1：キャッシュとシミュレーターデータ。通常、リスクは低いです。
   • 優先度2：アプリケーションデータディレクトリ。報告のみとし、デフォルトでは削除しません。
   • 優先度3：効果の小さい小規模なキャッシュやログ。
3. レポートには、カテゴリごとの合計、件数、サイズの大きい項目の上位 N 件を含めます。
4. 優先度2の候補を確認するには、scripts/list_priority2_candidates.sh [target_dir] [TopN] を実行します。
5. ユーザーの明示的な確認後にのみ、scripts/cleanup_priority1.sh または同等のリスクの低いクリーンアップ操作を実行します。
6. クリーンアップ後に使用量を再計算し、before -> after -> reclaimed の概要を表示します。

ワークフロー

Inventory install sources and storage usage
  -> identify high-value cleanup targets
  -> present prioritized recommendations
  -> wait for user confirmation
  -> run low-risk cleanup
  -> verify reclaimed space

コマンドの実行

bash scripts/report_sizes.sh
bash scripts/list_priority2_candidates.sh ~/Library/Application\\ Support 20
bash scripts/cleanup_priority1.sh

出力要件

• パスのカテゴリごとに件数と合計サイズを表示します
• ユーザーがすぐに判断できるよう、ストレージ消費量の大きい項目の上位 N 件を一覧表示します
• すべてのクリーンアップ操作に、実行前後の比較を含めます
• ユーザーの明示的な承認なしに、優先度2のディレクトリを削除しません

制約

• 破壊的な git コマンドを使用しません
• 確認を得ていないアプリケーションデータを削除しません
• スクリプトが失敗した場合は、読み取り専用の確認に切り替えるか、最小限の安全な範囲でクリーンアップします