SpyBara
Go Premium

plugins/relevance.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 247 additions and 0 deletions.

2026
Fri 25 23:58

組織向けプラグインを推奨する

マーケットプレイスプラグインエントリに関連性ブロックを追加して、ユーザーの作業が一致するときに Claude Code が推奨するようにし、マネージド設定でマーケットプレイスをホワイトリストに登録します。

Claude Code は、ユーザーのセッションが定義したシグナルと一致するときに、組織のマーケットプレイスからプラグインをインストールすることを提案できます。シグナルには、作業ディレクトリ、Claude が読み取ったファイル、および Claude が実行したコマンドが含まれます。これらは、プラグインの marketplace.json エントリに relevance ブロックを追加することで定義します。

マーケットプレイスオペレーターが relevance エントリを記述します。その後、管理者がマネージド設定でマーケットプレイスをホワイトリストに登録します。マーケットプレイスがホワイトリストに登録されるまで、ユーザーはそのマーケットプレイスからの提案を表示しません。

自分の役割に応じたセクションから始めてください。

プラグイン関連性の仕組みを理解する

marketplace.json の各プラグインエントリには、relevance オブジェクトを含めることができます。このオブジェクトはトピックと 1 つ以上のシグナルを指定します。シグナルは、作業ディレクトリやClaudeが読み取ったファイルなど、Claude Code が現在のセッションに対してテストするパターンです。

シグナルマッチングはユーザーのマシン上でローカルに実行され、ネットワークトラフィックは追加されません。Claude Code は、どのシグナルが一致したか、またはそれらの値を Anthropic またはマーケットプレイス運営者に報告しません。

シグナルが一致し、プラグインがまだインストールされていない場合、Claude Code は以下の場所でプラグインを提案します。

  • スピナーチップ: Claude が応答している間、スピナーの下に /plugin install コマンドを含むメッセージが表示されます。
  • セッション開始通知: cwd シグナルが作業ディレクトリと一致する場合、ユーザーが最初のメッセージを送信する前に 1 行の通知が表示されます。
  • /plugin Discover タブ: プラグインは Discover リストの上部にピン留めされます。

ユーザーが見るものをプレビューするは、各テキストの正確なテキストと、それらがどのくらいの頻度で繰り返されるかを示しています。

Claude Code はプラグインを自動的にインストールすることはありません。ユーザーは常に確認します。

スピナーチップとセッション開始通知の両方は、ユーザーまたはプロジェクトが spinnerTipsEnabled を false に設定するか、excludeDefault を含む spinnerTipsOverride が組み込みチップを置き換える場合に表示されなくなります。Discover タブのピンはどちらの設定にも影響されません。

プラグインエントリに関連性を追加する

marketplace.json のプラグインエントリに relevance オブジェクトを追加します。次の例は、Claude が .tf ファイルを読み取るか terraform を実行するときに terraform-helpers プラグインが関連していることを宣言しています。

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    {
      "name": "terraform-helpers",
      "source": "./plugins/terraform-helpers",
      "description": "Your organization's Terraform conventions and helpers",
      "relevance": {
        "topic": "Terraform",
        "signals": {
          "cli": ["terraform"],
          "filesRead": ["**/*.tf"]
        }
      }
    }
  ]
}

シグナルが一致しない場合、プラグインは Discover リストで通常の位置を保持し、スピナーチップとして表示されません。

公開する前にブロックを確認するには、マーケットプレイスを検証してください。

フィールドリファレンス

relevance オブジェクトとそのネストされた signals オブジェクトは、次の表のフィールドを受け入れます。

古いクライアントは、認識しない relevance フィールドを使用するマーケットプレイスをまだロードします。これは、relevance と relevance.signals の下の未知のフィールドはロード時に無視されるためです。認識されたフィールドの値がフィールドリファレンスの制限を超える場合、プラグインエントリ全体が無効になり、ユーザーはそのプラグインをマーケットプレイスからインストールできなくなります。修正するまで、claude plugin validate は同じ制限を報告します。

