Passer au contenu principal
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 : Devin Local partageant son moteur d’agent avec Devin CLI, 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.

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 :
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 :
.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 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 :
  • 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 :

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

Consultez la documentation des skills de Devin CLI pour en savoir plus sur les déclencheurs de skills, les autorisations et les skills tiers, ainsi que la page Créer des skills 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 pour en savoir plus sur le format des modules d’extension, les commandes devin plugins et la gouvernance.
Ici, Extensions désigne les modules d’extension de l’agent Devin. Ils n’ont aucun rapport avec les Plugins Windsurf, qui intègrent Devin à JetBrains, VS Code et d’autres éditeurs, ni avec les extensions d’éditeur 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.

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.

Configuration

Les serveurs MCP sont configurés dans des fichiers de configuration sur votre machine locale. L’emplacement du fichier dépend du périmètre : 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 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 :
Les hooks ne sont ni chargés ni exécutés lorsqu’un espace de travail est ouvert en Mode Restreint. Consultez la page hooks pour en savoir plus sur les événements de hook, le format de configuration et les codes de sortie, et pour consulter des exemples.