Passer au contenu principal

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.

Les skills sont des unités fonctionnelles autonomes que vous pouvez enseigner à Devin CLI. Ils regroupent des prompts, l’accès aux outils, des autorisations et des workflows dans un package réutilisable qui peut être invoqué aussi bien par l’agent que par l’opérateur humain.

Que sont les skills ?

Considérez les skills comme des connaissances expertes que vous donnez à l’agent. Un skill peut lui apprendre à :
  • revoir du code selon les standards de votre équipe
  • générer un type spécifique de composant
  • exécuter un workflow de déploiement
  • effectuer un audit de sécurité
  • configurer un nouveau service à partir d’un template

Invocation par commande slash

Les utilisateurs peuvent invoquer des skills avec /skill-name dans le chat.

Autonomie de l’agent

L’agent peut invoquer des skills de manière autonome lorsque c’est pertinent.

Autorisations limitées au périmètre

Les skills peuvent avoir leurs propres autorisations et restrictions.

Accès personnalisé aux outils

Limitez les outils qu’un skill peut utiliser pour plus de sécurité.

Exécution en sous-agent

Exécutez les skills comme des subagents indépendants avec leur propre fenêtre de contexte.

Dérogation de modèle

Utilisez un modèle différent pour des skills spécifiques.

Exemple rapide

Créez un skill de revue de code dans .devin/skills/review/SKILL.md (ou .windsurf/skills/review/SKILL.md) :
---
name: review
description: Review code changes before committing
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

Review the current git diff and provide feedback:

1. Run `git diff --staged` (or `git diff` if nothing is staged)
2. Check for:
   - Logic errors or bugs
   - Missing error handling
   - Security issues
   - Style inconsistencies
3. Summarize findings and suggest improvements
Vous pouvez désormais l’utiliser avec /review dans n’importe quelle session.

Fonctionnement des skills

Lorsqu’un skill est invoqué :
  1. Le prompt du skill est inséré dans la conversation
  2. L’accès aux outils est limité aux allowed-tools du skill (si définis)
  3. Les autorisations supplémentaires définies dans la configuration du skill sont appliquées
  4. Le modèle spécifié est utilisé (s’il est différent du modèle actuel)
Une fois le skill exécuté, la session retrouve sa configuration normale.

Déclencheurs de skills

Les skills peuvent être invoqués de deux façons :
DéclencheurDescriptionPar défaut
userL’utilisateur peut l’invoquer avec /skill-nameActivé
modelL’agent peut l’invoquer de façon autonome lorsque pertinentActivé
---
name: security-check
triggers:
  - user
  - model
---
Définissez triggers: [user] pour empêcher l’agent d’invoquer un skill de sa propre initiative.

Skills tiers

Nous prenons en charge les standards .agents pour les skills, ce qui permet aux outils d’installation de skills tiers de fonctionner avec Devin CLI.
Les skills tiers peuvent exécuter du code arbitraire. Installez-les à vos risques et périls.

Où se trouvent les Skills

Les skills peuvent être définis au niveau d’un seul projet ou partagés entre tous les projets :
EmplacementPérimètreVersionné dans Git ?
.agents/skills/<name>/SKILL.mdSpécifique au projetOui
.devin/skills/<name>/SKILL.mdSpécifique au projetOui
.windsurf/skills/<name>/SKILL.mdSpécifique au projetOui
~/.agents/skills/<name>/SKILL.mdGlobal (tous les projets)Non
~/.config/devin/skills/<name>/SKILL.mdGlobal (tous les projets)Non
~/.codeium/<channel>/skills/<name>/SKILL.mdGlobal (tous les projets, selon le canal)Non
Les skills de projet se trouvent dans le répertoire .devin/skills/ ou .windsurf/skills/ à la racine de votre projet et sont versionnés, ce qui permet de les partager avec votre Team. Les deux emplacements utilisent le même format SKILL.md. Les skills globaux se trouvent dans ~/.config/devin/skills/ (conformément aux conventions XDG) ou ~/.codeium/<channel>/skills/ (où <channel> vaut windsurf, windsurf-next ou windsurf-insiders selon le canal de votre CLI) et sont disponibles dans tous les projets sur votre machine.
Windows : Le chemin des skills globaux correspond au répertoire des données d’application de votre système. Sous Windows, utilisez %APPDATA%\devin\skills\<name>\SKILL.md (généralement C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md) au lieu de ~/.config/devin/skills/.

Étapes suivantes

Créer des skills

Découvrez le format complet d’un skill, y compris les options de frontmatter, le contenu dynamique et des exemples.