`relevance`

フィールド 型 説明
topic 文字列 オプション。スピナーチップの「Working with topic?」を埋める句。デフォルトはプラグイン名で、各ハイフンセグメントが大文字化されます。最大 64 文字。
signals オブジェクト プラグインが関連するときを決定するマッチャー。Claude Code は、少なくとも 1 つのシグナルが設定されている場合にのみプラグインを提案します。relevance.signalsを参照してください。

topic は多くの場合、製品名（例：Terraform）です。プラグイン名がトピックとして自然に聞こえない場合は、design などのドメインを使用してください。

`relevance.signals`

signals オブジェクトは、次のフィールドを受け入れます。

フィールド 型 説明 制限
cwd 文字列の配列 セッションの作業ディレクトリに対してマッチするグロブパターン。作業ディレクトリマッチングを参照してください。 256 文字以下の 10 パターン
cli 文字列の配列 Claude がこのセッションで実行したシェルコマンドからのコマンド名（例：["terraform"]）。完全一致。コマンド名マッチングを参照してください。 64 文字以下の 10 エントリ
hosts 文字列の配列 このセッションの Bash コマンドの http:// または https:// URL に表示されるホスト名（例：["registry.terraform.io"]）。ベアの小文字ホスト名のみ：スキーム、ポート、またはパスなし。完全な大文字と小文字を区別しないマッチング。 128 文字以下の 20 エントリ
filesRead 文字列の配列 Claude がこのセッションで読み取ったファイルのパスに対してマッチするグロブパターン（例：["**/*.tf"]）。フォワードスラッシュで正規化され、大文字と小文字を区別しません。 256 文字以下の 10 パターン
manifestDeps オブジェクトの配列 Claude がこのセッションで読み取ったパッケージマニフェストで宣言された依存関係。各エントリは { "file": "...", "pattern": "..." } で、両方の値は正規表現です。マニフェスト依存関係マッチングを参照してください。 10 エントリ、各値は最大 256 文字。512 KB より大きいマニフェストファイルはスキップされます

filesRead と manifestDeps シグナルは、Claude がこのセッションで書き込みまたは編集したファイル、およびプロジェクトの自動ロードされた CLAUDE.md メモリファイルに対してもマッチします。

作業ディレクトリマッチング

cwd は、セッション開始時、ユーザーが最初のメッセージを送信する前にマッチできる唯一のシグナルです。

