Skip to main content
プラグインはスキルサブエージェントMCP サーバーフックをバンドルし、マーケットプレイスからまとめてインストールできるようにします。CTOR のプラグインシステムは Claude Code のプラグインエコシステムと互換性があります。

プラグインパネル

サイドバーの Plugins(プラグイン)をクリックしてパネルを開きます。この 1 つのボタンが、以前は分かれていた SkillsSub-AgentsMCP ボタンを置き換えます。 パネルには 4 つのタブがあります:
  • プラグイン — マーケットプレイスを閲覧し、プラグインをインストールする
  • スキル — 以前のスキルパネルのすべての機能(スキルを参照)
  • エージェント — 以前のサブエージェントパネルのすべての機能(サブエージェントを参照)
  • MCP — 以前の MCP パネルのすべての機能(MCP サーバーを参照)
スキル、エージェント、MCP タブは、置き換えたパネルの管理機能をすべて保持しています。

マーケットプレイスの追加

マーケットプレイスは、1 つ以上のプラグインを一覧する GitHub リポジトリ、またはローカルフォルダです。追加するまで、プラグインタブは空の状態(マーケットプレイスがありません)を表示します。 プラグインタブで、入力欄に GitHub リポジトリを入力して追加をクリックします。受け付ける形式:
  • owner/repo
  • owner/repo@refref はブランチ、タグ、またはコミット SHA
  • 任意の github.com URL
代わりにディスクからマーケットプレイスを追加するには、フォルダボタンをクリックしてローカルフォルダを選択します。 各マーケットプレイスは独自のセクションとして表示され、そのプラグインを一覧します。ローカルソースにはローカルバッジが表示され、ビルトインマーケットプレイス(後述)にはビルトインバッジが表示されます。セクションには 2 つのアクションがあります:
  • 更新 — 一覧を再取得し、プラグインの更新を確認する
  • 削除 — マーケットプレイスを削除する。インライン確認(このマーケットプレイスを削除しますか?インストール済みプラグインは残ります。)が表示される — ビルトインマーケットプレイスにはこのアクションはない

GitHub トークン認証

プラグインタブ上部で GitHub トークンを設定すると、GitHub の匿名レート制限が緩和され、そのトークンで読み取れるプライベートリポジトリを追加できるようになります。保存すると、マスクされた形式(例:••••1a2b)で表示されます — 変更するには編集、削除するにはクリアをクリックします。 追加する各 GitHub マーケットプレイスは、リポジトリの入力欄の横で認証方法を選べます: マーケットプレイスの認証モードは、そのセクションのヘッダーに**認証: **バッジとして表示されます。
トークンは暗号化されずに、平文でローカルに保存されます。マーケットプレイスに必要なリポジトリのみにスコープを絞ったトークンを使用してください。

マニフェスト形式

CTOR は次の順序でマーケットプレイスのマニフェストを読み込みます:
  1. .bricks-plugin/marketplace.json
  2. .claude-plugin/marketplace.json
両方が存在する場合は .bricks-plugin 形式が優先されます。plugin.json のみを含むリポジトリは、単一プラグインのマーケットプレイスとして扱われます。

ビルトインマーケットプレイス

CTOR には 1 つのマーケットプレイスがビルトインされています — bricks-ctor-agent-skillsmybigday/bricks-ctor-agent-skills)。常に登録済みで設定は不要、起動時と 1 日 1 回自動的に更新されます。GitHub に接続できない場合は、最後にキャッシュした内容を保持します。 ここには BRICKS チームの公式 plugin が収録されており、App Templatesapp-templates)もその 1 つです — 既存のアプリケーションを再利用可能なプロンプトテンプレートに変換し、デザイン、状態、データフローを捉えた短い要件リストとして、再構築やリミックスに使えます。マーケットプレイスから提供されるため、これらの plugin は app のリリースなしで更新できます。 そのセクションは強調表示のパネルとして、マーケットプレイス一覧の一番下に固定表示され、ビルトインバッジが付きます(ホバーするとヒントが表示されます)。削除アクションはなく、名前も予約されています — bricks-ctor-agent-skills という名前のマーケットプレイスを他のソースから追加または置き換えようとすると、「この名前はビルトインマーケットプレイスのものです。置き換えや削除はできません。」と表示されて失敗します。

プラグインカード

各プラグインは、名前、バージョン、説明に加えて、内容とインストール場所を要約するバッジを持つカードとして表示されます:
  • インストールスコープグローバルこのプロジェクト、または N 個のプロジェクト
  • MCP ×N — プラグインがバンドルする MCP サーバーの数
  • Hooks — プラグインがフックを定義しているときに表示される。有効化するまで Hooks(未承認) と表示される
