Skip to main content
プラグインは クローズドベータ です。アクセスをリクエストするには、support@cognition.ai までお問い合わせください。動作や設定は今後のリリースで変更される場合があります。
このガイドでは、独自のプラグインエコシステムを構築する方法を説明します。これは、組織が所有するプラグインのリポジトリを、管理対象のマニフェストを通じてすべてのDevinセッションとCLIユーザーに配布し、必須・任意・禁止の各プラグインをガバナンスの制御手段として使う構成です。 このガイドには、2つのテンプレートリポジトリが付属しています。
  • plugin-template — 単一のプラグイン (または少数のプラグイン) を作成するためのスターターテンプレートです。
  • team-marketplace-template — 完全なエコシステムの構成パターンです。プラグインのモノレポに加え、マニフェストでベースラインとポリシーを定義するメタプラグインも含まれています。

1. プラグインを作成する

プラグインとは、.devin-plugin/plugin.json マニフェストを含むディレクトリのことです。それ以外はすべて任意です。
まずは plugin-template をフォークし、完全なフォーマットについては CLI プラグイン リファレンス を参照してください。AGENTS.md は短く保ってください。そのプラグインを使う全員のすべてのセッションで前提情報を消費してしまうためです。

2. ローカルで検証とテストを行う

どちらのテンプレートにも、バリデーター (node scripts/validate-template.mjs) と、すべてのPRでこれを実行するCIワークフローが含まれています。実際に試すには、Devin CLIを使ってローカルフォルダーからインストールします:

3. 1つのリポジトリで管理する

組織のすべてのプラグインを1つのリポジトリ内のサブフォルダ (plugins/<name>/) に配置し、それぞれを固有のgit-subdirソースで参照します。リポジトリは非公開のままでも問題ありません。クラウドセッションはGit統合を通じてこれを取得し、CLIユーザーは各自のgit認証情報で取得します (そのため、リポジトリへのアクセス権も必要です) 。 この構成には、team-marketplace-template をフォークし、そのメタプラグインのgit-subdir URLが自分のforkを指すように更新してください。テンプレートでは、メタプラグインはリポジトリのルートにあるため、リポジトリ自体がインストール可能な単位になります。つまり、your-org/your-marketplaceを指定すると、ベースライン全体がインストールされます。

4. メタプラグインでベースラインを定義する

メタプラグインパターンを使うと、エコシステム全体を1つのインストール可能な単位として扱えます。これは、それ自体にはほとんど、またはまったく内容を持たないプラグインで、マニフェストがその役割を果たします。リポジトリ 自体がメタプラグインになるように、リポジトリ のルートに配置します:

5. Settings → Marketplace から配布する

管理者は、Marketplace 設定ページ の管理対象マニフェストにエントリを 1 つ追加します。詳しくは、プラグイン marketplace ガイド を参照してください:
marketplace リポジトリ を必須にすると、そのルートのメタプラグインがインストールされ、ベースライン全体が再帰的に取り込まれます。 これで、スコープ内の全員にベースラインが自動的に適用されます。スコープは慎重に選んでください。
  • enterprise/account マニフェスト は、クラウドセッション、その account にログインしている CLI user に適用されます。
  • 組織 マニフェスト は、クラウドセッションにのみ適用されます。CLI には 組織 の前提情報がありません。

6. ガバナンス

3 つのリストが、すべてのレベル (managed マニフェストs、リポジトリ config、プラグイン マニフェストs) で共通のポリシー言語です。競合する場合は、より上位のレベルが優先されます。つまり、enterprise/account は 組織 より、組織 は リポジトリ より、リポジトリ は user より優先され、上位レベルで禁止されたものを下位レベルで再び許可することも、上位レベルで必須とされたものを禁止することもできません。 account を承認済みのもののみに制限するには:
マニフェスト 自身の required/optional エントリは、その マニフェスト 自身の "*" による禁止の対象外ですが、それ以外は対象外ではなく、下位レベルでこの例外範囲を広げることもできません。この例外が適用されるのは 直接列挙された エントリだけであり、required プラグイン の推移的な依存関係は対象外になりません。したがって、ロックダウン下では、メタプラグイン が取り込むもの (ここでは engineering-baselinesecurity-guardrails) をすべて明示的に列挙してください。完全な仕様については governance rules を参照してください。

7. 発展

  • プラグインリポジトリのデフォルトブランチにマージすること自体がリリースです。新しいセッションには自動的に反映されます。詳しくは、更新のロールアウト方法 を参照してください。
  • チームは marketplace リポジトリに PR でプラグインを追加し、テンプレートの CI が各 PR でレイアウトを検証します。
  • 既存の Claude プラグインはそのままインストールできます (Devin は .claude-plugin/plugin.json にフォールバックします) 。そのため、optionalPlugins ではコミュニティプラグインをリポジトリに取り込まずに推奨できます。

現在の制限事項

  • プラグインはクラウドセッション、Devin CLI、および Devin Desktop (Devin Local を利用する場合) で読み込まれます。クラシックな Cascade エージェントには適用されません。
  • サブエージェント (agents/<name>.md または agents/<name>/AGENT.md) はローカルの Devin エージェント (CLI と Devin Desktop) でのみ読み込まれ、クラウドセッションでは読み込まれません。
  • フック: クラウドセッションでは、SessionStartSessionEnd を除くすべてのeventcommand フックが実行されます。prompt タイプのフックは CLI/ローカル環境でのみ利用できます。
  • プラグイン経由で提供される MCP はセッション内で読み込まれますが、MCP の設定 UI にはまだ表示されません。
  • 組織レベル のマニフェストは CLI ユーザーには反映されません。CLI への適用には enterprise/account マニフェストを利用してください。

詳細はこちら