yokingma/flow-diagram

Diagramme de Flux

Le Diagramme de Flux est le skill de création de diagrammes exécutables de systèmes et de processus : créez une fois, puis jouez, intégrez, inspectez et exportez le résultat.

Transformez des descriptions et des sources en explications visuelles : des diagrammes statiques ou animés qui clarifient les structures, les relations et les processus. L'objectif est de préserver le sens de la source et d'aider les lecteurs à comprendre comment les choses sont organisées, connectées et évoluent dans le temps.

Choisir la tâche

Ce skill produit des actifs de diagramme ; les fichiers PPTX et les formes PowerPoint natives ne font pas partie de son périmètre.

Identifiez le type de tâche, l'entrée à utiliser et où entrer ou reprendre le processus.

Demande	Point de départ
Nouveau diagramme ou import JSON à créer ou réviser	Effectuer la vérification préalable des préférences, puis suivre les cinq étapes. Préserver les octets importés inchangés si nécessaire.
Import JSON inchangé pour exportation ou inspection	Utiliser le point d'entrée d'exportation ou de diagnostic ; ignorer la vérification préalable des préférences et conserver la conception d'entrée.
Réviser un diagramme finalisé	Lire le diagramme existant et le rapport final. Établir les modifications demandées et leur périmètre, effectuer la vérification préalable des préférences, puis suivre le processus en cinq étapes, en réutilisant les décisions de conception qui restent valides. Reporter les formats demandés sauf si l'utilisateur les modifie.
Ajouter uniquement des formats d'exportation	Entrer à l'étape 3 avec le diagramme existant inchangé. Ignorer les modifications de brouillon, de style, de mesure et de disposition, puis inspecter et finaliser les fichiers demandés.
Continuer une tâche inachevée	Lire les enregistrements de la tâche et sélectionner la révision sauvegardée à continuer. Reprendre aux étapes inachevées ou à celles affectées par les modifications.
Validation ou diagnostic uniquement	Utiliser validate pour les vérifications structurelles. Si un diagnostic visuel est demandé, suivre les workflows d'inspection applicables à l'étape 4. Rapporter les vérifications effectuées, leurs limites et les problèmes découverts, puis s'arrêter.

Pour les demandes de sauvegarde, de modification ou de réinitialisation autonomes, suivre les préférences de projet et rapporter l'opération sans créer de diagramme.

Pour les importations, révisions ou exportations à partir de diagrammes existants, lire sélection de l'entrée et du parent. Avant de créer les fichiers de tâche, lire exigences de l'espace de travail de la tâche ; pour les commandes de validation et les états de rapport, lire contrats d'exécution et de résultat.

Procéder lorsque l'entrée, les modifications autorisées et le point d'entrée du processus sont clairs.

Processus

0. Initialiser les préférences de conception

Pour les brouillons nouveaux et révisés, suivre les préférences de projet avant l'étape 1. Effectuer sa vérification préalable en résolvant les choix visuels pertinents et en enregistrant leurs sources ; terminer toute sauvegarde demandée ou divulguer son échec. Les demandes de gestion autonome des préférences utilisent cette référence et s'arrêtent après avoir signalé l'opération. Les tâches d'exportation, de validation et de diagnostic pures conservent leurs points d'entrée existants. Reprendre les tâches inachevées avec leurs décisions enregistrées, en revoyant la vérification préalable uniquement lorsqu'un choix pertinent change.

1. Définir l'objectif de l'explication

Commencer par la question du lecteur : que doit comprendre le lecteur après avoir regardé le diagramme ? Utiliser cette question pour guider les décisions ultérieures de contenu, de disposition et d'animation.

• Définir la question. Identifier le sujet et ce que le lecteur doit comprendre à partir de la demande de l'utilisateur.

