Skip to main content
プラグインはクローズドベータです。アクセスをリクエストするには、support@cognition.ai までお問い合わせください。今後のリリースで、動作や設定が変更される場合があります。

プラグインとは?

プラグインは、skills — および任意でルール、フック、MCPサーバー、サブエージェント — をまとめたもので、ひとまとまりとしてインストールおよび再利用できます。ファイル形式とプラグインに含められるものについては、プラグイン リファレンス を参照してください。 管理対象のプラグイン を使うと、管理者は Devin の Web アプリからプラグインを一元的にインストールでき、org または Enterprise 内の全員に適用できます。ユーザーごとのセットアップは不要です。これは cloud Devin セッション、アカウントにログインしている Devin CLI ユーザーの両方を対象とします (Enterprise / アカウントレベルの設定は CLI にも適用されます。詳しくは クラウドセッションと CLI の違い を参照してください) 。プラグインがインストールされると、その skills は /<plugin>:<skill> コマンドとして自動的に Devin で利用できるようになります。 このページでは、プラグインの Web アプリ側について説明します。管理対象のマニフェスト、スコープ、アップロードを扱います。

設定場所

Settings → Resources → Plugins に移動します。このページには 2 つのタブがあります。
  • Marketplace — プラグイン (Devin の公式カタログに加え、組織または Enterprise が追加したもの) を参照してインストールできます。プラグインをインストールすると、選択したスコープのマニフェストに必須プラグインとして追加されるため、そのスコープ内の全員にインストールされます。
  • Configuration — プラグインの生の マニフェスト を JSON として編集し、独自のプラグインをフォルダーまたは .zip としてアップロードできます (または Editor で作成できます) 。
アクセスは権限によって制御されます。
  • org 管理者 (組織設定へのアクセス権を持つユーザー) は、org のマニフェストを管理します。
  • Enterprise 管理者 (Enterprise 設定へのアクセス権を持つユーザー) は、共有の Enterprise マニフェストも管理します。

マニフェスト

マニフェストは、3つのリストを含む1つのJSONドキュメントです。
  • requiredPlugins — スコープ内の全員にインストールされます (再帰的に、依存しているプラグインも含みます) 。
  • optionalPlugins — プラグインを自動インストールせずに許可する許可リストです。禁止された項目に対する例外を設けるために利用されます。
  • forbiddenPlugins — プラグインの識別子またはグロブパターンの拒否リストです。
マニフェストはそのまま保存され、エージェントはインストール時に完全なソースを検証します。各項目で指定できるソース形式と、完全な依存関係およびガバナンスのセマンティクスについては、プラグイン リファレンスを参照してください。

独自のプラグインを追加する

プラグイン の配置場所に応じて、次のいずれかの方法で追加します。

プラグイン バンドルのアップロード

Configuration タブの Uploaded plugin セクションでは、プラグインをフォルダーまたは .zip としてアップロードするか、Editor で直接作成できます。保存すると、必須プラグインとしてマニフェストに追加され (対象範囲内の全員にインストールされます) 、削除するとその参照も削除されます。これは、Git リポジトリでホストしたくない、またはできないプラグインに適した選択肢です。

非公開の skills リポジトリを使う

マニフェストで非公開リポジトリを直接指定します。通常は、環境スナップショットに組み込む必要はありません。Devin が Git 統合経由ですでにアクセスできる非公開リポジトリであれば、自動的にインストールされます。git URL 形式、または共有リポジトリのサブフォルダからプラグインをインストールするための git-subdir を利用してください。 (同じマニフェストを取得する CLI ユーザーは、それぞれのローカル Git 認証情報を使うため、そのユーザーにもリポジトリへのアクセス権が必要です。) リポジトリに Git 統合経由でアクセスできない場合は、バンドルとしてアップロードする (前述) か、環境セットアップ中にクローンしてローカルパスで参照してください。

更新の反映タイミング

  • マニフェストの変更 (Settings → Resources → Plugins) は、次回のセッションから適用されます。
  • プラグインの変更 — プラグインが追跡しているブランチにマージされた変更は、数時間以内に新しいセッションへ自動的に反映されます。更新を自分で管理したい場合は、プラグインを commit SHA に固定してください。CLI では、devin plugins update を実行すると即座に更新されます。
  • 実行中のセッションでは、開始時に読み込まれた内容がそのまま維持されます。更新によって進行中のセッションが途中で変更されることはありません。

スコープと継承

管理対象のマニフェストは、最大 2 つのレベルで存在します。
  • Standalone accounts には、全員に適用される単一の account マニフェストがあります。
  • Enterprises には、すべての子 org に継承される 共通の enterprise マニフェストがあり、その下に org ごとのマニフェストが重なります。Marketplace ビューには両方が表示され、Enterprise 管理者 は Enterprise スコープでプラグインをインストールすること (全体に適用) も、org 管理者 は自分の org にのみインストールすることもできます。
これらは、repo レベルおよび user レベルのプラグイン設定より上位にある、プラグイン階層全体の最上位に位置します。その他のレベルと優先順位のルールについては、継承とレベル を参照してください。

クラウドセッションと CLI の違い

クラウドセッションと Devin CLI はどちらも enterprise/account マニフェストを適用します。必須プラグインはインストールされ、禁止設定はそのアカウントにログインしている CLI ユーザーにも適用されます。 org マニフェストが適用されるのは クラウドセッション のみです。CLI はアカウントレベルで認証され、org の前提情報を持たないため、org レベルの必須事項や禁止事項は CLI ユーザーには適用されません。CLI で適用する必要があるもの (またはアカウント全体で適用する必要があるもの) は enterprise/account マニフェストに含め、org マニフェストはクラウドセッションへの org 固有の追加に利用してください。

詳しく知る

  • Skills — プラグインに同梱される SKILL.md の手順
  • CLI プラグイン リファレンス — プラグインのファイル形式、作成方法、ユーザーごとのインストール
  • プレイブック — セッションにアタッチされる再利用可能なプロンプトテンプレート