メインコンテンツへスキップ
Devin Local には、プロジェクトでのエージェントの動作をカスタマイズする方法がいくつか用意されています。次の表を参考に、目的に合った方法を選んでください。 Devin Local は Devin CLI とエージェントハーネスを共有しているため、すべてのカスタマイズで Devin CLI の形式と検出の仕組みが使われます。どちらか一方向けに作成したカスタマイズは、もう一方でもそのまま動作します。 他のエージェントのプロジェクトルールやワークフローをデスクトップとクラウドの両方で再利用するには、まず移行用プロンプトから始めてください。

Customize

エージェントウィンドウの Customize ページには、プラグイン、スキル、MCPs、フック、ルール、サブエージェントの各タブがあります。各タブには、エージェントが読み込んでいる項目に加えて、あなたのリポジトリ、組織、アカウントで利用できる項目が一覧表示されます。 このページは、エージェントのサイドバーで Customize をクリックすると開けます。

ルール

ルールとは、プロジェクト内でのエージェントの動作を方向付ける永続的な指示です。ルールは各セッションの開始時にエージェントの前提情報として挿入されるため、チーム全体でエージェントの動作を一貫させることができます。 ルールは、コーディング規約、アーキテクチャのガイドライン、推奨ライブラリ、テストの規約、プロジェクト固有の制約などによく利用されます。

AGENTS.md

ルールを追加する最も簡単な方法は、プロジェクトのルートディレクトリに AGENTS.md ファイルを置くことです。このファイルはフロントマターなしのプレーンな Markdown で記述します。
AGENTS.md、AGENTS.local.md (バージョン管理に含めない個人用ルール向け) 、AGENT.md は、いずれも常時適用のルールとして読み込まれます。エージェントは、ワークスペースのルートと、ワークスペースのルートから作業中のディレクトリまでの各ディレクトリにあるこれらのファイルを読み込みます。そのため、サブディレクトリに AGENTS.md を配置すると、そのディレクトリ固有のガイダンスを指定できます。

ルールファイル

