mac-software-storage-cleanup-cn

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

概要

macOS のソフトウェアのインストール状況とディスク使用量を監査し、実行可能な段階別クリーンアップの提案を出力します。ユーザーの確認後に、低リスクのクリーンアップを実行します。この手順では、アプリの一覧、キャッシュ、シミュレーターデータ、中リスクのアプリデータを区別し、確認なしに業務データを削除しないようにします。

使用する場面

ユーザーに以下のような要望がある場合に、このスキルを使用します。

• /Applications、~/Applications、Homebrew Formula、Homebrew Cask にインストールされているソフトウェアを確認する
• ソフトウェアと一般的なキャッシュディレクトリの容量を集計し、サイズ順に並べる
• ~/Library/Caches、~/Library/Developer/CoreSimulator などの低リスクなディレクトリをクリーンアップする
• ディスク容量の管理方法を提案し、低リスクと中リスクのクリーンアップ項目を区別する

使用しない場面

以下のような場合は、このスキルを使用しないでください。

• ユーザーがディスク容量の調査ではなく、特定のアプリのアンインストールを希望している
• ユーザーが業務データのディレクトリを直接削除するよう求めているが、明確な確認がない
• タスクの実行環境が macOS ではない、または対象パスが現在のシステムに適用されない

使用方法

1. まず scripts/report_sizes.sh を実行して、ソフトウェアの入手元と主な使用容量の大きいディレクトリを調査します。
2. レポートに基づいて、クリーンアップの優先順位を区別します。
   • 優先度 1：キャッシュとシミュレーターデータ。デフォルトでは低リスクです。
   • 優先度 2：アプリの業務データディレクトリ。候補としてのみ一覧表示し、直接削除しません。
   • 優先度 3：効果の小さい小規模なキャッシュやログ。
3. 結果を出力する際は、ディレクトリの種類、件数、合計使用容量、容量の大きい項目 Top N を必ず表示します。
4. 優先度 2 の候補をスキャンする必要がある場合は、scripts/list_priority2_candidates.sh [対象ディレクトリ] [TopN] を実行します。
5. ユーザーが明確に確認した場合にのみ、scripts/cleanup_priority1.sh または同等のクリーンアップを実行します。
6. クリーンアップ後、再集計して「クリーンアップ前 -> クリーンアップ後 -> 解放した容量」の比較結果を出力します。

標準手順

盘点安装来源与空间占用
  -> 识别高价值可清理目录
  -> 给出分级建议
  -> 等待用户确认
  -> 执行低风险清理
  -> 复核释放结果

実行コマンド

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

出力要件

• パスの種類ごとに件数と合計使用容量を明確に表示する
• ユーザーがすばやく判断できるよう、容量の大きい項目 Top N を一覧表示する
• クリーンアップを行う場合は、必ず実行前後の比較を含める
• ユーザーの確認がない場合、優先度 2 のディレクトリを自発的に削除しない

制約

• 破壊的な git コマンドを使用しない
• ユーザーが確認していないアプリの業務データを削除しない
• スクリプトが失敗した場合は、より慎重な読み取り専用の調査、または最小範囲のクリーンアップに切り替える