wliafe/drawio-skill

Compétence d'opération Draw.io MCP

Utilise le Serveur Next AI Draw.io MCP (@next-ai-drawio/mcp-server) pour exécuter des tâches de dessin déjà définies. Cette compétence est responsable de l'utilisation des outils et de la livraison fiable, et ne dicte pas la composition, les couleurs, les polices ou les méthodes de recherche. Le flux de travail de base s'applique à différents clients d'IA ; la découverte des outils, leur appel et le chargement de la compétence sont déterminés par l'hôte actuel.

Déterminer la tâche et le service

1. À partir de la demande de l'utilisateur et du contexte actuel, déterminer : créer un nouveau fichier, modifier un fichier existant, continuer le canevas actuel ou enregistrer les modifications manuelles que l'utilisateur vient d'effectuer. Privilégier l'utilisation de matériaux, de répertoires cibles et de versions existantes clairement spécifiés.
2. Consulter les outils MCP actuellement exposés et mapper les noms des outils de service ci-dessous en fonction des descriptions réelles des outils, par exemple get_diagram, edit_diagram, export_diagram ; ne pas coder en dur les espaces de noms du client, les alias de service ou la syntaxe d'appel.
3. Si l'outil cible est exposé et que le client actuel autorise son appel, utiliser le get_drawing_guide en lecture seule pour vérifier la réponse ; conserver les décisions existantes de désactivation et de rejet. Si déjà disponible, continuer sans ajouter à nouveau. Si l'outil n'est pas exposé, cela ne signifie pas qu'il n'est pas installé ; pour vérifier la configuration, l'installation, le rechargement ou le diagnostic, lire Vérification et installation MCP.
4. Ce processus est destiné au package ci-dessus. Si l'utilisateur spécifie explicitement un autre service de dessin, conserver son choix, expliquer les limites d'adaptation et ne pas le remplacer sans autorisation.

Les services existants sont identifiés par le nom du package ; le nom du service peut ne pas être drawio. Si la configuration est visible mais n'a pas encore répondu réellement, signaler « Configuré, en attente de vérification ». Si l'accès à l'outil, au terminal ou à la configuration est manquant, fournir les méthodes actuellement exécutables sans affirmer que le service n'existe pas.

Déterminer l'emplacement de livraison et la version

Par défaut, enregistrer quatre fichiers du même nom dans documentation du projet/nom du thème/v1/ : nom du thème.drawio, nom du thème.png, nom du thème.svg, nom du thème.drawio.svg. Les noms peuvent être en chinois ou en anglais, la version n'est placée que dans le répertoire. Un nouveau thème commence par v1 ; les diagrammes existants conservent leur version actuelle, et une nouvelle vN n'est ajoutée que si l'utilisateur le demande explicitement.

Les fichiers existants continuent à utiliser leur chemin et nom d'origine, sans renommage automatique, migration ou mise à niveau de version. Les répertoires, formats et limites d'édition spécifiés par l'utilisateur sont prioritaires. En cas de problèmes de dénomination, de nouvelle version, de pages multiples ou de fractionnement, lire Conventions de dessin et de fichiers.

Opérations sur les sessions et les objets

• Exécuter les opérations MCP en fonction du contenu et de la conception fournis par la tâche en cours ; si l'entrée requise ne peut pas être déduite, confirmer uniquement les éléments manquants qui affecteraient l'objet de l'opération ou le résultat.
• Privilégier la réutilisation des sessions cibles déjà confirmées. Si nécessaire, appeler start_session pour en créer une nouvelle ou en restaurer une, et lire le format des outils et les contraintes d'opération ; si ces informations manquent, utiliser get_drawing_guide. La vérification de la connexion ne nécessite pas la création d'une nouvelle session.
• Pour les fichiers existants, après avoir utilisé load_diagram, d'abord get_diagram pour lire les ID des objets, puis modifier via edit_diagram par ID. Si le canevas actuel est connu et toujours valide, des modifications locales directes sont possibles ; en cas de conflit de modifications concurrentes, réorganiser l'édition en fonction du dernier contenu renvoyé par le service, sans écraser les nouvelles modifications de l'utilisateur.
• load_diagram et create_new_diagram remplacent le document actuel. Avant de basculer, confirmer si le canevas actuel est la cible et s'il y a des modifications manuelles à conserver. Si l'utilisateur demande de sauvegarder les modifications en cours, lire et exporter directement le canevas actuel sans charger d'abord le fichier disque plus ancien.
• Utiliser create_new_diagram uniquement pour les nouveaux diagrammes ou sur demande explicite de remplacement complet. Toute écriture ou modification de .drawio / .drawio.svg est effectuée via MCP ; ne pas utiliser d'outils de fichier ou de scripts pour réécrire directement le XML du diagramme. La construction de paramètres XML selon les besoins de l'outil est un appel normal.
• Le texte, les nœuds, les relations et les regroupements doivent rester modifiables ; les matériaux peuvent être intégrés, mais le diagramme entier ne doit pas être aplati en une image remplaçant le fichier source modifiable.
• Avant d'utiliser des icônes de services cloud, d'équipements réseau, etc., appeler get_shape_library et utiliser les noms de styles réels renvoyés ; ne pas deviner les identifiants d'icônes.
• Pour l'édition multi-pages, d'abord list_pages pour déterminer la cible, utiliser explicitement le paramètre de sélection de page, sans dépendre de la première page par défaut. Lorsque l'utilisateur dit « cette boîte » ou « la flèche sélectionnée », utiliser get_selection. Si la lecture de la sélection n'est pas disponible, lire le canevas et localiser par page, étiquette et position ; s'il y a encore plusieurs candidats, demander spécifiquement sans réinstaller le service ou demander à nouveau une sélection.