• Établir les faits. Lire les sources désignées par l'utilisateur ou le diagramme existant dans le périmètre autorisé. Identifier les objets, relations, processus et changements d'état pertinents. Distinguer les faits connus des informations nécessitant une clarification, et enregistrer les sources via les métadonnées de source.

  Pour les investigations larges, comme l'exploration d'un dépôt de code, lancer un sous-agent pour étudier les parties pertinentes pour la question du lecteur. Donner au sous-agent la question et le périmètre de source autorisé. Demander les objets, relations, processus et changements d'état pertinents, avec les emplacements source et les questions non résolues. Utiliser ces résultats pour établir les faits nécessaires à l'explication.

  Pour quelques articles, un petit ensemble de documents de référence ou une demande courte telle que « Expliquer le workflow RAG avec un organigramme », établir les faits dans la session en cours.

• Enregistrer les exigences. Capturer le public, le contexte d'utilisation et les exigences de livraison déjà spécifiés par l'utilisateur. Suivre contexte de livraison manquant pour réutiliser les choix connus, collecter les lacunes pertinentes une fois, et enregistrer les hypothèses adoptées avant de choisir la géométrie.

Procéder lorsque vous pouvez énoncer la question du lecteur en une phrase et identifier les faits soutenant sa réponse. Clarifier les lacunes d'information qui changeraient le sens du diagramme avant de rédiger. Si le SDK ne peut pas exprimer la demande fidèlement, expliquer la limite et attendre le choix de l'utilisateur.

2. Concevoir l'explication visuelle

Choisir comment présenter le sujet pour que le lecteur puisse répondre à la question définie à l'étape 1.

Pour les brouillons nouveaux ou révisés, lire contextes de livraison avant de choisir le canevas et la densité, y compris lorsque l'objectif est inconnu. Utiliser le tableau de sélection par question du lecteur pour les inventaires de capacités, les responsabilités, l'état des ressources, les demandes et réponses, les transitions d'état, le traitement de données ou l'architecture.

• Sélectionner le contenu. Choisir les objets, relations, processus et états nécessaires à l'explication. Avant d'omettre ou d'agréger du contenu ou de décider comment présenter des informations sources inconnues, lire fidélité à la source et choix d'information. Préserver le sens de la source dans ces choix.
• Allouer le contenu à sa surface. Avant la géométrie du diagramme, suivre placement du contenu pour attribuer les introductions de page, les étiquettes liées au diagramme, les légendes et la prose de support. Enregistrer l'allocation et le contexte requis par chaque format demandé.
• Organiser la structure. Définir les groupes, la hiérarchie et l'ordre de lecture pour que le lecteur puisse identifier les points principaux et suivre leurs relations.
• Définir la direction visuelle. Suivre conception visuelle pour sélectionner une direction pour le contexte d'utilisation. Pour les structures en couches avec une barre latérale, les processus avec des branches ou des retours, ou les cartes répétées avec un contenu plus long, sélectionner une recette de composition applicable. Enregistrer les choix concrets nécessaires à la production.
• Choisir des diagrammes statiques ou animés. Utiliser la disposition statique pour expliquer les structures et les relations. Pour l'animation, distinguer flux de relations persistantes, attention et changement par étapes ; une demande de lignes fluides peut garder l'ensemble du diagramme visible.
• Planifier le récit d'animation. Lors de l'utilisation d'animation, suivre rythme d'animation et continuité visuelle pour définir l'objectif d'explication de chaque étape, les changements d'état, les transitions et les pauses de lecture.

Procéder lorsque le plan enregistre le contenu sélectionné, ses surfaces porteuses, les groupes, l'ordre de lecture, les choix visuels et la présentation statique ou animée. Pour l'animation, inclure le plan des étapes.

3. Créer le diagramme

Implémenter la conception de l'étape 2 et générer les artefacts nécessaires à l'inspection à l'étape 4.

Utiliser Node 20+ et npm. Exécuter node <skill-directory>/scripts/flowsvg.mjs depuis le répertoire de travail choisi par l'utilisateur, avec des chemins entre guillemets si nécessaire. Résoudre les outils et les ressources de tâche dans ce skill installé. Le CLI prépare son propre environnement d'exécution SDK épinglé sans modifier les dépendances de l'application.

