draw.io Diagrammer Skill
Wann dieser Skill verwendet wird
- Benutzer fordert ein Flussdiagramm, eine Prozesskarte oder ein Arbeitsablaufdiagramm an
- Benutzer fordert ein ERD, Datenbankdiagramm oder Entity-Relationship-Modell an
- Benutzer fordert ein Architektur-, System- oder Komponentendiagramm an
- Benutzer fordert ein Klassen-, Sequenz- oder UML-Diagramm an
- Benutzer sagt „draw.io", „Diagramm", „Flussdiagramm", „visualisiere diesen Prozess"
- Benutzer bittet darum, eine bestehende
.drawio-Datei zu aktualisieren, zu reparieren oder zu erweitern
ZWINGEND – Vor dem Generieren lesen
- Diagrammtyp zuerst erkennen – siehe diagram-types/ Referenzen, bevor XML geschrieben wird
- Universelle Box-Standards anwenden – siehe
references/box-style-standards.md - Alle Positionen sind fest codiert – es gibt kein Auto-Layout in draw.io XML
- Nach jedem Export den visuellen Prüf-Durchlauf ausführen – siehe
references/visual-review-protocol.md - Nie ohne visuelle Prüfung als abgeschlossen erklären – PNG exportieren, lesen, korrigieren, wiederholen
Diagrammtyp-Erkennung
| Benutzer sagt... | Referenzdatei |
|---|---|
| „Flussdiagramm", „Prozess", „Schritte", „Workflow", „SOP" | references/diagram-types/flowchart.md |
| „ERD", „Datenbank", „Tabellen", „Entitäten", „Fremdschlüssel" | references/diagram-types/erd.md |
| „Architektur", „System", „Komponenten", „Dienste" | references/diagram-types/layout.md |
| „Klasse", „UML", „Vererbung", „Methoden", „Attribute" | references/diagram-types/class.md |
| „Sequenz", „Interaktion", „Lebenslinie", „Akteur-Aufrufe" | references/diagram-types/sequence.md |
Standard-Generierungs-Workflow
Schritt 1 – Typ-Referenz laden
Lies die korrekte references/diagram-types/-Datei, bevor du XML schreibst.
Schritt 2 – Alle Elemente planen
Liste jeden Knoten, jede Verbindung und jeden Abschnitt auf, bevor du mit dem Codieren beginnst. Keine improvisierten Layouts während des Baus.
Schritt 3 – Universelle Box-Standards anwenden
Jeder Knoten muss die universellen Abstandsattribute aus references/box-style-standards.md enthalten.
Schritt 4 – Ausgabeordner erstellen und XML schreiben
mkdir -p ./diagrams
Speichern unter:
./diagrams/<diagram-name>.drawio
Checkliste vor dem Speichern:
- Alle
mxCell-Elemente haben eindeutige, aufsteigende numerische IDs - Universeller Box-Abstand auf jeden Knotenstil angewendet:
spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top; - Pfeile verwenden verkettetes Routing, kein Fan-Out von einer Quelle zu vielen Zielen
- Mindestens 15–20 px Abstand zwischen zwei Boxen (überprüfe untere Kante der Unterpunktliste vs. obere Kante des nächsten Abschnitts)
- Höhen mit der Formel aus box-style-standards.md berechnet (×16px pro Zeile bei fontSize=10)
- Breite Textfelder (Notizen, Beschreibungen) sind 530px+ breit – nicht 460px oder weniger
- Kein literal
\nin value-Attributen – verwende
für Zeilenumbrüche -
verticalAlign=topbei allen mehrzeiligen Inhaltsboxen
Schritt 5 – PNG exportieren und visuellen Prüf-Durchlauf ausführen
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio
Dann das vollständige Protokoll in references/visual-review-protocol.md befolgen.
Schritt 6 – Ausliefern
Sende dem Benutzer zuerst das PNG. Bei größeren Diagrammen sende Abschnitts-Screenshots (oben, Mitte, unten) vor dem vollständigen Bild.
Frage dann, welche zusätzlichen Formate gewünscht werden:
Das Diagramm ist fertig. Welches Format möchtest du?
1 – PNG-Bild (bereit zum Anzeigen)
2 – .drawio-Datei (bearbeitbar in draw.io)
3 – SVG (skalierbare Vektorgrafik)
4 – PDF
5 – Alle oben genannten
Antworte mit der/den Nummer(n) deiner Wahl.
Für Drive-Zustellung oder benutzerdefinierte Ausgabepfade folge references/workflow-sop.md.
CLI-Referenz
# macOS – PNG exportieren (Standard)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>
# macOS – PNG in hoher Auflösung exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>
# macOS – SVG exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>
# macOS – PDF exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>
# Linux / headless – PNG exportieren
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>
# Linux / headless – SVG exportieren
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>