Images et capacité

Avant d'insérer une image, lire Prétraitement des images et contrôle de capacité. Vérifier d'abord le matériau et le volume d'incorporation estimé, compresser la copie si nécessaire : une compression modérée avec perte est autorisée pour les photos, tandis que le texte, les lignes fines et les matériaux transparents sont prioritaires pour la fidélité. Ne pas écraser le matériau original, ne pas installer automatiquement un logiciel de prétraitement.

Le budget doit couvrir le Base64 réel, le XML complet du diagramme, les requêtes sérialisées et les retours d'exportation. get_diagram peut replier les données d'image ; la longueur du texte renvoyé ne prouve pas que le diagramme n'a pas dépassé les limites. Après avoir inséré un gros matériau, tôt via MCP essayer d'exporter ; la création, la modification et l'exportation au format des diagrammes utilisent uniquement MCP, sans utiliser d'autres outils pour compenser l'exportation ni inventer des paramètres non exposés comme width, height, scale.

Si le blocage persiste après compression à une clarté acceptable, conserver les résultats réussis, expliquer le goulot d'étranglement et laisser l'utilisateur décider de continuer la compression, de supprimer du matériau ou de fractionner le diagramme, sans modifier automatiquement le contenu ou la pagination.

Sauvegarde et exportation

1. Avant de sauvegarder, utiliser get_diagram pour lire le canevas actuel, le fichier correspondant, la page et le chemin de sortie. Vérifier d'abord les avertissements de synchronisation ; « L'appel a réussi mais peut manquer les dernières modifications manuelles » signifie que l'état le plus récent n'est pas confirmé. Restaurer d'abord la synchronisation avant d'exporter officiellement ; si l'outil a déjà écrit un fichier, indiquer clairement que la récence de ce fichier n'est pas encore vérifiée et réexporter après restauration.
2. Enregistrer .drawio via export_diagram ; pour un fichier source multi-pages complet, ne pas inclure le paramètre de sélection de page. Par défaut, exporter également PNG, SVG, .drawio.svg éditable ; si l'utilisateur souhaite uniquement certains formats, suivre sa demande. Pour les images et SVG modifiables, sélectionner explicitement la page cible, sans dépendre de la page active du navigateur.
3. .drawio.svg doit être exporté comme le format réel correspondant ; ne pas renommer un SVG ordinaire pour le remplacer. Vérifier le contenu source du diagramme intégré ; avant de relire en toute sécurité, sauvegarder d'abord le canevas actuel. Pour les pages multiples, indiquer les pages incluses dans cette copie ; ne pas considérer une copie d'une seule page comme le fichier source complet.
4. Après exportation, relire et vérifier l'état du contenu observable, vérifier les avertissements de synchronisation. Le service n'a pas de verrou de capture instantanée universel ; si le contenu change pendant cette période, resynchroniser et exporter le fichier affecté, sans considérer une seule lecture comme une garantie de cohérence des quatre fichiers. En cas de changement continu ou d'incertitude, indiquer clairement que la synchronisation n'est pas terminée et, si nécessaire, demander à l'utilisateur de suspendre temporairement les modifications manuelles.
5. Utiliser des chemins absolus dans l'environnement d'exécution réel de MCP. Vérifier l'intégrité du contenu et l'absence de matériaux manquants dans la génération de fichiers et le rendu final ; une capture d'écran réussie ne signifie pas que l'exportation officielle a réussi. Lire le XML ou voir un message d'exportation réussi ne remplace pas la vérification réelle du rendu.
6. En cas de rétablissement de la connexion, réessayer une fois ; en cas de problème de capacité, corriger d'abord la capacité, puis réessayer l'étape affectée une fois. En l'absence de changement, ne pas appeler à nouveau ; en cas d'échec persistant, expliquer le goulot d'étranglement spécifique et le format manquant. Consulter les règles de sauvegarde détaillées dans Conventions de dessin et de fichiers.

Retour des résultats

Fournir brièvement le fichier source, l'image, la version utilisée et les vérifications effectuées. Indiquer séparément et honnêtement « configuration présente », « l'outil a répondu », « fichier sauvegardé » et « rendu consulté ».

Si l'exportation d'image ou la vérification visuelle est bloquée, conserver d'abord le fichier source sauvegardé avec succès, expliquer le format manquant et la raison spécifique ; ne pas utiliser d'anciennes images comme exportation actuelle ni écrire des parties non vérifiées comme terminées.