• Lire les directives de création pertinentes. Pour les brouillons nouveaux ou révisés, lire le modèle de document et les directives de disposition, et implémenter les recettes de conception sélectionnées. Avant d'agencer la géométrie, vérifier les problèmes de rendu pour les chemins courts avec des étiquettes longues, les barres latérales, le texte sans bordure, les cartes étroites ou les risques d'habillage dans n'importe quelle langue, l'alignement optique des étiquettes courtes, les bords de lecture partagés ou les tailles de contenu modifiées. Pour l'animation, lire aussi scènes, état hérité et timing. Pour les fichiers SVG, PNG ou GIF demandés, lire options et limites d'exportation.
• Construire le document du diagramme. Pour les brouillons nouveaux ou révisés, implémenter les objets, groupes, connexions, texte et étapes d'animation prévus. Préserver la langue source et la direction visuelle sélectionnée. Pour un nouveau diagramme sans direction spécifiée, commencer avec un thème clair et des groupes arrondis. Mesurer le texte sur le brouillon complet et suivre le workflow du plan de disposition lorsque la géométrie répétée nécessite un plan. Comparer chaque objet, direction de relation, limite parent et changement d'état aux sources. Sauvegarder les modifications autorisées dans un nouveau brouillon d'espace de travail ; pour une importation ou exportation inchangée, utiliser directement les octets d'entrée sélectionnés.
• Valider et corriger. Utiliser validate en lecture seule pendant l'itération et lire chaque diagnostic. Il retourne l'identité exacte de l'entrée et des vérifications finies sans créer de révision de diagramme ; conserver le brouillon de travail. Appliquer les corrections dans le cadre de l'autorisation actuelle, en suivant décisions de diagnostic et de révision. Clarifier les corrections qui changeraient le sens de l'explication avec l'utilisateur.
• Composer la page HTML. Pour les explications HTML nouvelles ou révisées, écrire le HTML/CSS de la page pour le contenu alloué en dehors du diagramme et le soumettre via pages HTML éditables. Pour un résultat existant, suivre continuation de page pour préserver sa conception et synchroniser explicitement les modifications de diagramme prévues. Réutiliser le starter installé pour les nouvelles pages lorsque cela est utile ; préserver la région du lecteur gérée et garder la page complète dans l'espace de travail de la tâche.
• Générer les artefacts d'inspection. Avant la capture par navigateur ou le choix d'un nombre d'échantillons d'aperçu, lire préparation du navigateur et échantillonnage. Utiliser author pour produire le HTML hors ligne requis, les aperçus nécessaires et les fichiers d'exportation demandés. Utiliser author --browser none lorsque seul un HTML intermédiaire est nécessaire. Pour plusieurs états statiques nommés, suivre exportations par lots nommés ; confirmer les temps sélectionnés à partir des battements compilés réels avec l'utilisateur avant de lier le manifeste. Suivre les contrats d'exécution et de résultat pour la configuration, la compatibilité SDK et les champs de rapport ; utiliser --help du CLI pour les options de commande.

Procéder lorsque le brouillon implémente le plan, ou qu'une entrée inchangée est préservée, que les erreurs bloquantes sont résolues, que les diagnostics restants ont des décisions de traitement enregistrées, et que tous les fichiers requis pour l'inspection sont complets. En cas d'échec d'exportation, suivre les règles de récupération ci-dessous et rapporter les fichiers terminés et non terminés séparément.

4. Inspecter le résultat

Pour les SVG/PNG livrés, suivre preuve d'artefact à la demande : exécuter evidence sur le sujet sauvegardé explicite, puis visualiser et examiner indépendamment ses images. Les conditions valides existantes sont réutilisées ; les nouvelles conditions restent non visualisées jusqu'à inspection.

Visualiser le diagramme généré et confirmer qu'il explique le sujet avec précision et clarté.

