fireworks-tech-graph: Geometrisch geprüfte SVG/PNG-Technikdiagramme aus natürlicher Sprache erzeugen

Für wen

Wenn du eine Architektur oder einen Ablauf in natürlicher Sprache beschreiben und ein geometrisch geprüftes SVG plus ein hochauflösendes PNG bekommen willst, passt dieses Agent Skill besser. Dasselbe Skill läuft in Codex und Claude Code ohne Änderung. Es kann außerdem eine geprüfte SVG-zu-GIF-Semantikanimation und offline interaktives HTML erzeugen.

Du musst das Skill in diesen Coding-Assistenten schon aufrufen können, und dein Rechner braucht python3 und muss $SKILL_ROOT/scripts/fireworks.py finden. Wer nur von Hand zeichnen und den Agent keine Dateien schreiben lassen will, hat wenig Nutzen. Die Seite nennt nur Codex und Claude Code, keine anderen Clients. Überschreibe die Zahlen im Textkörper nicht mit einer möglicherweise älteren Stilzahl im Repository-Titel: 11 Generatorstile plus 1 KI-Schreibstil (Dark Luxury).

Erster Versuch in 3 Minuten

Die Seite gibt keinen extra Marktplatz-Installationsbefehl. Zuerst eine Prüfung nur zum Lesen: Wenn das Skill-Wurzelverzeichnis schon bereit ist, führe aus

python3 "$SKILL_ROOT/scripts/fireworks.py" version

Erfolgssignal: Der Befehl läuft durch und gibt Versionsinformationen. Er schreibt keine Diagrammdateien. Existiert $SKILL_ROOT noch nicht, halte an: Der verfügbare Seitentext sagt nicht, wie das Skill in Codex oder Claude Code kommt. Erfinde keinen Installer.

Nach bestandener Version eine kontrollierte Ausgabe. Das offizielle Beispiel ist, dass der Nutzer “Generate a Mem0 memory architecture diagram, dark style” sagt. Das Skill klassifiziert es als Memory Architecture Diagram, Style 2, erzeugt ein SVG mit Schwimmbahnen, Zylindern und semantischen Pfeilen, exportiert ein 1920px-PNG und berichtet mem0-architecture.svg / mem0-architecture.png. Bevor Dateien geschrieben werden, lass den Agent diese zwei Pfade wiederholen und erzeuge erst nach deiner Bestätigung. Fang nicht mit GIF oder HTML an: Der verfügbare Seitentext erwähnt diese Artefakte, gibt aber keine passenden Unterbefehle.

Anwendungsfälle

Fall 1: Architekturdiagramm aus natürlicher Sprache. Nutze das Mem0-Beispiel oben, um die ganze Kette zu prüfen: klassifizieren → SVG → 1920px PNG → Dateinamen berichten. Es dokumentiert nicht alle visuellen Parameter von Style 2 und sagt nicht, woher das Mem0-Fachwissen kommt. Abnahme prüft nur: Die Klassifikation wird ausgesprochen, und jene zwei Dateinamen stehen im Bericht. Beginnt der Agent deinen Fachcode zu ändern, hat er die Diagrammaufgabe verlassen.

Fall 2: PNG aus vorhandenem SVG exportieren. Die offizielle CLI ist

python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920

Das überschreibt oder erzeugt diagram.png. Bestätige zuerst, dass das Eingabe-SVG existiert und der Ausgabepfad beschreibbar ist. Um abgeschnittenen Text zu vermeiden, füge "text_policy": "strict" zur Konfiguration hinzu: Es lehnt sichtbares Abschneiden vor dem Schreiben ab, behält vollständige Quell-Labels im Bericht und erklärt die Wiederherstellung; chinesische Beschreibungen nutzen die verfügbare zweite Zeile. Der verfügbare Seitentext gibt keinen vollständigen JSON-Dateinamen. Du kannst nur dieses Feld und die chinesische zweite Zeile bestätigen; erfinde keine anderen Policy-Werte.

Grenzen

Die Stilzahlen folgen dem Textkörper: 11 Generatorstile, plus Dark Luxury. Dazu kommen vier eher technische Stile mit ausführbaren Konventionen für C4-Review, Cloud-Deploy, Ereignisströme und Zuverlässigkeitsanalyse, sowie tiefe AI/Agent-Fachmuster und alle 14 UML-Diagrammarten. Die Seite nennt weder die 14 UML-Namen noch die Kurznamen jener vier technischen Stile. Fehlt der Name, rufe ihn nicht auf.

Kopierbare Befehle sind nur version und export-png. GIF und interaktives HTML stehen als Fähigkeiten da, aber ohne Kommandozeile. Stelle keinen zweiten Installer daneben. Clients sind nur Codex und Claude Code.

Der erste Halt ist version oder ein PNG mit bereits bestätigtem Pfad. Jede Stapelausgabe, jedes unbekannte Feld außer text_policy oder jede GIF/HTML-Erzeugung muss zuerst Grundlage und zu schreibende Dateien nennen; du bestätigst, dann geht es weiter.