Diagram Studio
Verwandeln Sie eine JSON-Spezifikation in ein gestochen scharfes Diagramm. Das Aussehen ist vollständig konfigurierbar:
- Handgezeichnet: rough.js Wackeln und Handschrift-Schriftarten.
- Sauberer Vektor: kein Wackeln, serifenlose oder Serifenschriften, weiche Schatten.
- Alles dazwischen.
Der gesamte Text wird in Pfade umgewandelt, sodass SVG und PNG überall identisch aussehen. Ein Linter erkennt Überlappungen, überlaufenden Text, Beschriftungen auf Rändern und Pfeile, die durch Kästchen verlaufen.
Alles ist gebündelt: Node 18+ ist die einzige Voraussetzung, kein npm install und kein Netzwerk.
SKILL_DIR unten ist der absolute Pfad dieses Skill-Ordners (der Ordner, der diese Datei enthält).
node SKILL_DIR/scripts/render.mjs diagram.json --out out/ # → out/diagram.png (2x), .svg, .report.json, .tiles/
0. Ausführung in Codex, Claude Code oder einem anderen Agenten
- SKILL_DIR:
- In Codex erweitern Sie den kurzen Pfad des Skills mit der Skill-Roots-Tabelle (z.B.
r0/diagram-studio/SKILL.md→~/.codex/skills/diagram-studio). - In Claude Code ist es normalerweise
~/.claude/skills/diagram-studio. - Rufen Sie die Skripte immer mit diesem absoluten Pfad auf.
- In Codex erweitern Sie den kurzen Pfad des Skills mit der Skill-Roots-Tabelle (z.B.
- Das Betrachten der Bilder ist obligatorisch: das Original, das Raster, die Kacheln und der Vergleich.
- Codex: Verwenden Sie das
view_image-Werkzeug mit dem PNG-Pfad.render.mjsschreibtname.preview.png(≤ 1400 px) dafür, sodass Sie das Bild nicht selbst skalieren müssen; für Details verwenden Siename.tiles/*.png. - Claude Code: Verwenden Sie das Read-Werkzeug.
- Beurteilen Sie eine Ausgabe niemals nur anhand der Lint-Ausgabe.
- Codex: Verwenden Sie das
- Sandbox-freundlich:
- Es wird nur
nodebenötigt. Es gibt keine Netzwerkaufrufe und keine Installationen. - Ausgaben gehen nach
--out; behalten Sie sie im Arbeitsbereich, z.B../diagram-out. - WebP/HEIC-Konvertierung schreibt in das temporäre Systemverzeichnis.
- Es wird nur
- Der Benutzer hat ein Bild eingefügt statt einen Pfad anzugeben: Wenn Sie einen Anhangspfad sehen können, verwenden Sie ihn. Fragen Sie andernfalls nach dem Dateipfad, da die Werkzeuge eine echte Datei benötigen.
- Abschluss: Listen Sie die absoluten Pfade der PNG, SVG und JSON auf, damit der Benutzer sie öffnen kann.
1. Wählen Sie den Auftrag
| Benutzer möchte | Auftrag | Weiterlesen |
|---|---|---|
| „Dieses Bild klarer / höher aufgelöst / sauberer machen“, „neu zeichnen / wiederherstellen / 复刻 / 高清重建“ | A. Vom Bild neu aufbauen. Originaltreue zuerst: den ursprünglichen Stil beibehalten, sofern nicht anders gewünscht | references/rebuild-from-image.md (erforderlich) |
| „Verschönern / aufräumen / 美化 dieses Diagramm“ | A + Verfeinerung. Wie A, dann Hierarchie, Abstände und Ausrichtung verbessern | references/rebuild-from-image.md |
| Ein neues Diagramm aus einer Beschreibung, Code oder Notizen | B. Neues Diagramm | references/spec.md |
| Ein anderes Aussehen („mach es handgezeichnet“, „flaches Corporate-Design“, „Blueprint“, „für ein Paper“) | C. Stiländerung | references/style-guide.md |
Passen Sie den Stil eines gegebenen Bildes standardmäßig an: Handgezeichnet bleibt handgezeichnet, flach bleibt flach, und seine Farben und Schriftkategorie bleiben erhalten. Ändern Sie das Aussehen nur, wenn der Benutzer danach fragt. Voreinstellungen sind Ausgangspunkte, keine Grenzen; styleOverrides, benutzerdefinierte Paletten und benutzerdefinierte Schriftdateien ("fonts") können fast jedes Aussehen reproduzieren. Fragen Sie nur nach der Originaltreue, wenn die Anfrage wirklich mehrdeutig ist, z.B. „verschönern“ ohne Referenzstil. Standardmäßig wählen Sie originalgetreu + klarer.
Beginnen Sie mit der nächstgelegenen Vorlage in templates/: kopieren Sie sie in den Arbeitsordner und bearbeiten Sie die Kopie. Vorschauen finden Sie in assets/gallery/. Eine Vorlage ist ein Muster, kein Inhalt: Ersetzen Sie den gesamten Text und behalten Sie Zeilenumbrüche und Pfeile genau wie in Ihrer Quelle bei. --expect erfasst Reste und geänderte Formulierungen.
| Vorlage | Zeigt |
|---|---|
dense-rebuild.json | Wiederaufbau eines dichten Architekturbildes: explizite Koordinaten, Karten, Panels, verbundene Verbinder, Inline-Beschriftungen |
pipeline-rag.json | Links-nach-rechts-Pipeline: Zeilen mit connect, rightOf, automatisch angepasste Panels |
layered-architecture-zh.json | Chinesische Schichtenarchitektur: gestapelte below-Zeilen, Fächerpfeile, Zylinder |
flowchart-decision.json | Flussdiagramm: Ellipse, Raute, Ja/Nein-Zweige, Rückkopplungspfeile |
agent-loop.json | Zyklus: gebogene Pfeile, Abzeichen, Ellipsenknoten |
auto-layout.json | Keine Koordinaten: ELK-Autolayout mit Gruppen |
2. Der Zyklus (jeder Auftrag)
-
Erstellen Sie zuerst ein Inventar. Listen Sie jeden Textstring wörtlich auf (speichern Sie ihn als
texts.txt, eine pro Zeile), jeden Knoten, jeden Pfeil (von → nach, Beschriftung) und jede Gruppe. Nichts wird erfunden oder weggelassen. -
Schreiben Sie
name.json, beginnend mit einer Vorlage. -
Rendern Sie:
node SKILL_DIR/scripts/render.mjs name.json --out AUSGABE --expect texts.txt -
Beheben Sie jeden FEHLER; jeder kommt mit einem konkreten
→-Hinweis. Beheben Sie Warnungen (WARN), sofern sie nicht beabsichtigt sind, und unterdrücken Sie beabsichtigte Warnungen mit"ignore": ["code"]auf dem entsprechenden Element oder Pfeil. -
Betrachten Sie
AUSGABE/name.pngundAUSGABE/name.tiles/*.pngund vergleichen Sie mit dem Original (scripts/compare.mjs). Führen Sie die Checkliste inprompts/visual-review.mddurch; der Linter kann Bedeutung, Ausgewogenheit oder Originaltreue nicht beurteilen. -
Wiederholen Sie die Schritte 3–5, bis es 0 Fehler gibt und es gut lesbar ist (normalerweise 2–4 Durchläufe).
-
Liefern Sie:
name.png: 2x; verwenden Sie--scale 3für den Druck.name.svg: Vektorgrafik.name.json: für spätere Bearbeitungen aufbewahrt.
Fügen Sie eine Zeile hinzu, was Sie beibehalten und was Sie verbessert haben.
3. Spezifikation in 60 Sekunden
{
"canvas": { "width": 1600 },
"style": "marker",
"title": "Checkout Service",
"subtitle": "{blue:clients} · {purple:services} · {green:data}",
"elements": [
{ "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
{ "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
"lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
{ "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
{ "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
{ "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
],
"arrows": [
{ "from": "web", "to": "api", "label": "HTTPS" },
{ "from": "api", "to": "db", "label": "INSERT", "color": "green" }
]
}
-
Elementtypen:
box(Standard),pill,ellipse,circle,diamond,cylinder,note,card,panel,text,icon,badge,image,path(benutzerdefinierte SVG-Form) sowie die Layout-Helferrow,columnundgroup. -
Positionieren Sie jedes Element mit einem der folgenden:
x/yfür die obere linke Ecke odercx/cyfür die Mitte.below/above/rightOf/leftOfplusgap.contains, das ein Panel automatisch um seine Kinder anpasst.
Die Größe wird automatisch bestimmt. Setzen Sie
w/h, um ein Original exakt zu treffen. -
Text:
titleist fett und\nbricht die Zeile um.linessind Textzeilen. Markup im Text:**fett**`code`(verwendet die Code-Schriftart){green:span}und{muted:span}->(wird als Pfeilglyphe gezeichnet)
Chinesisch und Englisch mischen sich frei. Pro Element können Sie
size,textSize,font,textColorundalignsetzen. -
Farbe mit einer Familie (
blue purple green orange red teal yellow pink gray navy), einem Farbton (blue.tint),#hexoder einem einfachen CSS-Namen wiewhite, gesetzt übercolor,fill,strokeundtextColor. -
Pfeile verbinden
frommitto:- Verankern Sie eine Seite und gleiten Sie daran entlang mit
"id.right"oder"id.right+20". - Beschriftungen:
label, platziert mitlabelPos(above,below,left,rightoderinline) und verschoben mitlabelAt. - Aussehen:
dash,color,widthundhead(end,start,bothodernone). - Pfad:
via-Punkte,points(eine exakte Polylinie) oder"route": "curve".
- Verankern Sie eine Seite und gleiten Sie daran entlang mit
Jeder Schlüssel ist in references/spec.md.
4. Aussehen: Stil, Palette, Schriftart, Effekte
-
Stil-Voreinstellungen:
- Handgezeichnet:
marker(Standard),neat,excalidraw,sketchy,whiteboard,pencil,blueprint,chalk. - Sauber:
clean,paper.
Jedes Voreinstellungsfeld kann durch
styleOverridesüberschrieben werden:roughness(0 = perfekt gerade Linien) undbowingfillStyle(solid,hachure,cross-hatch,dotsodernone)strokeScale,cornerRadiusshadow(none,softoderhard)font,cjkFont,codeFont,background
- Handgezeichnet:
-
Paletten:
marker,pastel,excalidraw,mono,academic,colorblind,modern,blueprint,chalkboard,midnight. Um die Farben eines Originals exakt zu reproduzieren, führen Sienode SKILL_DIR/scripts/palette.mjs original.pngaus und fügen Sie das Ergebnis ein. -
Schriftarten:
- Handschrift:
shantell,kalam,caveat,patrick,architects. - Serifenlos:
inter. Serif:serif. Mono:mono. - CJK:
kai(handschriftlich),kuaile(verspielt),sans-sc(sauber). - Eigene
.ttf/.otf/.woff:"fonts": {"marke": {"regular": "Marke.ttf", "bold": "Marke-Bold.ttf"}}, dann"font": "marke".
- Handschrift:
-
Kataloge:
assets/gallery/styles.png,palettes.pngundfonts.png. Neu generieren mitscripts/catalog.mjs. -
Symbole: 1.500+ Lucide-Symbole. Suchen mit
node SKILL_DIR/scripts/icons.mjs search 数据库 robot queueund Vorschau miticons.mjs sheet a,b,c. -
Werkzeuge für Originalbilder:
grid.mjs: Koordinaten auf dem Original überlagern. Lesen Sie die roten Achsenbeschriftungen, niemals Pixelpositionen.fontmatch.mjs: Beispieltext in jeder Schriftart neben einem vergrößerten Ausschnitt des Originals anzeigen.palette.mjs: Farben des Originals extrahieren.crop.mjs: Logos, Fotos oder Screenshots ausschneiden, um sie alsimage-Elemente einzubetten.compare.mjs: Seitenweiser Vergleich; fügen Sie--crop x,y,w,hhinzu, um beide Bilder auf denselben Bereich zu zoomen.
-
Dunkle oder alternative Versionen: Behalten Sie dieselbe Spezifikation und ändern Sie nur
palette(midnight,blueprintoderchalkboard) oderstyle, und rendern Sie dann unter einem anderen--name. -
Für Folien (PPT, Keynote):
"canvas": {"aspect": "16:9"}polstert das Bild auf das Folienverhältnis."background": "transparent"ergibt ein PNG mit Alphakanal. Das SVG kann auch direkt eingefügt werden.
5. Klarheitsregeln (immer anwenden)
- Behalten Sie die Wörter genau so bei, wie sie vorgegeben sind: Beschriftungen, Code-Identifikatoren und chinesische Begriffe. Erfinden, übersetzen oder entfernen Sie niemals Text, es sei denn, der Benutzer verlangt es.
- Machen Sie die Hierarchie sichtbar:
- Fette Überschrift pro Kästchen.
- Identifikatoren als Textkörper oder
Code-Text. - Erklärungen als
muted-Text. - Abschnittsüberschriften in der Farbe des Abschnitts.
- Farbe bedeutet etwas: eine Familie pro Bereich oder Rolle, konsistent verwendet. Pfeilbeschriftungen erben die Farbe ihres Pfeils.
- Luft zum Atmen:
- ≥ 60 px zwischen Formen, die durch einen beschrifteten Pfeil verbunden sind, ≥ 24 px sonst.
- Panels mit
containsangepasst. - Keine Beschriftung auf einem Rand.
- Lesbar beim Verkleinern:
- Text ≥ 18 px (Standardeinstellungen: Knoten 30, Textkörper 25, Beschriftung 24).
- Leinwand 1400–2200 px breit, mit einem Seitenverhältnis zwischen 1:2 und 3:1. Der Linter warnt sonst.
- Lange Ketten von 6+ Knoten: serpentinieren Sie sie in 2–3 Zeilen oder verwenden Sie ELK
"direction": "DOWN", anstatt einer sehr langen Zeile.
- Wenige Kreuzungen und keine Umwege. Richten Sie aus und sortieren Sie neu, bevor Sie
viahinzufügen. - Verfeinern, nicht neu entwerfen bei Wiederaufbau-Aufträgen: Verbessern Sie Ausrichtung, Abstände und Hierarchie, behalten Sie aber Topologie, Lesereihenfolge und Stilidentität bei.
6. Abschlusskriterien
-
render.mjsmeldet 0 Fehler. Jede verbleibende Warnung ist beabsichtigt und mitignoreunterdrückt. - Jeder Inventar-String ist vorhanden und genau geschrieben (
--expect texts.txtbesteht). - Sie haben das PNG und die Kacheln betrachtet und bei Wiederaufbauten mit dem Original verglichen: gleiche Struktur, gleiche Stilidentität, klarer.
- Sie haben das PNG, SVG und JSON ausgeliefert, mit einer kurzen „beibehalten / verbessert“-Notiz.
7. Fehlerbehebung
node: command not found: Installieren Sie Node 18+. Es wird nichts weiter benötigt.- WebP, HEIC, BMP- oder TIFF-Eingabe wird automatisch konvertiert, wenn
sips,magick,dwebp,ffmpegoder Python PIL verfügbar ist. Andernfalls fragen Sie den Benutzer nach einer PNG oder JPEG. - Ein Zeichen wird als
?dargestellt: Die gebündelten Schriftarten decken lateinische Schrift, GB2312-Chinesisch und gebräuchliche Symbole ab. Formulieren Sie es um oder registrieren Sie eine Schriftart, die es enthält. - Für jeden Lint-Code und seine Behebung siehe
references/troubleshooting.md.