Communitygithub.com

Visualiseur de workflow

Explique un workflow en détail sous forme de page visuelle (légende de symboles, boîtes d'info, explications tangibles) et choisit la forme du diagramme en fonction de la structure du processus.

Qu'est-ce que Visualiseur de workflow ?

Le skill Visualiseur de workflow est conçu pour les agents IA (tels que Claude Code, Cursor, Codex) lorsqu'un utilisateur souhaite comprendre un processus, une procédure ou un workflow en profondeur. Il remplace une réponse textuelle longue par une page HTML autonome contenant un diagramme adapté à la structure réelle du processus : flowchart, branching, lanes, cycle, timeline, ou pistes parallèles. Le skill analyse d'abord la conversation ou les fichiers pour clarifier le processus, puis sélectionne la forme la plus honnête (pas la plus jolie), et génère une page à partir d'un template HTML existant. Chaque étape reçoit un titre, une durée réelle ou une position, un symbole normalisé, et éventuellement des boîtes 'Important' ou 'Concret'. Aucune donnée non vérifiée n'est inventée ; elle est marquée 'Open'. Le résultat est livré en un fichier HTML unique, avec un design sobre (fond papier, pas d'ombres, pas d'emoji) et une légende en haut. Le skill s'applique uniquement lorsque l'utilisateur demande explicitement des détails ("en détail", "étape par étape", "explique à nouveau") et que le sujet est bien un workflow.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Visualiseur de workflow ?

Lorsque quelqu'un veut comprendre un workflow en détail, le texte continu suffit rarement. Un processus a un ordre, des transferts, des décisions et des temps d'attente. Un graphique adapté rend tout cela lisible d'un coup. Il remplace une longue réponse textuelle plutôt que de s'y ajouter.

La forme est choisie librement. Aucune forme n'a la priorité, ni la chronologie ni aucune autre. La structure du workflow décide.

Quand ce skill s'applique

Deux conditions ensemble :

  1. Le sujet est un workflow, processus ou procédure (le sien, un qui a été discuté, ou qui doit être expliqué à partir de zéro).
  2. L'utilisateur veut plus de détails : "en détail", "plus précisément", "étape par étape", "explique à nouveau", "comment ça se déroule".

Si le mot "workflow" n'apparaît qu'au passage et que la question peut être répondue rapidement, répondez brièvement dans le chat. Un graphique pour chaque mention superficielle le dévalorise.

Procédure

  1. Clarifiez le processus. Prenez le processus de la conversation, des fichiers ou des sources nommées par l'utilisateur. Si quelque chose d'essentiel manque, demandez une fois, brièvement. N'inventez pas d'étapes, de durées ou d'outils. Tout élément non vérifié est marqué "Open".
  2. Lisez la structure, puis choisissez la forme. Voir la section suivante. Dites dans le chat en une phrase quelle forme vous avez choisie et pourquoi. L'utilisateur peut vous contredire d'un mot.
  3. Esquisse. 4 à 10 étapes au total, regroupées en 2 à 4 phases ou couloirs. Plus dilue le graphique ; résumez plutôt les sous-processus.
  4. Remplissez chaque étape.
    • Marqueur temporel ou position : une durée réelle, un moment dans le temps ou un ordre ("Étape 3"). Pas d'heures devinées.
    • Un symbole de la légende.
    • Un titre (nom, court) et une à deux phrases sur ce qui se passe et pourquoi.
    • Optionnel : boîte Important : uniquement lorsqu'une information peut faire ou défaire le processus (prérequis, source d'erreur, approbation).
    • Optionnel : boîte Concret : une image tangible, un exemple ou une analogie qui rend une étape abstraite saisissable. L'image explique quelque chose ; elle ne décore pas.
  5. Construisez la légende. Seulement les symboles qui apparaissent dans le graphique, plus les éléments de la forme choisie. La légende est en haut.
  6. Livrez sous forme de page. Construisez-la à partir de assets/base-template.html (jetons, en-tête, légende, boîtes) et ajoutez la structure de la forme choisie selon references/shapes.md. Pour le flowchart, il existe un exemple fini dans assets/flowchart-example.html : réutilisez son CSS et remplacez le contenu. Titrez la page avec le nom du workflow, par exemple "Flux d'approbation de documents". Si votre environnement peut publier des pages ou artefacts, publiez-y ; sinon, livrez un fichier HTML autonome.
  7. Répondez dans le chat. Une ou deux phrases : la forme choisie avec la raison, et tout point ouvert. Ne répétez pas le contenu du graphique.

Choisir la forme

