HiAi-gg/agent-plugins-doctor

Agent Plugin Doctor スキル

このスキルは、Agent Plugin の診断と検証機能を提供します。

ランタイム要件

このスキルをインストールしても、Doctor CLI はインストール されません。Doctor は別の npm パッケージ（@agent-plugins-doctor/cli、バイナリ名 agent-plugins-doctor）であり、このスキルはターミナル経由でそれを呼び出します:

• Bun — bunx agent-plugins-doctor check <plugin-directory>
• npm — npx agent-plugins-doctor check <plugin-directory>

bunx/npx は初回使用時に npm レジストリから CLI を取得して実行します。ソースのチェックアウト、ワークスペースのビルド、グローバルインストールは不要です。Bun または npm の少なくとも一方がインストールされ、PATH 上にあり、npm レジストリにアクセスできる必要があります。どちらも利用できない場合、以下のコマンドは「command not found」エラーで失敗します。

使用すべきタイミング

ユーザーが以下のように質問した場合にこのスキルを使用してください:

• 「なぜAgent Pluginが動かないの？」
• 「このAgent Pluginをチェックして」
• 「このプラグインを修正して」
• 「このプラグインはCursor/Codex/VS Codeと互換性がある？」
• 「このAgent Pluginを監査して」
• 「このプラグインを検証して」

使用方法

Doctor CLI を実行してプラグインを検証します:

# プラグインをチェック
bunx agent-plugins-doctor check <plugin-directory>

# 安全な修正を適用
bunx agent-plugins-doctor fix <plugin-directory>

# レポートを生成
bunx agent-plugins-doctor report <plugin-directory> --format markdown

# 互換性をチェック
bunx agent-plugins-doctor compatibility <plugin-directory>

（npx agent-plugins-doctor ... も npm で同様に機能します。）

チェック内容

Doctor は以下を検証します:

• プラグインマニフェスト（plugin.json）の公式スキーマに対する検証
• スキル定義（SKILL.md ファイル）の正確性
• MCP サーバー設定（mcp.json）の妥当性
• セキュリティ問題（シークレット、パストラバーサル、シンボリックリンクエスケープ）
• 検証済みクライアント（VS Code、Cursor、GitHub Copilot、ChatGPT & Codex、Kiro）との互換性

出力

Doctor は以下を提供します:

• 診断コード付きの明確なエラーメッセージ
• ファイルの場所
• 問題の内容と理由の説明
• 可能な限り安全な自動修正
• すべての検証済みクライアントの互換性レポート

例

# カレントディレクトリを検証
bunx agent-plugins-doctor check .

# プラグインの問題を修正
bunx agent-plugins-doctor fix ./my-plugin

# マークダウンレポートを生成
bunx agent-plugins-doctor report ./my-plugin --format markdown > report.md

# 特定のクライアントとの互換性をチェック
bunx agent-plugins-doctor compatibility ./my-plugin --client cursor