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 workflows permettent aux utilisateurs de définir une série d’étapes pour guider Cascade dans l’exécution d’un ensemble répétitif de tâches, comme déployer un service ou répondre à des commentaires sur les PR. Ces Workflows sont enregistrés sous forme de fichiers markdown, offrant aux utilisateurs et à leurs équipes un moyen simple et reproductible d’exécuter des processus clés. Une fois enregistrés, les Workflows peuvent être invoqués dans Cascade via une commande slash au format /[name-of-workflow].
Les workflows sont entièrement manuels — Cascade n’invoquera jamais un workflow automatiquement. Si vous voulez que Cascade applique une procédure de lui-même, utilisez plutôt un Skill.

​
Fonctionnement

Les règles fournissent généralement aux grands modèles de langage des indications en apportant un contexte persistant et réutilisable au niveau du prompt. Les workflows étendent ce concept en fournissant, au niveau de la trajectoire, une séquence structurée d’étapes ou de prompts qui guide le modèle à travers une série de tâches ou d’actions interconnectées.
Pour exécuter un workflow, les utilisateurs n’ont qu’à l’invoquer dans Cascade à l’aide de la commande /[workflow-name].
Vous pouvez appeler d’autres workflows depuis un workflow !

Par exemple, /workflow-1 peut inclure des instructions telles que « Appelez /workflow-2 » et « Appelez /workflow-3 ».
Lorsqu’il est invoqué, Cascade traite séquentiellement chaque étape définie dans le workflow, en exécutant des actions ou en générant des réponses selon les spécifications.

​
Comment créer un workflow

Pour démarrer avec les workflows, cliquez sur l’icône Customizations dans le menu latéral situé en haut à droite de Cascade, puis accédez au panneau Workflows. Vous pouvez ensuite cliquer sur le bouton + Workflow pour créer un nouveau workflow. Les workflows sont enregistrés sous forme de fichiers Markdown dans les répertoires .windsurf/workflows/ et contiennent un titre, une description et une série d’étapes avec des instructions spécifiques que Cascade doit suivre.

​
Découverte des workflows

Devin Desktop détecte automatiquement les workflows à plusieurs emplacements pour offrir une organisation flexible :
  • Espace de travail actuel et sous-répertoires : tous les répertoires .windsurf/workflows/ dans l’espace de travail actuel et ses sous-répertoires
  • Structure du dépôt Git : pour les dépôts Git, Devin Desktop remonte également jusqu’à la racine du dépôt pour trouver des workflows dans les répertoires parents
  • Prise en charge de plusieurs espaces de travail : lorsque plusieurs dossiers sont ouverts dans le même espace de travail, les workflows sont dédupliqués et affichés avec le chemin relatif le plus court

​
Emplacements de stockage des workflows

