Skip to main content
Vous préférez ne pas configurer tout cela vous-même ? Collez le lien de cette page dans une session Devin et demandez-lui de s’occuper de toute la configuration à votre place.
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
Cela fonctionne aussi très bien pour les opérations par lots : sélectionnez plusieurs tickets avec Cmd+A, faites un clic droit et ajoutez le libellé @skills:add-docs pour générer en parallèle la documentation de plusieurs endpoints.
Une fois l’intégration Linear installée, Devin a nativement accès aux outils de Linear : votre skill peut donc demander à Devin de mettre à jour les libellés ou le statut du ticket selon le résultat. Comme les libellés peuvent déclencher d’autres automatisations, vous pouvez enchaîner des workflows. Par exemple, une fois la documentation générée, un libellé Docs Ready pourrait prévenir le rédacteur technique pour qu’il effectue une revue.
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)
Vous pouvez également configurer des automatisations pour que Devin se mette au travail sans que personne n’ait besoin d’appliquer de libellé. Accédez à Settings > Connections > Linear, faites défiler jusqu’à Automations, cliquez sur Add automation, puis configurez une automatisation qui se déclenche lorsqu’un ticket passe à un statut donné ou reçoit un libellé spécifique.