• Vérifier l'exactitude sémantique. Comparer les objets, les directions de relation, les limites de groupe et les changements d'état aux sources. Confirmer que les omissions et l'agrégation préservent le sens de la source.
• Vérifier la lisibilité visuelle. Visualiser les images rendues réelles à la taille d'affichage prévue. Inspecter le texte, l'espacement, l'occlusion et l'ordre de lecture. Tracer chaque connexion pertinente de sa source à travers les courbes et les croisements jusqu'à sa pointe de flèche ; vérifier les ports, les étiquettes et le dégagement des nœuds non liés.
• Évaluer la conception visuelle. Suivre inspection de la conception visuelle pour identifier les défauts visibles et enregistrer les observations pour le jugement final de conception de l'utilisateur.
• Vérifier l'explication de l'animation. Pour l'animation, inspecter l'état initial, les changements clés et l'état final par rapport au plan des étapes. Suivre inspection des aperçus pour les états échantillonnés. Utiliser la lecture réelle lors de l'évaluation du rythme ; rapporter l'inspection par échantillons uniquement comme limitée aux états visualisés.
• Vérifier les fichiers livrés. Demander à l'outil d'ouvrir le HTML hors ligne réel sauvegardé et vérifier son état initial en pause, ses contrôles, ses requêtes hors ligne et les états de lecture pertinents. Visualiser ses images capturées via le workflow d'inspection HTML. Inspecter les fichiers d'exportation demandés tels que livrés ; utiliser inspection d'artefact à taille cible pour les fichiers SVG/PNG finaux.

Avant de soumettre des critiques, lire les contrats d'entrée de critique complets et le workflow de modèle. Générer un formulaire non visualisé avec review-template à partir du sujet de diagramme explicite et, pour une preuve formelle séparée, --evidence-from, puis utiliser review indépendant pour les observations HTML, d'aperçu et de SVG/PNG formelles et enregistrer les ID, hachages, observations et problèmes uniquement pour les images réellement visualisées. La soumission répétée de critique ne nécessite pas une autre version de diagramme. Lorsqu'un navigateur ou un visualiseur d'images est indisponible, enregistrer les vérifications non effectuées et leur impact explicitement.

Pour les problèmes découverts, revenir à l'étape 3 pour appliquer les corrections autorisées, régénérer les artefacts et inspecter à nouveau les fichiers affectés et les états. Suivre décisions de diagnostic et de révision lors de l'enregistrement des problèmes ou de la clarification des problèmes de conception avec l'utilisateur.

5. Finaliser et rapporter

Terminer la tâche avec une sortie utilisable et un enregistrement clair de ce qui a été fait.

Pour chaque fichier livré, enregistrer l'artefact du fichier et produire un rapport final pointant vers le diagramme terminé, le résumé de la page, l'évidence formelle avec les avertissements, et l'état de demande d'exportation. Pour les dessins animés, inclure des images d'état échantillonnées lorsque le rapport de conception le nécessite, mais s'appuyer sur la lecture hors ligne réelle pour le moment.

Inclure les avertissements de version ou de dépendance, les problèmes de conception non résolus, les limites de vérification et un résumé de ce que le diagramme a et n'a pas expliqué. Terminer le rapport de tâche avec les décisions enregistrées, la couverture de vérification et la piste de l'artefact, puis rapporter l'opération à l'utilisateur.

Règles de récupération

Lorsque l'exportation échoue, (1) enregistrer l'échec dans le rapport de vérification, (2) après récupération, réexécuter la commande author enregistrée ou une commande révisée, puis (3) enregistrer le succès ou l'échec final d'exportation par fichier. Sur trois échecs consécutifs distincts, rapporter la condition comme non récupérable et enregistrer le problème de diagnostic. Ne pas perdre le brouillon de diagramme lors de la récupération.

Références

• Préférences de projet
• Contextes de livraison
• Fidélité à la source et choix d'information
• Patrons sémantiques
• Conception visuelle
• Ligne du temps
• Modèle de document
• Disposition statique
• Problèmes de rendu
• Exportation
• Diagnostics et révisions
• Vérifications visuelles
• Preuve d'artefact
• Entrées de critique
• Contrat d'outil