PérimètreEmplacementRemarques
Espace de travail.windsurf/workflows/*.mdDans votre espace de travail actuel, dans n’importe quel sous-répertoire ou dans n’importe quel répertoire parent jusqu’à la racine du dépôt Git. Versionné avec votre dépôt.
Global~/.codeium/windsurf/global_workflows/*.mdDisponible dans chaque espace de travail sur votre machine. Non versionné.
IntégréGéré par Devin DesktopModèles fournis avec Devin Desktop (p. ex. /plan).
Système (Enterprise)Selon le système d’exploitation (p. ex. /etc/windsurf/workflows/)Déployé par l’équipe informatique, en lecture seule pour les utilisateurs finaux.
Lorsque vous créez un nouveau workflow via l’interface utilisateur, il est enregistré dans le répertoire .windsurf/workflows/ de votre espace de travail actuel, pas nécessairement à la racine du dépôt Git. Pour créer un workflow global, utilisez le bouton + Global dans le panneau Workflows ou créez directement le fichier dans ~/.codeium/windsurf/global_workflows/. Les fichiers de workflow sont limités à 12000 caractères chacun.

​
Générer un workflow avec Cascade

Vous pouvez aussi demander à Cascade de générer des workflows pour vous ! Cela fonctionne particulièrement bien pour les workflows impliquant une série d’étapes dans un outil CLI spécifique.

​
Exemples de workflows

Il existe une multitude de cas d’usage pour les Workflows, tels que :

/address-pr-comments

Voici un workflow que notre équipe utilise en interne pour traiter les commentaires sur les PR :
1. Basculez sur la branche de la PR : `gh pr checkout [id]`

2. Récupérez les commentaires sur la PR

 bash
 gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'

3. Pour CHAQUE commentaire, procédez comme suit. N’oubliez pas de traiter un commentaire à la fois.
 a. Affichez ce qui suit : "(index). De [user] sur [file]:[lines] — [body]"
 b. Analysez le fichier et la plage de lignes.
 c. Si vous ne comprenez pas le commentaire, n’apportez aucune modification. Demandez-moi simplement des précisions, ou demandez-moi de m’en charger moi-même.
 d. Si vous pensez pouvoir effectuer la modification, faites-la AVANT de passer au commentaire suivant.

4. Une fois tous les commentaires traités, résumez ce que vous avez fait et indiquez quels commentaires nécessitent l’intervention de l’UTILISATEUR.

/git-workflows

Effectuez des commits à l’aide de formats prédéfinis et créez des pull requests avec des titres et des descriptions standardisés à l’aide des commandes CLI appropriées.

/dependency-management

Automatisez l’installation ou la mise à jour des dépendances du projet à partir d’un fichier de configuration (p. ex., requirements.txt, package.json).

/code-formatting

Exécutez automatiquement des formateurs de code (comme Prettier, Black) et des linters (comme ESLint, Flake8) lors de l’enregistrement des fichiers ou avant le commit afin de préserver le style du code et de détecter les erreurs rapidement.

/run-tests-and-fix

Exécutez ou ajoutez des tests unitaires ou de bout en bout, puis corrigez automatiquement les erreurs afin de garantir la qualité du code avant le commit, la fusion ou le déploiement.

/deployment

Automatisez les étapes nécessaires pour déployer votre application dans différents environnements (développement, staging, production), y compris toutes les vérifications nécessaires avant ou après le déploiement.

/security-scan

Intégrez et déclenchez des analyses des vulnérabilités de sécurité sur votre base de code dans le cadre du pipeline CI/CD ou à la demande.

​
Workflows système (Enterprise)

Les organisations Enterprise peuvent déployer des workflows système disponibles globalement dans tous les espaces de travail et qui ne peuvent pas être modifiés par les utilisateurs finaux sans autorisations d’administrateur. C’est idéal pour imposer des processus de développement à l’échelle de l’organisation, des procédures de déploiement et des workflows de conformité. Les workflows système sont chargés à partir de répertoires propres au système d’exploitation : macOS: 
/Library/Application Support/Windsurf/workflows/*.md
Linux/WSL : 
/etc/windsurf/workflows/*.md
Windows : 
C:\ProgramData\Windsurf\workflows\*.md
Placez vos fichiers de workflow (sous forme de fichiers .md) dans le répertoire correspondant à votre système d’exploitation. Le système chargera automatiquement tous les fichiers .md présents dans ces répertoires.

​
Ordre de priorité des workflows

Lorsque des workflows portant le même nom existent à plusieurs niveaux, les workflows système ont la priorité la plus élevée :
  1. System (priorité la plus élevée) - Workflows déployés à l’échelle de l’organisation par l’IT
  2. Espace de travail - Workflows spécifiques au projet dans .windsurf/workflows/
  3. Global - Workflows définis par l’utilisateur dans ~/.codeium/windsurf/global_workflows/
  4. Built-in - Workflows par défaut fournis par Devin Desktop
Cela signifie que si une organisation déploie un workflow système portant un nom spécifique, il remplacera tout workflow d’espace de travail, Global ou Built-in portant le même nom. Dans l’interface utilisateur de Devin Desktop, les workflows système s’affichent avec le libellé « System » et ne peuvent pas être supprimés par les utilisateurs finaux.
Important : les workflows système doivent être gérés par votre équipe IT ou sécurité. Assurez-vous que vos équipes internes prennent en charge le déploiement, les mises à jour et la conformité conformément aux politiques de votre organisation. Vous pouvez utiliser pour cela des outils et workflows standard comme Mobile Device Management (MDM) ou Configuration Management.