sbh について
SBHは、ディスク状況を調べ、呼び出し元が明示的に許可した操作だけを行うストレージ圧迫対応スキルです。破壊的なクリーンアップより、可逆的な確認と対処を優先し、実行前後の結果を記録します。
主な機能
- 01マウント先と圧迫状態を収集
- 02クリーンアップのドライランを実行
- 03許可を得てバラストを解放
- 04許可を得て保護対象外を整理
- 05回収量と保護による拒否を記録
活用シーン
- 01圧迫されたマウント先を診断
- 02ドライランの整理候補を比較
- 03許可された復旧手順を実行
- 04ストレージ状況の実行前後を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/sbhを入力して読み込まれたか確認します。
詳細
SBH — ストレージ圧迫の専門ツール
SBH は、ディスク圧迫の状態、バラスト、スキャン、復旧コマンドを提供します。この
スキルは証拠を収集し、呼び出し元が明示的に許可した操作のみを最大 1 回実行します。
許可された操作はファイルを削除したり、ホストのストレージ設定を変更したりする可能性が
あるため、呼び出し元から明示的な権限が与えられていない限り、変更を伴う処理は実行しません。以下のコマンド一覧は sbh 0.4.27 に基づいています。
別のホストで正確なフラグを使用する前に、sbh --version で再確認してください。
証拠を優先する復旧が有効なのは、ディスク圧迫には低コストで可逆的な対処法と、高コストで不可逆的な対処法があり、削除を実行する前に両者を見分けるには事実に基づくベースラインが必要だからです。対処は不可逆性の低い順に行います。まず状態確認とドライラン、次にバラストの解放、その後に保護対象外ファイルのクリーンアップ、最後に緊急削除を行います。より可逆的な手段を試していないうちは、先に進んではいけません。
失敗モードの名称 — 誤ったマウントポイントでの解消：圧迫の原因ではないファイルシステムで数ギガバイトを回収し、圧迫が解消したと判断することです。
アンチパターン：圧迫が深刻だからといって、すぐに emergency --yes へ進むこと。修正策：緊急性が高いほど不可逆的なミスの代償は大きくなります。緊急性によって権限の基準が下がることも、上記の順序が変わることもありません。
制約
- 復旧の判断には事実に基づくベースラインが必要なため、
sbh --json status、sbh check、または対象マウントポイントを指定したドライランから始めます。 - ホストの状態を変更する操作であるため、明示的な権限がない限り、
clean --yes、emergency --yes、バラストの解放、tune --apply、unprotect、サービスや設定の変更は実行しません。 - 安全でない、または効果のないクリーンアップを防ぐため、
.git/、開いているファイル、新しいファイル、書き込み可能な親ディレクトリがないファイル、.sbh-protectによる拒否条件を維持します。 - 別のファイルシステムの空き容量では圧迫が解消されないため、バラストまたは回収したバイト数が圧迫されているマウントポイントに影響することを確認します。
- 操作は 1 回だけ実行し、前後の証拠を記録して停止します。追加の変更を行うかどうかは呼び出し元が判断します。否定的な結果は呼び出し元に返します。このスキルは再試行もエスカレーションも行いません。
出力
マウントポイント、空きバイト数、圧迫状態、ドライランでの候補、使用した権限、正確なコマンドと終了コード、回収したバイト数、保護による拒否、確認した項目と確認していない項目を返します。
コマンドの全ドキュメント：https://github.com/Dicklesworthstone/storage_ballast_helper