mcpField
B
bb-plugins

bb-plugins

github.com/davidondrej開発4.2k43 回インストール今日更新
リポジトリ

bb-plugins について

bb 向け TypeScript プラグインの作成、インストール、保守を扱うスキルです。拡張機能、ひな形、配布、検証に加え、プラグインが完全信頼で実行される点も説明します。

主な機能

  1. 01プラグインのひな形作成とインストール
  2. 02サーバー機能とアプリ画面の登録
  3. 03コマンド、エージェントツール、スキルの追加
  4. 04保存時の再読み込みによる開発
  5. 05状態、ログ、更新の確認
  6. 06完全信頼で動く場合のセキュリティ確認

活用シーン

  1. 01ひな形から bb プラグインを作成
  2. 02bb に画面ページやエージェントツールを追加
  3. 03読み込みに失敗するプラグインをデバッグ
  4. 04プラグインパッケージを導入して動作確認

MCP 対応

bb プラグインでエージェントツールなどを追加できると説明しています。MCP サーバーの接続や管理については記載されていません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davidondrej/skills --skill bb-plugins

インストール後、Claude Code で/bb-pluginsを入力して読み込まれたか確認します。

詳細

bb プラグイン

bb プラグインは、bb 内で実行される TypeScript パッケージです。bb を拡張するための仕組みです。

ファーストパーティ機能の多くはプラグインです。GitHub、Docs、Memory、Tasks、Connect、Automations、Secrets、Keep Awake、コーディングエージェントのプロバイダーなどがあります。

信頼

プラグインは完全に信頼されたものとして扱われます。サーバーコードは同一プロセス内で実行されます。アプリの UI はサンドボックスではなく、同一オリジンのページコードです。ホストワーカーは登録済みのマシン上で Node として実行されます。

サードパーティ製プラグインをインストールする前に、ソースを確認してください。認証情報は secret: true の設定に保存してください。

このスキルとその他のスキル

  • プラグインの作成、インストール、変更にはこのスキルを使用してください。
  • bb の操作（スレッド、プロジェクト、環境）には bb-cli を使用してください。
  • API の正確なシグネチャを確認するには、利用可能であれば bb-plugin-authoring スキルを読み、その後 bb guide plugins を実行してください。プラグインディレクトリでは、ローカル SDK の型を信頼する前に bb plugin types を実行してください。最小化された dist/ ファイルから推測しないでください。

スキャフォールド

bb plugin new hello            # add --app for a React UI
cd bb-plugin-hello
bb plugin install . --yes
bb plugin dev                  # rebuild + reload on save

マニフェストは package.json 内の bb オブジェクトです。必須項目は bb.name、bb.description、bb.branding.icon、bb.server です。任意項目は bb.app、bb.host、bb.skills、bb.themes です。

プラグイン ID は、パッケージ名の末尾のセグメントから bb-plugin- プレフィックスを取り除いたものです。bb-plugin-hello と @acme/bb-plugin-hello は、どちらも hello になります。

実行時のインポートは dependencies に記述してください。型とツールは devDependencies に残してください。Git からインストールする場合は npm install --omit=dev が実行されます。

プラグインで追加できるもの

server.ts のデフォルトエクスポートされたファクトリーは BbPluginApi を受け取り、以下の機能を登録します。

  • 設定、kv + SQLite ストレージ、HTTP、RPC、リアルタイム通信
  • バックグラウンドサービスと cron
  • トップレベルの bb <name> … コマンド 1 つ
  • エージェントツール、skills/ フォルダー、追加の指示
  • メンションプロバイダー
  • 任意のホストワーカーと実験的なエージェントプロバイダー

app.tsx は definePluginApp をデフォルトエクスポートし、ページ、スレッドパネルのアクション、コンポーザーコントロール、ファイルオープナー、置き換え用のサイドバーを追加できます。

このスキルに API 全体をコピーしないでください。機能を実装する際は bb-plugin-authoring を読んでください。

インストールと配布

bb plugin install .                                 # local path
bb plugin install github                            # bundled official plugin
bb plugin install npm:bb-plugin-notes@^1.0.0
bb plugin install git:https://github.com/acme/bb-plugin-notes.git@^1.2.0
bb plugin list
bb plugin reload <id>
bb plugin logs <id> -f

コードは完全に信頼されたものとして扱われるため、インストール時に確認を求められます。確認を省略するには --yes を渡してください。

管理対象の更新に失敗した場合はロールバックされます。カタログの更新でコードがインストールされることはありません。

コミュニティの掲載情報は https://getbb.app/marketplace/v1/marketplace.json にあります。https://github.com/get-bb/marketplace への PR で投稿してください。このワークフローには submit-a-plugin スキルを使用してください。

動作確認

  1. bb plugin list でプラグインが running と表示されることを確認します。
  2. CLI を追加した場合は、bb <command> --help が動作することを確認します。
  3. UI を追加した場合は、bb でページまたはパネルを開き、読み込まれることを確認します。
  4. ファクトリーで例外が発生すると、プラグインは error になります。bb plugin logs <id> を確認して修正し、その後 bb plugin reload <id> を実行してください。

コメント

Markdown 対応