> ## 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.

# Personnalisations de Devin Local

> Étendez le Local Agent de Devin dans Devin Desktop avec des règles, des compétences, des extensions, des serveurs MCP et des hooks, et consultez ce que chaque session a chargé.

Devin Local propose plusieurs façons de personnaliser le fonctionnement de l’agent dans vos projets. Ce tableau vous aide à choisir la plus adaptée :

| Fonctionnalité | Rôle | Activation | Cas d’usage |
| - | - | - | - |
| **[Règles](#rules)** | Indiquent à l’agent *comment se comporter* (p. ex. « utiliser bun, pas npm ») | Toujours actives, ou via le frontmatter `trigger` | Conventions de code, guides de style, contraintes du projet |
| **[Compétences](#skills)** | Procédures à plusieurs étapes accompagnées de fichiers complémentaires (scripts, modèles) | Invoquées par le modèle lorsque c’est pertinent, ou par vous | Tâches complexes pour lesquelles l’agent a besoin de fichiers de référence |
| **[Extensions](#plugins)** | Paquets installables regroupant compétences, règles, hooks, serveurs MCP et sous-agents | Installées une seule fois, puis partagées entre projets et équipes | Distribution d’un ensemble de personnalisations |
| **[Serveurs MCP](#mcp-servers)** | Donnent à l’agent accès à des outils de services externes | Configurés par projet ou par utilisateur | Outils de suivi des tickets, outils de design, API internes |
| **[Hooks](#hooks)** | Exécutent des commandes shell ou des prompts lors des événements du cycle de vie de l’agent | Configurés par projet ou par utilisateur | Application de politiques, journalisation, outils de formatage, notifications |

Devin Local partageant son moteur d’agent avec [Devin CLI](https://cli.devin.ai), toutes les personnalisations reposent sur le format et le mécanisme de découverte de Devin CLI : une personnalisation écrite pour l’un fonctionne donc dans l’autre.

Pour réutiliser les règles de projet et les workflows d’un autre agent à la fois dans Desktop et dans Cloud, commencez par le [prompt de migration](https://docs.devinenterprise.com/fr/onboard-devin/migrate-from-other-agents.md).

## Personnaliser

La page **Personnaliser** de la fenêtre Agents comporte les onglets **Extensions**, **Compétences**, **MCPs**, **Hooks**, **Règles** et **Sous-agents**. Chaque onglet répertorie les éléments chargés par l’agent, ainsi que ceux proposés par votre dépôt, votre organisation et votre compte.

Pour l’ouvrir, cliquez sur **Personnaliser** dans la barre latérale de l’agent.

## Règles

Les règles sont des instructions persistantes qui orientent le comportement de l'agent dans votre projet. Elles sont injectées dans le contexte de l'agent au début de chaque session, ce qui garantit un comportement cohérent au sein de votre équipe.

Les règles servent généralement à définir des normes de codage, des principes d'architecture, des bibliothèques à privilégier, des conventions de tests et des contraintes spécifiques au projet.

### AGENTS.md

Le moyen le plus simple d'ajouter des règles consiste à créer un fichier `AGENTS.md` à la racine de votre projet. Il est rédigé en Markdown standard, sans frontmatter :

```markdown theme={null}
# Règles du projet

- Utiliser TypeScript pour tous les nouveaux fichiers
- Suivre les conventions existantes dans src/components/
- Toujours exécuter `npm run lint` avant chaque commit
- Utiliser pnpm, et non npm ou yarn
```

`AGENTS.md`, `AGENTS.local.md` (pour les règles personnelles que vous ne versionnez pas) et `AGENT.md` sont tous lus comme des règles always-on. L’agent les lit à la racine de l’espace de travail ainsi que dans chaque répertoire situé entre cette racine et le répertoire dans lequel il travaille. Un fichier `AGENTS.md` placé dans un sous-répertoire fournit donc des consignes propres à ce répertoire.

### Fichiers de règles

Pour un contrôle plus fin, placez une règle par fichier dans `.devin/rules/*.md`. Chaque fichier peut indiquer dans quels cas il s'applique grâce au champ `trigger` du frontmatter :

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

Tous les fichiers de test doivent utiliser des blocs `describe`/`it` et simuler les appels d’API externes.
```

| Valeur de `trigger:` | Quand la règle est transmise à l'agent |
| - | - |
| `always_on` | À chaque session |
| `glob` | Lorsque l'agent travaille sur des fichiers correspondant à `globs` |
| `model_decision` | Lorsque l'agent juge la description de la règle pertinente |
| `manual` | Uniquement lorsque vous l'invoquez |

`.devin/global_rules.md` est un fichier unique always-on. Placez les mêmes fichiers dans votre répertoire personnel (`~/.devin/rules/*.md`, `~/.devin/global_rules.md`) pour les appliquer à tous vos projets.

Les anciens fichiers `.windsurf/rules/*.md`, `.windsurf/global_rules.md` et `.windsurfrules` sont importés par défaut. Les fichiers de règles de `.devin/rules/` et de `.windsurf/rules/` sont chargés les uns comme les autres ; si les deux fichiers `global_rules.md` existent, seul `.devin/global_rules.md` est chargé. Consultez [Règles et AGENTS.md](https://docs.devinenterprise.com/fr/cli/extensibility/rules.md) pour la liste complète des fichiers, les paramètres d'importation et les règles issues d'autres outils.

### Bonnes pratiques

* Rédigez des règles courtes et spécifiques. Les règles font partie du contexte de chaque session : elles consomment donc des jetons à chaque message.
* Privilégiez une skill pour tout ce dont l'agent n'a besoin qu'occasionnellement, et utilisez une règle pour indiquer à l'agent les skills à utiliser dans des scénarios particuliers.
* Structurez les règles avec des puces, des listes numérotées et des titres Markdown. Elles sont plus faciles à suivre qu'un long paragraphe.
* Évitez les règles génériques telles que « écrire du bon code ».

## Compétences

Les tâches d'ingénierie les plus complexes exigent souvent bien plus que de bons prompts. Elles peuvent nécessiter des scripts de référence, des modèles, des checklists et d'autres fichiers complémentaires. Les compétences vous permettent de regrouper tous ces éléments dans des dossiers que l'agent peut invoquer.

Les compétences reposent sur la **divulgation progressive** : par défaut, seuls le `name` et la `description` de la compétence sont présentés au modèle. Le contenu complet du fichier `SKILL.md` et les fichiers complémentaires ne sont chargés que lorsque l'agent décide d'invoquer la compétence, ou lorsque vous l'invoquez vous-même. Votre fenêtre de contexte reste ainsi allégée, même lorsque de nombreuses compétences sont définies.

### Créer un skill

Créez un répertoire contenant un fichier `SKILL.md` dont le frontmatter YAML indique le nom et la description du skill :

```markdown theme={null}
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---

## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables

## Deployment Steps
Follow these steps to deploy safely...
```

* **name** : identifiant unique de la skill (lettres minuscules, chiffres et tirets). Sert à l'invoquer.
* **description** : brève explication fournie au modèle pour l'aider à déterminer quand invoquer la skill. Précisez ce que fait la skill et dans quels cas l'utiliser.

Placez les fichiers complémentaires dans le dossier de la skill, à côté de `SKILL.md`. Ils deviennent accessibles à l'agent lorsque la skill est invoquée :

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

### Invoquer des skills

Lorsque votre requête correspond à la description d'un skill, l'agent invoque automatiquement ce skill et applique ses instructions. Vous pouvez également invoquer un skill par son nom avec `/skill-name` pour garantir son utilisation.

### Périmètres des skills

| Périmètre | Emplacement | Disponibilité |
| - | - | - |
| Espace de travail | `.devin/skills/<name>/` (`.agents/skills/` et l’ancien `.windsurf/skills/` sont également lus) | Espace de travail actuel uniquement. Validé dans votre repo. |
| Global | `~/.config/devin/skills/<name>/` (`~/.agents/skills/` est également lu) | Tous les espaces de travail de votre machine. Non validé dans le repo. |
| Module d’extension | Dans un [module d’extension](#plugins) installé | Partout où le module d’extension est installé. |

Consultez la [documentation des skills de Devin CLI](https://docs.devinenterprise.com/fr/cli/extensibility/skills/overview.md) pour en savoir plus sur les déclencheurs de skills, les autorisations et les skills tiers, ainsi que la page [Créer des skills](https://docs.devinenterprise.com/fr/cli/extensibility/skills/creating-skills.md) pour des consignes de rédaction.

## Extensions

Les extensions sont des paquets installables qui ajoutent des skills, des règles, des hooks, des serveurs MCP et des sous-agents à l’agent. Installez un module d’extension depuis un dépôt GitHub, une URL git, un sous-dossier de dépôt ou un dossier local ; ses skills sont alors disponibles sous forme de commandes `/<plugin>:<skill>`. Consultez la page [modules d’extension](https://docs.devinenterprise.com/fr/cli/extensibility/plugins/overview.md) pour en savoir plus sur le format des modules d’extension, les commandes `devin plugins` et la gouvernance.

> [!WARNING]
>
> Ici, **Extensions** désigne les modules d’extension de l’*agent* Devin. Ils n’ont aucun rapport avec les [Plugins Windsurf](https://docs.devinenterprise.com/fr/windsurf/plugins/getting-started.md), qui intègrent Devin à JetBrains, VS Code et d’autres éditeurs, ni avec les [extensions d’éditeur](https://docs.devinenterprise.com/fr/desktop/recommended-extensions.md) que vous installez dans Devin Desktop : ces deux types d’extensions enrichissent l’IDE, et non l’agent.

## Serveurs MCP

**MCP (Model Context Protocol)** est un protocole qui permet à l'agent d'utiliser des outils issus de services externes tels que GitHub, des bases de données ou des outils de suivi des tickets. Pour en savoir plus, consultez la [documentation officielle de MCP](https://modelcontextprotocol.io/).

### Installer des serveurs MCP

Ouvrez la page **Personnaliser** depuis la fenêtre Agents, puis cliquez sur **MCPs**. Choisissez le périmètre à l’aide du sélecteur **Install MCPs for** situé en haut de la page, par exemple **This computer**.

* **This computer** répertorie les serveurs que votre agent local charge pour les dossiers ouverts dans la fenêtre. Vous pouvez activer ou désactiver un serveur, ouvrir son fichier de configuration ou actualiser la liste.
* **Available** répertorie les serveurs issus de vos registres MCP. Cliquez sur **Install** sur un serveur pour l’ajouter.

Les Enterprise Admin gèrent les registres dans les Team Settings, sous **MCP & ACP**. L’onglet **registre MCP** comporte une option qui autorise les serveurs correspondant à une entrée de registre en plus de ceux de la liste d’autorisation MCP, ainsi qu’un paramètre **Registry** (**Configure**) pour les URL des registres. Lorsque plusieurs registres sont configurés, Devin Desktop utilise la réunion de l’ensemble de ces registres. Les registres personnalisés doivent respecter le [schéma officiel du registre MCP](https://modelcontextprotocol.io/).

### Configuration

Les serveurs MCP sont configurés dans des [fichiers de configuration](https://docs.devinenterprise.com/fr/cli/extensibility/mcp/configuration.md) sur votre machine locale. L'emplacement du fichier dépend du périmètre :

| Périmètre | Emplacement | Partagé avec l'équipe ? |
| - | - | - |
| Projet | `.devin/mcp_config.json` | Oui (suivi par la gestion de versions) |
| Dérogation locale | `.devin/mcp_config.local.json` | Non (ignoré par Git) |
| Niveau utilisateur | `~/.config/devin/mcp_config.json` | Non |

Devin Local prend en charge les transports `stdio`, `Streamable HTTP` et `SSE`, ainsi qu'OAuth pour chacun d'eux.

### Autorisations

Par défaut, l'agent demande votre approbation avant d'appeler un outil MCP. Consultez [Autorisations MCP](https://docs.devinenterprise.com/fr/desktop/devin-local/permissions.md#mcp-permissions) pour savoir comment autoriser un outil ou un serveur, et comment les administrateurs peuvent autoriser par défaut les intégrations de confiance.

### Réauthentification

Lorsque les identifiants OAuth stockés d’un serveur expirent, celui-ci passe à l’état **Needs authentication**. Cet état s’affiche dans la liste **This computer**, sur la carte **Available** et sur la page de détails du serveur.

Cliquez sur **Authenticate** pour effacer les credentials stockés et relancer le flux d’autorisation dans le navigateur.

## Hooks

Les hooks exécutent une logique personnalisée à certains événements du cycle de vie de l'agent, par exemple avant un appel d’outil. Chaque hook est une commande shell ou un prompt LLM. Utilisez les hooks pour imposer des politiques, ajouter du contexte, consigner des actions, modifier des autorisations ou assurer l'intégration avec des systèmes externes.

Les hooks se configurent dans `.devin/hooks.v1.json`, au sein de votre projet ou au niveau utilisateur. Par exemple, ce hook exécute un script avant chaque commande shell et peut bloquer celle-ci :

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

Les hooks ne sont ni chargés ni exécutés lorsqu’un espace de travail est ouvert en [Mode Restreint](https://docs.devinenterprise.com/fr/desktop/devin-local/overview.md#restricted-mode).

Consultez la page [hooks](https://docs.devinenterprise.com/fr/cli/extensibility/hooks/overview.md) pour en savoir plus sur les événements de hook, le format de configuration et les codes de sortie, et pour consulter des exemples.


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