Claude Code は各 cwd パターンを次のようにマッチします。

  • パターンは、作業ディレクトリを絶対パスとしてマッチします。セッションが git リポジトリ内にある場合、リポジトリルートに対する作業ディレクトリのパスに対してもマッチします。
  • マッチングはフォワードスラッシュで正規化され、大文字と小文字を区別しません。
  • すべてのパターンはディレクトリ自体とその下のすべてにマッチするため、infra、infra/、および infra/** は同じように動作します。

コマンド名マッチング

Claude Code は、Claude が実行する各シェルコマンドに対して 1 つのコマンド名を記録します。これは、先頭の環境変数割り当てと sudo の後の最初のトークンです。複合コマンドは先頭のコマンドのみを提供するため、cd infra && terraform plan は terraform ではなく cd を記録します。

マニフェスト依存関係マッチング

各 manifestDeps エントリは、2 つの JavaScript RegExp ソース文字列をペアにします。

  • file: マニフェストファイルのパスに対して大文字と小文字を区別しないでマッチします。パスは通常絶対パスであるため、開始ではなく終了にパターンをアンカーしてください。パスはこのシグナルに対して区切り文字で正規化されないため、Windows パスはバックスラッシュを使用します。
  • pattern: そのファイルの内容に対して大文字と小文字を区別してマッチします。

次の例は、manifestDeps を使用して、Claude が SDK の npm パッケージ（ここでは your-sdk という名前）に依存する package.json を読み取った後、プラグインを提案しています。

{
  "name": "your-plugin",
  "source": "./plugins/your-plugin",
  "relevance": {
    "signals": {
      "manifestDeps": [
        {
          "file": "[/\\\\]package\\.json$",
          "pattern": "\"your-sdk\"\\s*:"
        }
      ]
    }
  }
}

この例では、file パターンは [/\\\\] を使用してフォワードスラッシュとバックスラッシュの両方のパス区切り文字にマッチし、\\. はドットがリテラルであることを示します。JSON では、正規表現の各バックスラッシュは 2 回書き込まれます。

マーケットプレイスを検証する

シェルで、マーケットプレイスディレクトリに対して claude plugin validate を実行して、公開する前に relevance ブロックを確認します。

claude plugin validate ./my-marketplace

バリデーターは relevance ブロックのエラーと警告を報告します。これには以下が含まれます。

  • relevance と relevance.signals の下の未知のキーを警告として報告します
  • オブジェクトではない relevance 値にフラグを立てます
  • スキーム、ポート、またはパスを含む signals.hosts エントリを拒否します

各検出結果は、それが関係するフィールドのパスとともに出力され、出力は Validation passed、Validation passed with warnings、または Validation failed で終わります。

マネージド設定で提案を有効にする

ユーザーは、マーケットプレイスの marketplace.json が relevance を宣言している場合でも、管理者が マネージド設定 でそれをホワイトリストに登録するまで、マーケットプレイスからの提案を表示されません。

マーケットプレイスをホワイトリストに登録するには、マネージド設定を次のように編集します。

  • マーケットプレイス名を pluginSuggestionMarketplaces に追加します。
  • 公式 Anthropic マーケットプレイス以外のマーケットプレイスについては、マーケットプレイスソースも宣言します。その名前のエントリとして extraKnownMarketplaces に、またはエントリとして strictKnownMarketplaces に宣言します。

マーケットプレイスが登録されていないマシン、または異なるソースからホワイトリストに登録された名前で登録されているマシンでは、そこからの提案は表示されません。ソースチェックにより、関連のないソースがホワイトリストに登録された名前で登録されて、その プラグインが組織全体で提案されるのを防ぎます。

次の managed-settings.json は、GitHub リポジトリから組織マーケットプレイスを登録し、その提案を有効にします。

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "github",
        "repo": "your-org/your-marketplace"
      }
    }
  },
  "pluginSuggestionMarketplaces": ["your-marketplace"]
}

公式マーケットプレイスの名前は公式 Anthropic ソースからのみ登録できるため、ソース宣言は不要です。公式マーケットプレイスについては、名前だけをホワイトリストに登録します。

{
  "pluginSuggestionMarketplaces": ["claude-plugins-official"]
}

ユーザーが見るものをプレビューする

プラグインの relevance シグナルがセッション中にマッチする場合、スピナーの下のチップは次のように読みます。

Working with Terraform? Install the terraform-helpers plugin:
/plugin install terraform-helpers@your-marketplace

cwd シグナルがセッション開始時にマッチする場合、1 行の通知は次のように読みます。

plugin suggestion: terraform-helpers@your-marketplace · /plugin

/plugin Discover タブでは、プラグインは他の結果の上にピン留めされ、suggested for this directory または suggested for terraform commands などのマッチングシグナルを指定する注釈が付きます。

Claude Code は、特定のプラグインを提案する頻度を制限します。

  • 提案は、スピナーチップとセッション開始通知を合わせて、最大 3 セッションごとに 1 回表示されます。
  • セッション開始通知は、スピナーチップと通知がプラグインを合わせて 2 回表示されたら表示されなくなります。
  • スピナーチップもセッション開始通知も、プラグインがインストールされたら繰り返されません。
  • Discover タブは、プラグインのシグナルがマッチしている間にユーザーがタブを初めて開くときにプラグインをピン留めします。Claude Code はそれを ~/.claude.json に記録するため、ユーザーがそのマシンで /plugin を開くたびに、プラグインは通常の順序で表示されます。

関連項目