カードのアクション:

プラグインのインストール

インストールをクリックすると、 をインストールダイアログが開きます。ダイアログは信頼に関する注意から始まります。
スキルはエージェントに指示を与え、プロジェクトのファイルを読み取れます。信頼できるリポジトリのプラグインのみインストールしてください。
注意の下には、インストールする項目を選べるよう、プラグインが提供するすべての内容が一覧表示されます:
  • スキルはオプトインのチェックボックスで、Select all / Select none が使えます。対象スコープに同名のスキルが既に存在する場合、そのスキルには上書きバッジが表示されます。名前が組み込みスキルと衝突するスキルには予約済みの名前バッジが表示され、スキップされます。
  • エージェントはスキルと並んで一覧表示されます。
  • MCP サーバーはサーバーごとに明示的な同意が必要で、「MCP サーバーはローカルプロセスを実行します」という注意の下に表示されます。各サーバーは解決済みの正確なコマンドラインを表示し、デフォルトではチェックされていません。
  • フックは 1 回の明示的な同意が必要で、「フックはエージェントイベント時にローカルコマンドを実行します」という注意の下に表示されます。**フックを有効化(N)**をクリックすると、同意する前にすべてのイベント、マッチャー、コマンドを確認できます。
CTOR がまだサポートしていないコンポーネントは**未対応(無視されます)**として一覧されます。これには現在スラッシュコマンドが含まれます。 インストールボタンには現在の選択数が表示されます。例:インストール(3)

インストールスコープ

このプロジェクト | グローバルのセグメントコントロールで対象スコープを選びます:
  • グローバルインストールはすべてのプロジェクトとメインチャットに適用されます。スキルは ~/.bricks-project-desktop/skills/ に配置されます。
  • プロジェクトインストールは開いているプロジェクトのみに適用されます。スキルは .bricks/skills/ に配置されます。
プラグインがインストールしたスキルは、スキルタブにプラグイン: バッジ付きで表示されます。プラグインがインストールしたエージェントはエージェントタブに表示されます(バッジは付きません)。

更新と安全性

  • プラグインの MCP サーバーはマシンローカルのレジストリに保存されます。プロジェクトの .mcp.json に書き込まれることは決してありません。
  • MCP の承認はコマンドに紐付けられます。更新後にコマンドが変わった場合は、再承認が必要です。
  • 更新は変更されていないプラグインファイルを置き換えますが、あなたが編集したスキルやエージェントを上書きすることは決してありません — 編集した版が保持されます。アンインストール時も同様です。
  • 更新はインストール時に選んだスキルのみを再展開します。更新で新たに追加されたスキルをオプトインするには、再インストールが必要です。

MCP のスコープと継承

MCP タブには独自のこのプロジェクト | グローバルの切り替えがあります。
  • グローバルはメインワークスペースの .mcp.json を編集し、「メインワークスペース — 全プロジェクトに継承されます」と表示されます。
  • プロジェクトは自身のサーバーの下にグローバルサーバーを継承します。プロジェクトのエントリが名前で優先されるため、全体の優先順位はプラグイン < 継承 < プロジェクトとなります。
  • 各プロジェクトにはグローバル MCP サーバーを継承トグルがあります。
  • 継承されたサーバーにはグローバルバッジ、プラグインのサーバーにはプラグインバッジが表示されます。
サーバーの設定と管理の方法については、MCP サーバーを参照してください。

Claude Code 互換性

既存の Claude Code プラグインやマーケットプレイスは、CTOR でそのまま動作します:
  • CTOR は .claude-plugin/ マニフェストを読み込みます。
  • MCP とフックのコマンド内の ${CLAUDE_PLUGIN_ROOT}(および ${BRICKS_PLUGIN_ROOT})を解決します。
  • 有効化されるのはスキル、エージェント、MCP サーバー、フックのみです。その他の Claude Code コンポーネントタイプは無視されます。

エラーメッセージ

インストーラーは、マーケットプレイスやプラグインを追加できないときに明確なエラーを報告します。これには以下が含まれます:
  • 無効なリポジトリ指定
  • リポジトリが見つからない、またはトークンで読み取れないプライベートリポジトリ
  • GitHub のレート制限
  • ダウンロードまたは展開の失敗
  • 欠落または無効なマニフェスト — 素のスキルリポジトリは代わりにスキルタブからインストールできます
  • サポートされていないソースタイプ