WizTree ディスククリーナーは何をしますか？

WizTree をディスク使用状況の事実情報源として使用し、分析、承認、実行、検証を分離したプロセスを維持します。レポートはユーザーの言語に合わせて作成します。

絶対的な安全ゲート

デフォルトは分析のみ。CSV データのインポートや確認中にディスクを変更しないでください。
Tier 1 を低リスク扱いしても、承認不要にはしないでください。削除の前に必ず明示的なユーザー承認を必要とします。
「ディスクをクリーンアップして」のような一般的なリクエストから承認を推測しないでください。まず正確なターゲットとアクションを表示します。
モデルが散文で記述した削除コマンドを実行しないでください。scripts/New-CleanupPlan.ps1 を使って計画を構築し、その plan_id を表示し、ユーザーがその正確な計画を確認した後でのみ実行します。
ワイルドカード、相対パス、ドライブルート、広範なユーザープロファイルルート、システムディレクトリ、プログラムディレクトリ、Tier 3 ターゲットは拒否します。
別のマシンでエクスポートされた CSV を使用して、対象マシンをクリーンアップしないでください。ローカルパスの存在とマシンスコープが確立されていない限り、分析のみに留めてください。
ユーザーのリクエストなしに WizTree をダウンロードまたはインストールしないでください。このスキルに WizTree 実行可能ファイルを再配布しないでください。
エンドツーエンドでネイティブの PowerShell ファイル操作のみを使用します。再帰的削除の直前に、正規のターゲットパスを再検証します。

ターゲットの分類や承認の前に references/safety-policy.md を読んでください。WizTree データのエクスポートや解析時には references/wiztree-csv.md を読んでください。

ワークフロー

1. 最新の CSV を取得する

現在のマシンと現在のディスク状態からエクスポートされた CSV を優先します。

ユーザーが既にエクスポートを持っている場合、その絶対パスとタイムスタンプを記録します。
WizTree がインストールされており、ユーザーが自動化を希望する場合、scripts/Export-WizTree.ps1 を実行します。
それ以外の場合は、ユーザーにターゲットドライブを WizTree でスキャンし、公式の CSV エクスポートを使用するよう指示します。

CSV エクスポートが利用可能な場合、スクリーンショットを正規のインベントリとして使用しないでください。

2. 最初のレポートを作成する

以下を実行します:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Analyze-WizTreeCsv.ps1 `
  -CsvPath <absolute-csv-path> `
  -OutputDirectory <absolute-report-directory>

生成された JSON を機械可読な証拠として、マークダウンレポートをユーザー向けの記録として使用します。追加の説明が必要な場合は、assets/cleanup-report-template.md の構造をコピーします。

クリーンアップを推奨する前に、以下の点を確認します:

ファイル行から割り当てバイト数をカウントします。ネストされたフォルダ合計を合計しないでください。
WizTree の先頭ゼロマーカーが付いたハードリンク割り当て値は、追加割り当てゼロとして扱います。
キャッシュと、キャッシュのような名前で保存されたユーザー作成コンテンツを区別します。
不確実性は明示的にマークします。証拠が不十分な場合は、アイテムをより高いリスクティアに移動します。

3. Tier 2 を調査する

各重要な Tier 2 候補を提示する前に調査します。可能な場合、以下を確認します:

所有するアプリケーションまたは Windows コンポーネント。
そのアプリケーションまたはサービスが現在実行中かどうか。
更新の新しさとファイルがアクティブに変更されているかどうか。
アプリケーションが独自のクリーンアップコマンドを提供しているかどうか。
再生成コスト、サインインへの影響、オフラインへの影響、復元オプション。
正確なパス、提案されたアクション、推定バイト数、予想される副作用。

生の削除よりも、アプリケーション固有のクリーンアップ、Windows ストレージ設定、ディスククリーンアップ、パッケージマネージャーのキャッシュコマンド、または文書化されたサービス認識手順を優先します。

4. 項目別の承認を得る

まず Tier 1 を提示します。選択可能な各項目には以下を含めます:

正確なパス。
アクション: clear_directory_contents または delete_file。
ティアと理由。
推定再生可能バイト数。
注目すべき副作用。

assets/approval-manifest.example.json から承認マニフェストを作成します。ユーザーが明示的に選択した項目のみを含め、approved を true に設定します。

5. 計画をプレビューしてバインドする

以下を実行します:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/New-CleanupPlan.ps1 `
  -ApprovalFile <approval-json> `
  -PlanFile <plan-json>

検証された項目、推定合計、拒否された項目、plan_id を表示します。いずれかのターゲットがユーザーの選択よりも広範囲であるか、レポートと異なる場合は停止します。

6. 確認された計画のみを実行する

ユーザーが表示された plan_id を確認した後、以下を実行します:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Invoke-ApprovedCleanup.ps1 `
  -PlanFile <plan-json> `
  -ConfirmPlanId <confirmed-plan-id> `
  -Execute

-Execute がない場合、スクリプトはドライランに留まります。会話で正確な計画の確認が表示される前に -Execute を追加しないでください。

7. 検証とレポートの更新

成功、スキップ、失敗、監査ログパスを記録します。
推定削除バイト数と観測された空き容量の変化は、バックグラウンドアクティビティにより異なる可能性があるため、別々に記録します。
可能であれば WizTree を再エクスポートまたは再スキャンします。
マークダウンレポートの実行履歴と残りの Tier 2 選択肢を更新します。
Tier 2 について承認サイクルを繰り返します。Tier 3 を実行可能な計画に昇格させないでください。

リソースマップ

scripts/Export-WizTree.ps1: 公式の WizTree CSV エクスポートを呼び出します。
scripts/Analyze-WizTreeCsv.ps1: エクスポートをストリームし、JSON とマークダウンを生成します。
scripts/New-CleanupPlan.ps1: 選択されたターゲットを検証し、整合性が保証された計画を作成します。
scripts/Invoke-ApprovedCleanup.ps1: 確認された計画を再検証して実行し、JSONL 監査ログを記録します。
references/safety-policy.md: 分類と削除の境界。
references/wiztree-csv.md: 公式のエクスポートセマンティクスとパーサーの期待事項。
assets/cleanup-report-template.md: レポートの構造。
assets/approval-manifest.example.json: 承認入力のスキーマ。

WizTree ディスククリーナー