Nelle parole della skill
Una skill per creare, modificare e validare file di diagrammi draw.io (.drawio, .drawio.svg, .drawio.png) generando XML mxGraph corretto. Gestisce flowchart, architetture di sistema, diagrammi di sequenza, diagrammi ER e diagrammi delle classi UML tramite i template in assets/templates/, mentre le topologie di rete, BPMN e le mappe mentali richiedono librerie di forme o lavoro manuale.
L'agente riceve un workflow in sei passaggi, una palette di colori semantica con stringhe di stile pronte all'uso, una checklist di validazione pre-consegna e script Python opzionali (validate-drawio.py, add-shape.py). È pensato per agenti che lavorano in un repository dove i diagrammi si trovano insieme al codice che documentano, e i file generati sono pensati per aprirsi immediatamente nell'estensione VS Code hediet.vscode-drawio.
Che cosa produce
- Il file .drawio stesso, scritto nel percorso richiesto.
- Un riassunto in una frase di ciò che mostra il diagramma.
- Stato di validazione, che riporta se lo script di validazione è stato eseguito e ha avuto successo.
- Istruzioni di modifica quando è probabile che l'utente personalizzi il diagramma: clicca su una forma per selezionarla, fai doppio clic per modificare l'etichetta, trascina per riposizionare.
Come funziona
- 01Definisci con Precisione la Richiesta
Il workflow inizia stabilendo il tipo di diagramma, le entità o gli attori, le relazioni, il percorso di output e se il file è nuovo o una modifica.
- 02Riutilizza un Template o lo Scheletro Minimo
Quando il tipo di diagramma corrisponde a uno di quelli in assets/templates/, copia quella struttura e sostituisci i valori segnaposto; per layout inediti parti dallo scheletro mxfile minimo valido con le due celle radice.
- 03Pianifica il Layout Prima di Scrivere l'XML
Disegna prima righe o livelli, poi distanzia le forme sulla griglia — 40-60px in orizzontale tra forme sulla stessa riga, 80-120px tra le righe dei livelli, su una tela predefinita A4 orizzontale di 1169 x 827 px.
- 04Genera l'XML mxGraph
Scrivi le celle di vertici e archi con id univoci e riferimenti parent corrispondenti, ed esegui l'escape dei caratteri speciali XML nelle etichette affinché il file rimanga ben formato.
- 05Applica gli Stili dalla Palette
Le stringhe di stile provengono da una palette semantica fissa — primary/info #dae8fc con #6c8ebf, warning/decision #fff2cc con #d6b656, error/end #f8cecc con #b85450 — così lo stesso scopo mantiene lo stesso colore in tutto il progetto.
- 06Salva, Valida, Consegna
Scrivi il file nel percorso richiesto con estensione .drawio, esegui opzionalmente il validatore, poi indica all'utente come aprirlo e riassumi cosa contiene il diagramma.