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 fichierAGENTS.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 lename 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 fichierSKILL.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.
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.
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.
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 :

