health-audit

/health:audit

プロジェクトで有効になっているプラグインを、実際の技術スタックと照合して監査します。このプロジェクトに適用されないプラグインを特定し、有効になっていない関連プラグインを提案します。

このスキルを使用するタイミング

次の場合にこのスキルを使用します…	次の場合は別の方法を使用します…
現在のプロジェクトにおけるプラグインの関連性を確認する	一般的なヘルス診断を行う（/health:check を使用）
使用していないプラグインを整理する	プラグインレジストリの破損に対処する（/health:plugins --fix を使用）
技術スタックに関連するプラグインを見つける	エージェントの最適化を監査する（/health:agentic-audit を使用）
プロジェクト固有のプラグイン設定を最適化する	特定のプラグインをインストールする（直接インストール）
既存のプロジェクトを使い始める	包括的な設定の検証が必要

コンテキスト

• 現在のプロジェクト： !pwd
• プロジェクト設定ファイルの有無： !find .claude -maxdepth 1 -name 'settings.json'
• Package.json の有無： !find . -maxdepth 1 -name 'package.json'
• Cargo.toml の有無： !find . -maxdepth 1 -name 'Cargo.toml'
• pyproject.toml の有無： !find . -maxdepth 1 -name 'pyproject.toml'
• requirements.txt の有無： !find . -maxdepth 1 -name 'requirements.txt'
• go.mod の有無： !find . -maxdepth 1 -name 'go.mod'
• Dockerfile の有無： !find . -maxdepth 1 -name 'Dockerfile'
• docker-compose の有無： !find . -maxdepth 1 \( -name 'docker-compose.yml' -o -name 'docker-compose.yaml' -o -name 'compose.yml' -o -name 'compose.yaml' \)
• GitHub ワークフロー： !find .github/workflows -maxdepth 1 -name '*.yml' -quit -print
• Terraform ファイル： !find . -maxdepth 2 -name '*.tf' -quit -print
• Kubernetes マニフェスト： !find . -maxdepth 3 \( -path '*/k8s/*' -o -path '*/kubernetes/*' \) -name '*.yaml' -quit -print

パラメーター

パラメーター	説明
--fix	.claude/settings.json に推奨される変更を適用します
--dry-run	ファイルを変更せずに、変更内容を表示します
--verbose	各プラグインの判定について詳細な分析を表示します

実行

このプラグイン関連性監査を実行します。

ステップ 1：プロジェクトの技術スタックを検出する

上記のコンテキストにあるプロジェクトファイルを分析し、技術スタックを特定します。各指標を REFERENCE.md の技術スタック対応表と照合します。

ステップ 2：利用可能なプラグインを取得する

claude plugin list --json を実行して、設定済みのマーケットプレイスにあるすべての利用可能なプラグインを取得します。出力からプラグイン名、説明、キーワード、カテゴリーを解析します。

ステップ 3：現在有効なプラグインを読み取る

.claude/settings.json を読み取り、enabledPlugins 配列を取得します。ファイルが存在しない場合、または enabledPlugins が設定されていない場合は、空のリストとして扱います。

ステップ 4：プラグインの関連性を分析する

有効な各プラグインを、検出した技術スタックと比較します。REFERENCE.md のプラグイン関連性対応表を使用して、関連するプラグイン、関連しないプラグイン、不足しているプラグインを判定します。

各プラグインを次のように分類します。

• RELEVANT -- 検出した技術スタックに一致
• NOT RELEVANT -- 一致する指標が見つからない
• MISSING -- 関連するが、現在有効になっていないプラグイン

ステップ 5：監査レポートを生成する

次の内容を含む構造化されたレポートを出力します。

1. 検出した技術スタックとその根拠
2. 現在有効なプラグインと関連性のステータス
3. 追加を提案するプラグイン（理由を含む）
4. 削除を提案するプラグイン（理由を含む）
5. 件数の概要

ステップ 6：変更を適用する（--fix の場合）

--fix が渡された場合：

1. 現在の設定をバックアップします：cp .claude/settings.json .claude/settings.json.backup
2. 変更カテゴリーごと（削除、追加）に、実行前に確認を求めます
3. .claude/settings.json を更新します。確認済みの関連しないプラグインを削除し、確認済みの関連プラグインを追加して、その他の設定は保持します
4. ファイルを再度読み取り、有効な JSON であることを確認し、差分を表示して変更を検証します

ユーザーレベルとプロジェクトレベル

注：このコマンドが管理するのは、.claude/settings.json のプロジェクトレベルのプラグイン設定のみです。

ユーザーレベルのプラグイン（~/.claude/settings.json 内）は別途管理されるため、プロジェクトレベルで重複して設定する必要はありません。

分析時には、プラグインがすでにユーザーレベルで有効になっているか確認します。

jq -r '.enabledPlugins[]? // empty' ~/.claude/settings.json 2>/dev/null

プラグインがユーザーレベルで有効になっている場合、プロジェクト固有の動作が必要でない限り、プロジェクト設定に追加する必要はありません。

エッジケース

シナリオ	動作
.claude/settings.json がない	推奨プラグインを含めて作成します
enabledPlugins が空	関連するプラグインの追加を提案します
複数の言語を使用するモノレポ	一致するすべてのプラグインを提案します
マーケットプレイスにないプラグイン	「不明」として報告しますが、削除はしません
ユーザーが変更を拒否した	意向を尊重し、手動での設定手順を表示します

エージェント向けの最適化

コンテキスト	コマンド
プラグインの関連性監査	/health:audit
自動修正を伴う監査	/health:audit --fix
ドライランモード	/health:audit --dry-run
有効なプラグインの一覧表示	jq -r '.enabledPlugins[]? // empty' .claude/settings.json 2>/dev/null
プロジェクトの言語を検出	find . -maxdepth 1 \( -name 'package.json' -o -name 'Cargo.toml' -o -name 'pyproject.toml' \) -exec basename {} \;

フラグ

フラグ	説明
--fix	推奨される変更を適用します（確認あり）
--dry-run	変更を加えずに、変更内容を表示します
--verbose	各判断の詳細な理由を表示します

関連項目

• /health:plugins - プラグインレジストリの問題を修正します
• /health:check - 診断をすべて実行します
• /configure:claude-plugins - プラグインを初期設定します