より細かく制御するには、.devin/rules/*.md にルールを1ファイルにつき1つずつ配置します。各ファイルでは、trigger フロントマターで適用タイミングを指定できます。
.devin/global_rules.md は、常時適用される単一のファイルです。同じファイルをホームディレクトリ (~/.devin/rules/*.md、~/.devin/global_rules.md) に配置すると、すべてのプロジェクトに適用されます。 レガシーの .windsurf/rules/*.md、.windsurf/global_rules.md、.windsurfrules ファイルはデフォルトでインポートされます。ルールファイルは .devin/rules/ と .windsurf/rules/ の両方から読み込まれますが、global_rules.md が両方に存在する場合は .devin/global_rules.md のみが読み込まれます。ファイルの完全な一覧、インポート設定、他のツールのルールについては、ルールと AGENTS.md を参照してください。

ベストプラクティス

  • ルールは短く具体的に記述してください。ルールはすべてのセッションの前提情報に含まれるため、メッセージごとにトークンを消費します。
  • エージェントがときどきしか必要としない内容にはスキルを利用し、特定の状況でどのスキルを利用すべきかはルールでエージェントに示してください。
  • ルールは箇条書き、番号付きリスト、Markdown の見出しを使って記述してください。長い段落よりもエージェントが従いやすくなります。
  • 「良いコードを書く」のような汎用的なルールは不要です。

スキル

難易度の高いエンジニアリングタスクでは、優れたプロンプトだけでは足りないことがよくあります。参照用のスクリプト、テンプレート、チェックリストなど、さまざまな補助ファイルが必要になる場合もあります。スキルを利用すると、これらをまとめてフォルダにバンドルし、エージェントから呼び出せるようにできます。 スキルは段階的開示の仕組みを採用しています。デフォルトでモデルに提示されるのは、スキルの name と description だけです。SKILL.md の全内容と補助ファイルは、エージェントがスキルを呼び出すと判断したとき、またはあなたがスキルを呼び出したときにのみ読み込まれます。そのため、多数のスキルを定義していても、前提情報ウィンドウを無駄なく使えます。

スキルの作成

ディレクトリを作成し、その中に SKILL.md ファイルを置きます。このファイルの YAML フロントマターで、スキルの名前と説明を指定します。
  • name: スキルの一意の識別子 (英小文字、数字、ハイフンのみ) 。スキルを呼び出す際に利用します。
  • description: モデルに提示される簡潔な説明で、モデルがスキルを呼び出すタイミングを判断する際の手がかりになります。スキルが何をするのか、どのような場合に利用するのかを具体的に記述してください。
補助ファイルは、スキルフォルダ内の SKILL.md と同じ場所に配置します。スキルが呼び出されると、エージェントはこれらのファイルを利用できるようになります:

スキルの呼び出し

リクエストがスキルの説明に合致すると、エージェントはそのスキルを自動的に呼び出し、記載された指示に従います。スキルを確実に利用させたい場合は、/skill-name のように名前を指定して呼び出すこともできます。

スキルのスコープ

スキルのトリガー、権限、サードパーティ製スキルについては Devin CLI のスキルに関するドキュメントを、スキル作成のガイダンスについてはスキルの作成を参照してください。

プラグイン

プラグインは、スキル、ルール、フック、MCP サーバー、サブエージェントをエージェントに追加する、インストール可能なバンドルです。プラグインは GitHub リポジトリ、git URL、リポジトリ内のサブフォルダ、またはローカルフォルダからインストールでき、インストールしたプラグインのスキルは /<plugin>:<skill> コマンドとして使用できます。プラグインの形式、devin plugins コマンド、ガバナンスについては、プラグインを参照してください。
ここでいうプラグインとは、Devin のエージェントプラグインのことです。Devin を JetBrains や VS Code などのエディタで使えるようにする Windsurf プラグインや、Devin Desktop 内にインストールするエディタ拡張機能とは別物です。これらはいずれも、エージェントではなく IDE を拡張するものです。

MCPサーバー

MCP (Model Context Protocol) は、GitHub、データベース、issue トラッカーなどの外部サービスが提供するツールをエージェントが利用できるようにするプロトコルです。詳しくは MCP の公式ドキュメントを参照してください。

MCP サーバーのインストール

エージェントウィンドウから Customize ページを開き、MCPs をクリックします。上部の Install MCPs for セレクターでスコープ (例: This computer) を選択します。
  • This computer には、ウィンドウで開いているフォルダに対してローカルエージェントが読み込むサーバーが一覧表示されます。ここでは、サーバーのオン/オフの切り替え、設定ファイルの表示、リストの更新を行えます。
  • Available には、MCPレジストリに登録されているサーバーが一覧表示されます。サーバーの Install をクリックすると追加できます。
エンタープライズ管理者は、チーム設定の MCP & ACP でレジストリを管理します。MCPレジストリ タブには、MCP 許可リストに加えてレジストリの項目にマッチするサーバーも許可するためのトグルと、レジストリ URL を指定する Registry 設定 (Configure) があります。複数のレジストリが設定されている場合、Devin Desktop はそれらすべての和集合を使用します。カスタムレジストリは 公式 MCPレジストリスキーマ に準拠している必要があります。

設定

MCPサーバーは、ローカルマシン上の設定ファイルで設定します。ファイルの場所はスコープによって決まります。 Devin Local は stdio、Streamable HTTP、SSE の各トランスポートをサポートしており、いずれも OAuth に対応しています。

権限

デフォルトでは、エージェントはMCPツールを呼び出す前に必ず承認を求めます。ツールやサーバーを許可する方法や、管理者が信頼済みの連携をデフォルトで許可する方法については、MCP権限を参照してください。

再認証

サーバーに保存されているOAuth認証情報の有効期限が切れると、そのサーバーは Needs authentication 状態になります。この状態は、This computer リスト、Available カード、およびサーバーの詳細ページに表示されます。 Authenticate をクリックすると、保存されている認証情報がクリアされ、ブラウザでの認可フローがもう一度実行されます。

フック

フックは、ツール呼び出しの前など、エージェントのライフサイクルにおける特定のイベントの発生時にカスタムロジックを実行します。各フックは、シェルコマンドまたは LLM prompt のいずれかです。フックを利用すると、ポリシーの強制適用、前提情報の追加、アクションの記録、権限の変更、外部システムとの連携などを行えます。 フックは、プロジェクト内の .devin/hooks.v1.json またはユーザー階層で設定します。たとえば、次のフックはすべてのシェルコマンドの実行前にスクリプトを実行し、そのコマンドをブロックできます:
ワークスペースが制限モードで開かれている間は、フックの読み込みも実行も行われません。 フックイベント、設定形式、終了コード、使用例については、フックを参照してください。