> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Local のカスタマイズ

> Devin Desktop の Devin Local agent をルール、スキル、プラグイン、MCP サーバー、フックで拡張し、各セッションで読み込まれている内容を確認します。

Devin Local には、プロジェクトでのエージェントの動作をカスタマイズする方法がいくつか用意されています。次の表を参考に、目的に合った方法を選んでください。

| 機能 | 内容 | 有効化の方法 | 使用する場面 |
| - | - | - | - |
| **[ルール](#rules)** | エージェントに*どのように振る舞うか*を指示する(例: 「npm ではなく bun を使う」) | 常時適用、または `trigger` フロントマターで指定 | コーディング規約、スタイルガイド、プロジェクトの制約 |
| **[スキル](#skills)** | 補助ファイル(スクリプト、テンプレート)をまとめた multi-step の手順 | 関連する場面でモデルが呼び出す、またはユーザーが呼び出す | エージェントが参照ファイルを必要とする複雑なタスク |
| **[プラグイン](#plugins)** | スキル、ルール、フック、MCPサーバー、サブエージェントをまとめたインストール可能なバンドル | 一度インストールすれば、プロジェクトやチーム間で共有可能 | カスタマイズ一式の配布 |
| **[MCPサーバー](#mcp-servers)** | 外部サービスのツールをエージェントに提供する | プロジェクト単位またはユーザー単位で設定 | issue トラッカー、デザインツール、社内 API |
| **[フック](#hooks)** | エージェントのライフサイクルイベントに応じてシェルコマンドやプロンプトを実行する | プロジェクト単位またはユーザー単位で設定 | ポリシーの適用、ログ記録、フォーマッター、通知 |

Devin Local は [Devin CLI](https://cli.devin.ai) とエージェントハーネスを共有しているため、すべてのカスタマイズで Devin CLI の形式と検出の仕組みが使われます。どちらか一方向けに作成したカスタマイズは、もう一方でもそのまま動作します。

他のエージェントのプロジェクトルールやワークフローをデスクトップとクラウドの両方で再利用するには、まず[移行用プロンプト](https://docs.devinenterprise.com/ja/onboard-devin/migrate-from-other-agents.md)から始めてください。

## Customize

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

このページは、エージェントのサイドバーで **Customize** をクリックすると開けます。

## ルール

ルールとは、プロジェクト内でのエージェントの動作を方向付ける永続的な指示です。ルールは各セッションの開始時にエージェントの前提情報として挿入されるため、チーム全体でエージェントの動作を一貫させることができます。

ルールは、コーディング規約、アーキテクチャのガイドライン、推奨ライブラリ、テストの規約、プロジェクト固有の制約などによく利用されます。

### AGENTS.md

ルールを追加する最も簡単な方法は、プロジェクトのルートディレクトリに `AGENTS.md` ファイルを置くことです。このファイルはフロントマターなしのプレーンな Markdown で記述します。

```markdown theme={null}
# プロジェクトルール

- 新しいファイルはすべて TypeScript で作成する
- src/components/ の既存のパターンに従う
- コミット前に必ず `npm run lint` を実行する
- npm や yarn ではなく pnpm を使用する
```

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

### ルールファイル

より細かく制御するには、`.devin/rules/*.md` にルールを1ファイルにつき1つずつ配置します。各ファイルでは、`trigger` フロントマターで適用タイミングを指定できます。

```markdown theme={null}
---
trigger: glob
globs: "**/*.test.ts"
---

すべてのテストファイルで `describe`/`it` ブロックを使用し、外部APIの呼び出しはモックすること。
```

| `trigger:` の値 | ルールがエージェントに渡されるタイミング |
| - | - |
| `always_on` | すべてのセッション |
| `glob` | エージェントが `globs` にマッチするファイルを扱うとき |
| `model_decision` | ルールの説明が関連するとエージェントが判断したとき |
| `manual` | ユーザーが呼び出したときのみ |

`.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](https://docs.devinenterprise.com/ja/cli/extensibility/rules.md) を参照してください。

### ベストプラクティス

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

## スキル

難易度の高いエンジニアリングタスクでは、優れたプロンプトだけでは足りないことがよくあります。参照用のスクリプト、テンプレート、チェックリストなど、さまざまな補助ファイルが必要になる場合もあります。スキルを利用すると、これらをまとめてフォルダにバンドルし、エージェントから呼び出せるようにできます。

スキルは**段階的開示**の仕組みを採用しています。デフォルトでモデルに提示されるのは、スキルの `name` と `description` だけです。`SKILL.md` の全内容と補助ファイルは、エージェントがスキルを呼び出すと判断したとき、またはあなたがスキルを呼び出したときにのみ読み込まれます。そのため、多数のスキルを定義していても、前提情報ウィンドウを無駄なく使えます。

### スキルの作成

ディレクトリを作成し、その中に `SKILL.md` ファイルを置きます。このファイルの YAML フロントマターで、スキルの名前と説明を指定します。

```markdown theme={null}
---
name: deploy-to-production
description: 安全チェックを行いながら、本番環境へのデプロイ手順をガイドします
---

## デプロイ前チェックリスト
1. すべてのテストを実行する
2. 未コミットの変更がないかチェックする
3. 環境変数を確認する

## デプロイ手順
以下の手順に従って安全にデプロイします...
```

* **name**: スキルの一意の識別子 (英小文字、数字、ハイフンのみ) 。スキルを呼び出す際に利用します。
* **description**: モデルに提示される簡潔な説明で、モデルがスキルを呼び出すタイミングを判断する際の手がかりになります。スキルが何をするのか、どのような場合に利用するのかを具体的に記述してください。

補助ファイルは、スキルフォルダ内の `SKILL.md` と同じ場所に配置します。スキルが呼び出されると、エージェントはこれらのファイルを利用できるようになります：

```
.devin/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

### スキルの呼び出し

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

### スキルのスコープ

| スコープ | 場所 | 利用範囲 |
| - | - | - |
| ワークスペース | `.devin/skills/<name>/` (`.agents/skills/` とレガシーの `.windsurf/skills/` も読み込まれます) | 現在のワークスペースのみ。リポジトリにコミットされます。 |
| Global | `~/.config/devin/skills/<name>/` (`~/.agents/skills/` も読み込まれます) | マシン上のすべてのワークスペース。コミットされません。 |
| プラグイン | インストール済みの[プラグイン](#plugins)内 | プラグインがインストールされているすべての場所。 |

スキルのトリガー、権限、サードパーティ製スキルについては [Devin CLI のスキルに関するドキュメント](https://docs.devinenterprise.com/ja/cli/extensibility/skills/overview.md)を、スキル作成のガイダンスについては[スキルの作成](https://docs.devinenterprise.com/ja/cli/extensibility/skills/creating-skills.md)を参照してください。

## プラグイン

プラグインは、スキル、ルール、フック、MCP サーバー、サブエージェントをエージェントに追加する、インストール可能なバンドルです。プラグインは GitHub リポジトリ、git URL、リポジトリ内のサブフォルダ、またはローカルフォルダからインストールでき、インストールしたプラグインのスキルは `/<plugin>:<skill>` コマンドとして使用できます。プラグインの形式、`devin plugins` コマンド、ガバナンスについては、[プラグイン](https://docs.devinenterprise.com/ja/cli/extensibility/plugins/overview.md)を参照してください。

> [!WARNING]
>
> ここでいう**プラグイン**とは、Devin の*エージェント*プラグインのことです。Devin を JetBrains や VS Code などのエディタで使えるようにする [Windsurf プラグイン](https://docs.devinenterprise.com/ja/windsurf/plugins/getting-started.md)や、Devin Desktop 内にインストールする[エディタ拡張機能](https://docs.devinenterprise.com/ja/desktop/recommended-extensions.md)とは別物です。これらはいずれも、エージェントではなく IDE を拡張するものです。

## MCPサーバー

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

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

エージェントウィンドウから **Customize** ページを開き、**MCPs** をクリックします。上部の **Install MCPs for** セレクターでスコープ (例: **This computer**) を選択します。

* **This computer** には、ウィンドウで開いているフォルダに対してローカルエージェントが読み込むサーバーが一覧表示されます。ここでは、サーバーのオン／オフの切り替え、設定ファイルの表示、リストの更新を行えます。
* **Available** には、MCPレジストリに登録されているサーバーが一覧表示されます。サーバーの **Install** をクリックすると追加できます。

エンタープライズ管理者は、チーム設定の **MCP & ACP** でレジストリを管理します。**MCPレジストリ** タブには、MCP 許可リストに加えてレジストリの項目にマッチするサーバーも許可するためのトグルと、レジストリ URL を指定する **Registry** 設定 (**Configure**) があります。複数のレジストリが設定されている場合、Devin Desktop はそれらすべての和集合を使用します。カスタムレジストリは [公式 MCPレジストリスキーマ](https://modelcontextprotocol.io/) に準拠している必要があります。

### 設定

MCPサーバーは、ローカルマシン上の[設定ファイル](https://docs.devinenterprise.com/ja/cli/extensibility/mcp/configuration.md)で設定します。ファイルの場所はスコープによって決まります。

| スコープ | 場所 | チームと共有 |
| - | - | - |
| プロジェクト | `.devin/mcp_config.json` | する (バージョン管理にコミット) |
| ローカル上書き設定 | `.devin/mcp_config.local.json` | しない (Gitの追跡対象から除外) |
| ユーザー | `~/.config/devin/mcp_config.json` | しない |

Devin Local は `stdio`、`Streamable HTTP`、`SSE` の各トランスポートをサポートしており、いずれも OAuth に対応しています。

### 権限

デフォルトでは、エージェントはMCPツールを呼び出す前に必ず承認を求めます。ツールやサーバーを許可する方法や、管理者が信頼済みの連携をデフォルトで許可する方法については、[MCP権限](https://docs.devinenterprise.com/ja/desktop/devin-local/permissions.md#mcp-permissions)を参照してください。

### 再認証

サーバーに保存されているOAuth認証情報の有効期限が切れると、そのサーバーは **Needs authentication** 状態になります。この状態は、**This computer** リスト、**Available** カード、およびサーバーの詳細ページに表示されます。

**Authenticate** をクリックすると、保存されている認証情報がクリアされ、ブラウザでの認可フローがもう一度実行されます。

## フック

フックは、ツール呼び出しの前など、エージェントのライフサイクルにおける特定のイベントの発生時にカスタムロジックを実行します。各フックは、シェルコマンドまたは LLM prompt のいずれかです。フックを利用すると、ポリシーの強制適用、前提情報の追加、アクションの記録、権限の変更、外部システムとの連携などを行えます。

フックは、プロジェクト内の `.devin/hooks.v1.json` またはユーザー階層で設定します。たとえば、次のフックはすべてのシェルコマンドの実行前にスクリプトを実行し、そのコマンドをブロックできます：

```json theme={null}
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}
```

ワークスペースが[制限モード](https://docs.devinenterprise.com/ja/desktop/devin-local/overview.md#restricted-mode)で開かれている間は、フックの読み込みも実行も行われません。

フックイベント、設定形式、終了コード、使用例については、[フック](https://docs.devinenterprise.com/ja/cli/extensibility/hooks/overview.md)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.