Lisez d'abord la structure du workflow, puis décidez. Ces questions aident :

  • Y a-t-il des décisions dont le résultat ramène en arrière (une boucle), ou dont les chemins se rejoignent, et le lecteur doit-il pouvoir tracer le chemin avec le doigt ? → Flowchart
  • Les chemins se divisent-ils à des décisions et aboutissent-ils à des endroits différents sans revenir ? → Branching
  • Plusieurs personnes, outils ou rôles portent-ils des parties du processus, la difficulté est-elle dans les transferts, et il n'y a pas de boucle ? → Couloirs (Lanes)
  • Le processus recommence-t-il à l'identique après la dernière étape, ou le résultat alimente-t-il la prochaine exécution, sans décisions intermédiaires ? → Cycle
  • Des brins s'exécutent-ils en même temps et doivent-ils se rejoindre quelque part ? → Pistes parallèles
  • Le processus est-il essentiellement une séquence d'étapes dans le temps, avec des temps d'attente, des échéances ou des durées importantes ? → Chronologie (Timeline)
  • Le workflow mélange-t-il plusieurs propriétés ? Choisissez celle où le lecteur a le plus de chances de se tromper. La propriété secondaire devient une boîte d'info ou une étiquette de lieu : un flowchart peut montrer où une étape se déroule sans avoir besoin de couloirs.

Une boucle est la raison la plus courante de changer de forme. La cacher dans une boîte d'info l'enterre, et c'est exactement là où les lecteurs trébuchent. S'il y en a une, le flowchart est généralement la forme la plus honnête, même si les couloirs ou la chronologie semblent convenables au premier coup d'œil.

Ne choisissez pas par l'apparence ou par habitude. Une forme qui ne correspond pas à la structure falsifie le processus : un axe cache les alternatives, des couloirs sans véritables transferts sont de la décoration.

Les règles de construction exactes pour chaque forme se trouvent dans references/shapes.md. Lisez uniquement la section de la forme choisie.

Symboles

Tous angulaires, pas de cercles. Les formes sont dessinées avec du CSS plutôt qu'avec des caractères pour qu'elles paraissent identiques partout.

SymboleFormeSignification
Actioncarré pleinquelque chose est fait ou produit
Décisioncarré videle flux bifurque ici
Point de contrôlelosangevérification, signature, approbation
Transferttrianglele résultat passe à une personne, un outil ou une phase
Attentebarre horizontalerien ne se passe activement, le temps passe
Opencarré en tiretsl'information est manquante ou non vérifiée

Ajoutez d'autres symboles uniquement si le workflow en a vraiment besoin, et expliquez-les dans la légende.

Style

Le template est livré avec un neutre par défaut : fond papier chaud, encre presque noire, un seul accent pâle utilisé uniquement comme surface, et la police système. Toutes les couleurs sont des jetons dans :root. Si l'utilisateur a une marque ou un système de design, changez uniquement ces jetons ; ne restylisez pas la structure.

  • Fond papier, encre pour les titres, graphite pour le texte courant, teinte calme pour les surfaces silencieuses, traits fins pour les filets.
  • L'accent est utilisé uniquement comme surface, jamais comme couleur de texte ou de ligne. Le texte dessus est toujours encre. Au plus une grande bande d'accent par page ; les petites barres de repère (10px) sous les titres de phase ou de couloir peuvent se répéter.
  • Une seule famille de police. Hiérarchie via le poids et l'espacement des lettres ; espacement des lettres uniquement sur les majuscules.
  • Pas d'ombres, de dégradés, de coins arrondis, d'emojis ni de points d'exclamation. Les listes utilisent des carrés d'encre. Les connexions sont des lignes droites à angles droits, 2px encre.
  • La page reste sur un seul thème, sur fond papier. Toutes les couleurs sont définies explicitement pour qu'elle soit lisible aussi bien dans les interfaces claires que sombres.
  • Mobile d'abord, pas de défilement horizontal de la page. Tout ce qui doit être plus large (couloirs) défile dans son propre conteneur.

N'inventez pas de nouvelles couleurs, polices ou formes. Si le système manque de quelque chose, nommez le manque et résolvez-le dans le cadre des jetons.

Langue

Rédigez le graphique dans la langue utilisée par l'utilisateur. Restez factuel, à base de noms, et court. Pas de remplissage, pas de jargon à la mode. Les explications peuvent être vives mais précises : une image forte plutôt que trois faibles.

Liste de vérification avant livraison

  • La forme suit la structure du workflow, et la phrase dans le chat en donne la raison.
  • Chaque boucle est dessinée comme un chemin et non seulement mentionnée dans le texte.
  • Chaque mention de temps est documentée ou marquée comme simple ordre.
  • Tout élément non vérifié porte le symbole "Open".
  • Tous les symboles du graphique apparaissent dans la légende, et aucun autre.
  • L'accent est utilisé uniquement comme surface, jamais comme texte ou ligne.
  • Aucun texte ne dépasse du bord, même à 400px de largeur.
  • Le texte du chat ne répète pas le contenu du graphique.

Skills associés