Flowy, KI-nativer Diagramm-Skill
Flowy erzeugt eigenständige HTML-Dateien, die interaktive SVG-Diagramme rendern. Jede Datei enthält eingebettetes CSS, JavaScript und Diagrammdaten – keine Abhängigkeiten, einfach doppelklicken und im Browser öffnen.
Dateipfade
- Diagramme:
docs/diagrams/*.html(z. B.docs/diagrams/upload-flow.html). Erstelle den Ordner bei der ersten Nutzung; er existiert möglicherweise noch nicht. Falls ein Projekt Diagramme bereits an anderer Stelle ablegt, folge stattdessen der dortigen Konvention. - HTML-Vorlage:
${CLAUDE_SKILL_DIR}/references/html-template.html, der kanonische Renderer und die einzige Referenzdatei, die dieser Skill mitbringt. Der Pfad löst sich in das eigene Verzeichnis dieses Skills auf, egal wo er installiert ist (Plugin, persönlich oder Projekt), und ist daher unabhängig vom aktuellen Projekt.
Es gibt bewusst keine Schema-Datei, keinen Beispiele-Ordner und keinen visuellen Editor. Frühere
Versionen dieses Skills verwiesen auf flowy/schema.ts, flowy/examples/,
flowy/editor.html und ein Flowy-Quellrepo auf der Festplatte. Keines davon existiert, die
Pfade waren veraltet und ihre Verfolgung kostete Zeit. Die obige HTML-Vorlage ist die
Quelle der Wahrheit für die Struktur; lies sie, bevor du ein Diagramm erstellst.
Vorbereitung
Bevor du ein Flowy-Diagramm erstellst oder bearbeitest:
- Lies
${CLAUDE_SKILL_DIR}/references/html-template.html, um den aktuellen Renderer-Code zu haben - Liste vorhandene Diagramme in
docs/diagrams/auf, um Namenskonflikte zu vermeiden - Falls du ein vorhandenes Diagramm aktualisierst, lies es zuerst und extrahiere das
DIAGRAM-Objekt
Schema
Jedes Diagramm ist ein JavaScript-Objekt mit drei Feldern:
{
meta: { title, description, type, tags[], created, updated },
nodes: [...],
edges: [...]
}
meta
| Feld | Typ | Erforderlich | Anmerkungen |
|---|---|---|---|
| title | string | ja | Menschenlesbarer Titel |
| description | string | nein | Was das Diagramm zeigt |
| type | string | ja | "flowchart" oder "ui-mockup" |
| tags | string[] | nein | Zur Organisation |
| created | string | nein | ISO-Datum (JJJJ-MM-TT) |
| updated | string | nein | ISO-Datum, beim Erstellen/Aktualisieren auf heute setzen |
nodes
| Feld | Typ | Erforderlich | Anmerkungen |
|---|---|---|---|
| id | string | ja | eindeutig, snake_case (z. B. "step1_upload") |
| type | string | ja | "box", "circle", "diamond", "note", "group" |
| label | string | ja | Primärer Text, der in der Form angezeigt wird |
| sublabel | string | nein | Sekundärer Text, der im Hover-Tooltip erscheint |
| position | { x, y } | ja | Oben-links-Ecke in Pixeln |
| size | { width, height } | ja | Abmessungen in Pixeln |
| style | object | nein | Siehe Stilfelder für Knoten unten |
| group | string | nein | ID des übergeordneten Gruppenknotens (nur visuelle Gruppierung) |
Stilfelder für Knoten: fill, stroke, strokeWidth, color (Text), fontSize, borderRadius, opacity
edges
| Feld | Typ | Erforderlich | Anmerkungen |
|---|---|---|---|
| id | string | ja | eindeutig (z. B. "e_upload_to_extract") |
| source | string | ja | Quellknoten-ID |
| target | string | ja | Zielknoten-ID |
| label | string | nein | Text auf dem Pfeil (z. B. "ja", "fehler") |
| sourceHandle | string | nein | "top", "right", "bottom" (Standard), "left" |
| targetHandle | string | nein | "top" (Standard), "right", "bottom", "left" |
| style | object | nein | Siehe Stilfelder für Kanten unten |
Stilfelder für Kanten: stroke, strokeWidth, strokeDasharray, markerEnd
Rendering-Regeln für Knoten
| Typ | SVG-Element | Details |
|---|---|---|
| box | <rect> | Abgerundete Ecken über rx/ry aus borderRadius. Standard: 8px |
| circle | <ellipse> | cx = x + width/2, cy = y + height/2, rx = width/2, ry = height/2 |
| diamond | <polygon> | 4 Punkte: oben-mitte, rechts-mitte, unten-mitte, links-mitte |
| note | <path> | Rechteck mit eingeklappter Ecke (oben-rechts). Faltgröße: 12px |
| group | <rect> | Gestrichelter Rand (stroke-dasharray: 6,3). Wird HINTER allen anderen Knoten gerendert. Bezeichnung oben-links. Niedrige Deckkraft |
Rendering-Regeln für Kanten
- Berechne Quellpunkt: Mitte der angegebenen Anschlussseite des Quellknotens (Standard: unten)
- Berechne Zielpunkt: Mitte der angegebenen Anschlussseite des Zielknotens (Standard: oben)
- Zeichne eine kubische Bezierkurve (
C-Befehl) mit Kontrollpunkten, die 50px in Anschlussrichtung versetzt sind - Füge eine Pfeilspitze mittels einer SVG-
<marker>-Definition hinzu - Falls
strokeDasharraygesetzt ist, rendere als gestrichelte Linie - Falls
labelvorhanden ist, rendere es am Mittelpunkt der Bezierkurve mit einem kleinen weißen Hintergrundrechteck dahinter
Layout-Regeln
Flussrichtung
- Flussdiagramme: Von oben nach unten (Standard)
- UI-Mockups: Von oben nach unten innerhalb eines Gruppencontainers, Anmerkungen rechts
Abstände
- Mindestens 70px vertikal zwischen Knotenmittelpunkten
- Mindestens 60px horizontal zwischen parallelen Knoten
- Gruppenabstand: 40px innerhalb der Gruppengrenzen
Entscheidungsrauten
- Linker Zweig = primärer / ja-Pfad
- Rechter Zweig = sekundärer / nein / Fehlerpfad
Fehler-/Warnhinweise
- Platziere sie RECHTS vom Hauptfluss
- Verbinde sie mit gestrichelten roten Kanten (
strokeDasharray: "6,3", stroke:#991b1b)
Standardgrößen
| Typ | Breite | Höhe |
|---|---|---|
| box | 200 | 50 |
| circle | 90 | 40 |
| diamond | 120 | 60 |
| note | 180 | 44 |
Farbpalette
| Zweck | Füllung | Rahmen | Text |
|---|---|---|---|
| Aktionen | #ffffff | #2d6a4f | #1f2937 |
| Primäre Aktionen | #d1fae5 | #065f46 | #065f46 |
| Entscheidungen | #fef3c7 | #92400e | #1f2937 |
| Fehler | #fee2e2 | #991b1b | #991b1b |
| Endknoten | #40916c | #2d6a4f | #ffffff |
| Gruppen | #f5f5f2 | #e6e4df | #374151 |
| Info/Sekundär | #dbeafe | #1e40af | #1e40af |
| Standard-Kanten | , | #6b7280 | , |
HTML-Dateistruktur
Jede Flowy-HTML-Datei folgt dieser Struktur. Lies die HTML-Vorlagenreferenz für den vollständigen funktionierenden Code.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{Diagrammtitel}</title>
<style>
/* Das gesamte CSS inline, Symbolleiste, Zeichenfläche, Tooltips, Auswahlhervorhebungen */
</style>
</head>
<body>
<div id="toolbar">
<!-- [Anpassen] [-] 100% [+] Titel Badge [JSON herunterladen] -->
</div>
<div id="canvas-wrap">
<svg id="canvas">
<defs><!-- Pfeilspitzen-Marker --></defs>
<g id="diagram-root"></g>
</svg>
</div>
<div id="tooltip"></div>
<script>
const DIAGRAM = { meta: {...}, nodes: [...], edges: [...] };
// Rendering- und Interaktivitätscode
</script>
</body>
</html>
Symbolleiste
- Fest am oberen Rand, 48px hoch, weißer Hintergrund, unterer Rand
- Links: Anpassen-Schaltfläche, Verkleinern, Zoom-%, Vergrößern
- Mitte: Diagrammtitel (fett) + Typ-Badge (graue Pille)
- Rechts: JSON herunterladen-Schaltfläche (blau)
Interaktivität (alles Vanilla-JS)
- Zoom: Mausrad skaliert das SVG-viewBox. Bereich: 0,2x bis 5x. Zoom zur Cursorposition hin.
- Schwenken: Klicken und ziehen auf leerer Zeichenfläche verschiebt das viewBox.
- Hover: Wenn du mit der Maus über einen Knoten fährst, wird dessen
sublabelin einem Tooltip in der Nähe des Cursors angezeigt. - Klick: Ein Klick auf einen Knoten hebt ihn hervor (blauer Rand) und alle verbundenen Kanten. Klicke auf leeren Bereich, um die Auswahl aufzuheben.
- Anpassen: Die Schaltfläche berechnet den Begrenzungsrahmen aller Knoten und setzt das viewBox mit 60px Abstand.
- JSON herunterladen: Serialisiert das
DIAGRAM-Objekt als formatiertes JSON und löst einen Dateidownload aus.
Erstellen eines neuen Diagramms
Wenn der Benutzer ein neues Flussdiagramm oder UI-Mockup wünscht:
- Lies die Vorlage: Lies die HTML-Vorlagenreferenzdatei, um den aktuellen Renderer-Code zu erhalten
- Analysiere die Anfrage: Identifiziere Knoten (Schritte, Entscheidungen, Fehler) und Kanten (Verbindungen)
- Weise Positionen zu mithilfe der Layout-Regeln (Raster von oben nach unten, Standardabstände)
- Wende Farben an mithilfe der Farbpalette (Endknoten = grün, Entscheidungen = bernsteinfarben, Fehler = rot, usw.)
- Erzeuge die vollständige HTML-Datei: Kopiere die Vorlagenstruktur, ersetze das
DIAGRAM-Objekt mit den neuen Daten - Speichere sie unter
docs/diagrams/{kebab-case-name}.html - Teile dem Benutzer mit: "Öffne
docs/diagrams/{name}.htmlin deinem Browser, um das Diagramm anzuzeigen."
Dateibenennung
- Speicherort:
docs/diagrams/{name}.html - Format:
kebab-case.html(z. B.docs/diagrams/upload-flow.html,docs/diagrams/checkout-screen.html) - Setze
meta.updatedauf das heutige ISO-Datum
Aktualisieren eines vorhandenen Diagramms
Wenn der Benutzer ein Diagramm ändern möchte:
- Lies die vorhandene HTML-Datei
- Extrahiere das
DIAGRAM-Objekt aus dem<script>-Block - Ändere die Knoten/Kanten wie gewünscht
- Aktualisiere
meta.updatedauf das heutige Datum - Erzeuge die vollständige HTML-Datei mit den aktualisierten Daten neu (lies die Vorlage für den neuesten Renderer erneut)
- Speichere sie zurück unter demselben Pfad
Lesen eines Diagramms
Wenn du gebeten wirst, ein Diagramm zu analysieren oder zu beschreiben:
- Lese die HTML-Datei
- Finde den Block
const DIAGRAM = { ... }; - Liste Knoten nach Typ und Bezeichnung auf
- Verfolge Kanten, um den Fluss in natürlicher Sprache zu beschreiben
- Hebe Entscheidungspunkte und ihre Verzweigungen hervor
Beispiele
"Erstelle ein Flussdiagramm für den Login-Ablauf"
Aktion: Erstelle docs/diagrams/login-flow.html mit:
start(Kreis, grün) →enter_credentials(Box) →validate(Raute, bernsteinfarben)validate→ ja/links →dashboard(Kreis, grün)validate→ nein/rechts →show_error(Notiz, rot) → gestrichelter Pfeil zurück zuenter_credentials
"Aktualisiere das Einstellungs-Mockup, um einen Dark-Mode-Umschalter hinzuzufügen"
Aktion: Lese docs/diagrams/settings-screen.html, extrahiere DIAGRAM, füge einen neuen Box-Knoten "section_dark_mode" mit der Bezeichnung "Dark Mode" nach dem Abschnitt "Theme" hinzu, aktualisiere meta.updated, erzeuge das HTML neu.
"Füge Schritt 3 des Upload-Ablaufs eine Fehlerbehandlung hinzu"
Aktion: Lese das HTML, finde Schritt 3 im Knoten-Array, füge rechts einen Fehlerhinweis-Knoten hinzu, füge eine gestrichelte rote Kante von Schritt 3 zum Fehlerhinweis hinzu, erzeuge neu.
Wichtige Einschränkungen
- Keine Abhängigkeiten: Kein npm, keine CDN-Links, keine externen Skripte/Styles
- Funktioniert offline: Muss ohne Internetzugang rendern
- Einzeldatei: Jedes Diagramm ist EINE
.html-Datei - Browser-nativ: Nur standardmäßiges HTML5, CSS3, SVG und Vanilla ES6+ JavaScript
- LLM-freundlich: Das DIAGRAM-JSON muss sauber formatiert sein, nicht minimiert
Selbstwartung
Wenn du beim Erstellen von Diagrammen ein nützliches Muster entdeckst, einen neuen Layout-Trick, eine Farbe, die für einen bestimmten Zweck gut funktioniert, eine Rendering-Verbesserung – aktualisiere diese Skill-Datei, um sie aufzunehmen. Halte den Skill genau und handlungsorientiert.