Check Plugin

Claude Code プラグイン陳腐化チェック

Claude Codeプラグインが最新仕様に準拠しているかをチェックし、問題点と修正提案を報告する。

実行方法

/check-plugin                    # 全プラグインをチェック
/check-plugin git                # 特定プラグインのみ
/check-plugin --fix              # 全プラグインをチェックして修正
/check-plugin git --fix          # 特定プラグインをチェックして修正

チェック手順

1. 引数解析

$ARGUMENTSを解析して実行モードを決定：

• プラグイン名が指定されていれば対象を限定
• --fixフラグがあれば修正モードを有効化

2. 最新仕様の確認

WebSearchで以下を検索し、最新のClaude Code仕様を確認：

• "Claude Code plugins reference 2026"
• "Claude Code tools list 2026"
• "Claude Code hooks specification 2026"

重要な確認項目：

• 標準ツール名の最新リスト
• 非推奨・廃止されたツールやフィールド
• 新機能（outputStyles, skills等）

3. プラグイン構造の読み込み

claude-plugins/配下の各プラグインについて以下を読み込み：

plugin.json

• Readツールで.claude-plugin/plugin.jsonを読み込み
• 必須フィールド（name, description, version, author）を確認

commands（コマンド定義）

• Globでcommands/*.mdを検索
• 各ファイルをReadしてfrontmatterを解析
• allowed-toolsとdescriptionフィールドを確認

agents（エージェント定義）

• Globでagents/*.mdを検索
• 各ファイルをReadしてfrontmatterを解析
• name, description, toolsフィールドを確認

hooks（フック定義）

• Readでhooks/hooks.jsonを読み込み（存在する場合）
• matcherパターンと使用ツール名を確認

4. チェック項目

plugin.json チェック

• 必須フィールドの存在確認：name, description, version, author
• バージョン形式の妥当性（セマンティックバージョニング）
• 新機能フィールドの活用可能性：outputStyles, skills, mcpServers, lspServers

commands チェック

• frontmatterにallowed-toolsフィールドが存在するか
• allowed-toolsに記載されたツール名が標準ツールリストに含まれるか
• descriptionフィールドが存在し、適切に記述されているか

agents チェック

• frontmatterにname, descriptionフィールドが存在するか
• toolsフィールドに記載されたツール名が標準ツールリストに含まれるか
• 非標準フィールド（color等）が使用されていないか
• 不要なツール（MultiEdit, NotebookRead, TodoWrite等）が含まれていないか

hooks チェック

• matcherパターンに記載されたツール名が標準ツールリストに含まれるか
• フックイベント名が有効なイベント（PreToolUse, PostToolUse等）か
• フックタイプ（command, prompt, agent）が適切に使用されているか

5. 標準ツール名リスト（2026年1月時点）

コアツール：

• Read, Write, Edit, MultiEdit
• Bash（パターン指定可：Bash(git:*)）
• Glob, Grep, LS

高度なツール：

• Task, Skill
• WebFetch, WebSearch
• TodoRead, TodoWrite
• NotebookRead, NotebookEdit
• AskUserQuestion

注意：

• 最新仕様はWebSearchで確認すること
• ツール名は大文字小文字を区別する

6. 出力形式

チェック結果をコンソールに以下の形式で出力：

# プラグイン陳腐化チェックレポート

実行日時: YYYY-MM-DD HH:MM:SS
対象: [全プラグイン / プラグイン名]

## サマリー
- チェックしたプラグイン数: X
- 問題のあるプラグイン: Y件
- Critical: Z件
- Warning: W件

## 詳細

### [プラグイン名] (例: engineer)

#### Critical（必須修正）
- **問題**: agents/tdd-refactoring-coach.md に非標準フィールド`color`が使用されています
  **影響**: プラグインが正しく動作しない可能性
  **修正方法**: `color`フィールドを削除
  **ファイル**: claude-plugins/engineer/agents/tdd-refactoring-coach.md:3

#### Warning（推奨修正）
- **問題**: agents/tdd-refactoring-coach.md に不要なツール`TodoWrite`が含まれています
  **影響**: コンテキストウィンドウを無駄に消費
  **修正方法**: TDDコーチに不要な`TodoWrite`を`tools`から削除
  **ファイル**: claude-plugins/engineer/agents/tdd-refactoring-coach.md:4

#### Info（情報）
- **情報**: plugin.jsonで新機能`outputStyles`を活用できる可能性があります
  **メリット**: 日本語ユーザー向けの出力フォーマットをカスタマイズ可能

7. 修正モード（--fix）

--fixフラグが指定された場合：

1. レポートを出力
2. 各問題について修正内容を説明
3. ユーザーに確認を求める（AskUserQuestionツールを使用）
4. 承認されたらEditツールで修正を実行
5. 修正完了後、再度チェックを実行して検証

修正の優先順位：

• Critical: 自動修正を推奨（ユーザー承認後）
• Warning: 自動修正を提案（ユーザー判断）
• Info: 情報提供のみ（修正なし）

重要な注意事項

1. 最新仕様の確認: 必ずWebSearchで最新仕様を確認すること
2. 日本語出力: すべてのレポートは日本語で出力すること
3. ファイルパスの明示: 問題箇所は必ずファイルパスと行番号を含めること
4. 修正前の確認: --fixモードでもユーザー確認を必須とすること
5. CLAUDE.md参照: プロジェクトの構造とルールは@CLAUDE.mdを参照すること

よくある問題パターン

1. agents の color フィールド

# 問題
tools: Edit, Write
color: orange

# 修正後
tools: Edit, Write

2. 不要なツールの削除

# 問題（TDDコーチの場合）
tools: Edit, MultiEdit, Write, TodoWrite, NotebookRead

# 修正後
tools: Edit, Write

3. hooks の MultiEdit

// 問題があるかWebSearchで最新仕様を確認
"matcher": "Edit|MultiEdit|Write"

// MultiEditが非推奨の場合
"matcher": "Edit|Write"

Converted and distributed by TomeVault — claim your Tome and manage your conversions.