janitor-report

ヘルスレポート

インベントリ、品質チェック、重複検出、破損したスキルの検出を組み合わせて、包括的なヘルスレポートを生成します。

概要

ユーザー、プロジェクト、Codex、プラグイン、ソースの各スコープにあるすべてのスキルを対象に、1 つのレポートを作成します。プラグインのスキルは、完全な呼び出し名（例：marketing-skills:image、figma:figma-use）で表示されます。これらは v1.2 のレポートでは確認できませんでした。スキャン JSON には、agents 配列（~/.claude/agents にあるサブエージェント。説明は常に読み込まれます）と、プラグインごとの update_available（インストール済みコミットとマーケットプレイスの HEAD の比較）も含まれます。古いプラグインや負荷の大きいエージェントをレポートに表示してください。

モード：

• /janitor-report（デフォルト）— 完全なヘルスチェック：インベントリ + lint + 重複 + 破損
• /janitor-report --brief — インベントリのみ（旧 /janitor-audit を置き換えます）

前提条件

• skills-janitor プラグインがインストールされた Claude Code（scripts/scan.sh、lint.sh、detect_dupes.sh を提供）
• bash 3.2 以降（標準の macOS bash で動作します。外部依存関係はありません）
• ~/.claude/skills、~/.claude/agents、インストール済みプラグインのメタデータへの読み取りアクセス
• 認証や API キーは不要です — スクリプトはローカルファイルのみを読み取ります

手順

ステップ 1：スクリプトを実行する

完全なレポート：

bash ~/.claude/skills/skills-janitor/scripts/scan.sh
bash ~/.claude/skills/skills-janitor/scripts/lint.sh
bash ~/.claude/skills/skills-janitor/scripts/detect_dupes.sh

簡易モード（インベントリのみ）：

bash ~/.claude/skills/skills-janitor/scripts/scan.sh

ステップ 2：各スクリプトの対象範囲

• インベントリ（scan.sh） — 各スコープのすべてのスキル、シンボリックリンクの状態、フロントマターのフィールド、行数。agents および plugins（update_available を含む）配列、broken_symlinks の件数。
• 品質チェック（lint.sh） — 重大：シンボリックリンクの破損、SKILL.md の欠落、フロントマターの欠落。警告：名前または説明の欠落・空欄、説明が短すぎる・長すぎる、バージョンの欠落。情報：本文なし、Gotchas セクションなし、ファイルサイズが大きい。
• 重複検出（detect_dupes.sh） — 名前の衝突（異なるパスにある 2 つのスキルの修飾名が同じ）と説明の類似（Jaccard 類似度 >30％）。スコープをまたぐユーザーとプラグインの組み合わせも明示的に表示します（例：marketing-seo-audit（ユーザー） ↔ marketing-skills:seo-audit（プラグイン））。

ステップ 3：統合レポートを提示する

3 つの出力を重大度レベル付きの 1 つの表にまとめ、その後に推奨アクションを提示します。

出力

| Skill                            | Scope    | Status      | Issues                                   |
|----------------------------------|----------|-------------|------------------------------------------|
| marketing-copywriting            | user     | DUPLICATE?  | 90% overlap with marketing-skills:copywriting |
| seo-audit                        | user     | WARNING     | Description too short                    |
| old-deploy-helper                | user     | CRITICAL    | Broken symlink                           |
| figma:figma-use                  | plugin   | OK          | -                                        |

問題の種類ごとの推奨アクション：

• シンボリックリンクの破損 → /janitor-fix --prune
• 品質の問題 → /janitor-fix
• ユーザーとプラグインの重複 → ユーザースコープのコピーをアンインストールしてプラグインを使用する（またはその逆）
• 古いプラグイン（update_available: true） → /plugin update <name>
• トークンの浪費 → /janitor-value
• 不審なコンテンツ（インジェクションの文言、危険なスクリプト） → /janitor-security
• 未使用の MCP サーバー（インベントリには scripts/mcp.sh を実行） → 設定エントリを削除するか、/janitor-swipe を実行

エラー処理

1. エラー：scan.sh: No such file or directory 解決策：プラグインが別のルートにインストールされています。ls ~/.claude/skills で見つけるか、プラグインキャッシュを確認して、実際の場所からスクリプトを実行してください。

2. エラー：スキャン出力が有効な JSON ではない 解決策：標準エラー出力が表示される状態で再実行し（2>/dev/null を削除）、失敗した行を報告してください。通常は、スキルディレクトリに特殊な文字が含まれていることが原因です。

3. エラー：インストール済みのプラグインがあるにもかかわらず、plugins 配列が空 解決策：~/.claude/plugins/installed_plugins.json が見つからないか、形式が不明です。使用中の Claude Code のバージョンを報告してください。

例

例 1：完全なヘルスチェック

入力：「スキルに問題がないか確認してください。」

出力：3 つのスクリプトをすべて実行し、重大度の表にまとめて、件数から報告を始めます：「175 個のスキルをスキャンしました：重大な問題 2 件（シンボリックリンクの破損）、警告 5 件、重複の可能性 3 件、更新可能なプラグイン 2 件。」

例 2：インベントリのみ

入力：/janitor-report --brief

出力：scan.sh のみを実行し、スコープごとの件数を添えて、スコープ別にまとめたインベントリを提示します。

リソース

• スクリプト（プラグイン相対パス）：{baseDir}/../../scripts/scan.sh、lint.sh、detect_dupes.sh
• /janitor-fix — このレポートで検出された問題を自動修正します
• /janitor-value — トークンコストと使用量（合算）
• /janitor-discover — 新しいスキルを検索または評価します