1
Rédiger un skills de documentation
Commencez par créer une skill pour la tâche que vous souhaitez standardiser. Dans cet exemple, nous allons créer une skill qui génère la documentation de l’API dès qu’un membre de l’équipe ajoute un libellé à un ticket.Accédez à Customize > Skills et cliquez sur + (New skill). Nommez-la
add-docs.Rédigez des instructions pas à pas précises. Indiquez de vrais chemins de fichiers et vos conventions afin que Devin respecte les standards de votre équipe :Plus votre skill est précise, meilleur sera le résultat. Faites référence aux modèles de documentation, guides de style et outils réellement utilisés par votre équipe. Pour en savoir plus, consultez Rédiger une bonne skill.2
Synchroniser la skills avec Linear
Connectez votre intégration Linear si ce n’est pas déjà fait : accédez à Settings > Connections > Linear et cliquez sur Connect. Sélectionnez les équipes auxquelles Devin doit avoir accès.Une fois la connexion établie, faites défiler la page jusqu’à Skills et cliquez sur Add skill. Sélectionnez
add-docs dans la liste déroulante. Le libellé de la skill est alors créé dans Linear, au sein du groupe de libellés Devin Skills ; la liste des Skills indique le libellé à utiliser (@skills:add-docs si aucune autre skill synchronisée ne porte ce nom), accompagné d’un bouton pour le copier.Désormais, dès que quelqu’un ajoute ce libellé à un ticket, Devin démarre une session à l’aide de votre skill.Pour que les libellés de skills se synchronisent automatiquement avec Linear, l’option Manage workspace labels de votre espace de travail Linear doit être définie sur All members (dans Settings > Security de Linear). Si ce n’est pas le cas, vous devrez créer les libellés manuellement dans Linear.
3
Appliquer des libellés aux tickets et générer de la documentation
Lorsqu’un membre de l’équipe ajoute le libellé
@skills:add-docs à un ticket comme celui-ci :ENG-215 : Ajouter l’endpoint POST /api/v2/webhooks — accepte une URL et des types d’événements, vérifie que l’URL est joignable, enregistre l’abonnement et renvoie l’ID du webhook.Devin démarre automatiquement une session et applique votre skill de documentation :
- Lit le ticket — récupère la description de l’endpoint, ses paramètres et les éventuelles PR liées
- Trouve le code source — localise le gestionnaire de route, le schéma de validation de la requête et les types de réponse
- Génère la documentation — crée une nouvelle page dans
docs/api/en respectant votre format existant - Ouvre une PR — contenant la nouvelle page de documentation et la barre latérale mise à jour
@skills:add-docs pour générer en parallèle la documentation de plusieurs endpoints.4
Créez davantage de skills pour votre équipe
Le même principe s’applique à toute tâche récurrente. Créez un skill, synchronisez-le sous forme de libellé, et votre équipe pourra le déclencher depuis n’importe quel ticket. Voici quelques idées :
@skills:write-tests— Améliorer la couverture de tests de la fonctionnalité décrite dans un ticket@skills:refactor— Refactoriser le code en respectant les conventions de votre équipe@skills:security-audit— Analyser le code pour détecter les vulnérabilités de sécurité et ouvrir une PR avec les correctifs@skills:migrate— Exécuter une migration standardisée (mise à niveau de dépendances, passage à une nouvelle version d’API)

