Vous ne souhaitez pas effectuer cette configuration manuellement ? Collez un lien vers cette page dans une session Devin et demandez-lui de tout configurer pour vous. Commencez par créer un [playbook](/fr/product-guides/creating-playbooks) pour la tâche que vous souhaitez standardiser. Dans cet exemple, nous allons créer un playbook qui génère la documentation d’API chaque fois qu’un membre de l’équipe ajoute un libellé à un ticket. Accédez à [**Settings > Playbooks**](https://app.devin.ai/settings/playbooks?utm_source=docs\&utm_medium=use-case-gallery) et cliquez sur **Create playbook**. Donnez-lui un nom et une macro (par exemple, `!add-docs`). Rédigez des instructions précises et détaillées, étape par étape. Utilisez de vrais chemins de fichiers et les conventions existantes afin que Devin respecte les standards de votre équipe : ```txt !add-docs playbook theme={null} Read the Linear ticket for context on the feature or endpoint. Then: 1. Find the relevant source code — route handlers, controllers, models, and type definitions 2. Read our existing docs in docs/api/ to understand the format and conventions we use 3. Generate documentation covering: endpoint URL, HTTP method, request/response schemas, authentication requirements, error codes, and a usage example with curl 4. Add the new page to the docs sidebar in docs/sidebar.json 5. If there are related endpoints, add cross-references 6. Open a PR with the new documentation ``` Plus votre playbook est spécifique, meilleur sera le résultat. Appuyez-vous sur les modèles de documentation, guides de style et outils réellement utilisés par votre équipe. Consultez la [documentation sur les playbooks](/fr/product-guides/creating-playbooks) pour en savoir plus sur la rédaction de playbooks efficaces. Connectez votre [intégration Linear](/fr/integrations/linear) si ce n’est pas déjà fait : allez dans [**Settings > Connections > Linear**](https://app.devin.ai/settings/connections/linear?utm_source=docs\&utm_medium=use-case-gallery) 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’à **Synced playbook labels** et cliquez sur **Add playbook**. Sélectionnez `!add-docs` dans la liste déroulante. Cela crée automatiquement un libellé appelé `!add-docs` dans Linear, dans le groupe de libellés **Devin Playbooks**. Désormais, lorsqu’un utilisateur ajoute ce libellé à un ticket, Devin démarre une session en utilisant votre playbook. Pour que les libellés de playbook soient synchronisés automatiquement avec Linear, votre espace de travail Linear doit avoir **Manage workspace labels** défini sur **All members** (dans les **Settings > Security** de Linear). Si ce n’est pas activé, vous devrez créer les libellés manuellement dans Linear. Lorsqu'un membre de l'équipe ajoute le label `!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 accessible, enregistre l'abonnement et renvoie l'ID du webhook. Devin démarre automatiquement une session et suit votre playbook de documentation : * **Lit le ticket** — extrait la description de l'endpoint, les paramètres et toutes les PR liées * **Trouve le code source** — repère le gestionnaire de route, le schéma de validation de requête et les types de réponse * **Génère la documentation** — crée une nouvelle page dans `docs/api/` en suivant votre format existant * **Ouvre une PR** — inclut la nouvelle page de documentation et la sidebar mise à jour Cela fonctionne aussi très bien pour les opérations par lot — sélectionnez plusieurs tickets avec **Cmd+A**, faites un clic droit et ajoutez le label `!add-docs` pour générer la documentation de plusieurs endpoints en parallèle. Avec l'intégration Linear installée, Devin a nativement accès aux outils de Linear ; votre playbook peut donc indiquer à Devin de mettre à jour les labels ou le statut des tickets en fonction du résultat. Comme les labels peuvent déclencher d'autres automatisations, vous pouvez enchaîner les workflows — p. ex., après la génération de la documentation, un label `Docs Ready` pourrait avertir le rédacteur technique pour relecture. Le même principe fonctionne pour toute tâche récurrente. Créez un playbook, synchronisez-le comme libellé, et votre équipe pourra le déclencher depuis n'importe quel ticket. Voici quelques idées : * **`!write-tests`** — Ajouter une couverture de test pour la fonctionnalité décrite dans un ticket * **`!refactor`** — Refactoriser le code en suivant les conventions de votre équipe * **`!security-audit`** — Examiner le code pour détecter des vulnérabilités de sécurité et ouvrir une PR avec les correctifs * **`!migrate`** — Exécuter une migration standardisée (mise à niveau de dépendances, montée de version d'API) Vous pouvez également configurer des [déclencheurs d'automatisation](/fr/integrations/linear) afin que Devin commence à travailler sans que personne n'applique de libellé. Accédez à [**Settings > Connections > Linear**](https://app.devin.ai/settings/connections/linear?utm_source=docs\&utm_medium=use-case-gallery), faites défiler jusqu'à **Automation triggers**, et configurez un déclencheur qui se lance lorsque des tickets passent à un statut ou un libellé spécifique.

{title}