Was macht imagen-infographic?
Eine gute Infografik verwandelt komplexe Informationen in etwas Klares, Einprägsames und in Sekundenschnelle Erfassbares. Sie stellt Verständnis vor Dekoration. Diese Fähigkeit macht daraus einen wiederholbaren Prozess: Spezifikation schreiben, linten, rendern und den zurückgegebenen Text prüfen.
Die Gestaltungsregeln (vor dem Schreiben einer Spezifikation lesen)
-
Eine klare Botschaft. Du musst das Ganze in einem Satz zusammenfassen können. Schreibe diesen Satz zuerst als
message. Dieheadlinegibt die Kernaussage wieder, damit der Leser den Punkt in etwa fünf Sekunden erfasst. Zwei konkurrierende Ideen erfordern zwei Infografiken oder einen Artikelabschnitt. -
Genauigkeit und glaubwürdige Daten. Verwende nur Fakten aus dem Quellmaterial. Jede Zahl hat eine Quelle, und die Fußzeile listet die Quellen auf. Ein irreführender Maßstab oder eine herausgepickte Zahl zerstört das Vertrauen schneller als gar keine Grafik.
-
Ein benanntes Publikum. Passe Komplexität und Wortschatz an das Vorwissen des Lesers an. Ein allgemeiner Überblick hilft niemandem.
-
Hierarchie und Fluss. Größe, Kontrast und Platzierung lenken das Auge: Überschrift, dann Panel-Beschriftungen, dann kurze Phrasen. Verwende eine Reihenfolge von oben nach unten oder ein klares modulares Raster.
-
Die richtige Darstellung für die Daten.
barfür Vergleiche.linefür Trends über Zeit.timelineoderprocessfür Abläufe.diagramfür Beziehungen.comparisonfür den direkten Vergleich.statfür eine große Zahl.iconsoderchecklistfür eine kurze Liste.
Kein 3D, keine Torten mit vielen Segmenten, keine Dekoration ohne Bedeutung. Der Lint lehnt
pie,donut,radarund3dab. -
Einfachheit und Zurückhaltung. Halte Beschriftungen kurz und Phrasen noch kürzer. Verwende 2 oder 3 Schriftarten und 2 bis 4 Farben mit großzügigen Weißräumen. Wenn ein Abschnitt einen Absatz braucht, gehört er in den Artikel, nicht in die Infografik.
-
Barrierefreiheit. Der Textkontrast muss mindestens 4,5:1 betragen, und das Skript prüft dies. Verwende Farbe niemals als einziges Unterscheidungsmerkmal: Beschrifte die Elemente. Das Bild muss auf einem Handy lesbar bleiben.
-
Konsistenz. Verwende einen einheitlichen Symbolstil, ein Schriftsystem und gleichmäßige Abstände. Die Eingabeaufforderung verlangt dies, also untergrabe es nicht durch gemischte Anweisungen.
Fehlermodi. Überprüfe die Spezifikation vor dem Rendern auf Folgendes:
- Informationsüberflutung oder zu viele Themen
- Hübsche, aber bedeutungslose Dekoration
- Schwache Hierarchie, die den Leser nach dem Punkt suchen lässt
- Falsche oder verzerrte Diagramme
- Fehlende Quellen
- Unlesbarer Text
Arbeitsablauf
- Finde die Botschaft. Lese die Quelle (einen Artikelabschnitt, einen Bericht, Notizen). Schreibe den ein-Satz
messageund wähle dasaudience. Wenn du keinen Satz formulieren kannst, ist das Material nicht für eine Infografik bereit. - Schreibe die Spezifikation als Markdown-Datei mit YAML-Frontmatter. Das Format und ein vollständiges Beispiel findest du in
references/spec-format.md. Verwende 3 bis 6 Panels, jedes mit einer kurzen Beschriftung, einem visuellen Typ und maximal 3 Phrasen oder wenigen Datenpunkten. - Linte sie:
Der Lint erzwingt die Grenzen aus den Regeln 1, 2, 5, 6 und 7 und gibt eine Zeile pro Problem aus. Korrigiere die Spezifikation, nicht die Grenzen: Jede Grenze existiert, weil frühere Infografiken ohne sie gescheitert sind.python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - Rendern:
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--themeakzeptiert jede Themen-ID von imagen-diagrams und füllt die Palette und den Stil. Du kannst auchpalette:in der Spezifikation setzen.- Das Standard-Seitenverhältnis ist 3:4, ein Hochformat-Poster. Setze
aspect: "16:9"für eine Folie. - Das Skript schreibt
out.prompt.txtneben das Bild, damit du sehen kannst, was angefordert wurde. Verwende--dry-run, um die Eingabeaufforderung auszugeben und nichts zu verbrauchen.
- Das Tor. Das Skript liest das Bild mit
imagen analyzezurück. Die Überschrift, jede Panel-Beschriftung und die Quellenfußzeile müssen vorhanden und korrekt geschrieben sein. Das Skript versucht es bis zu 3 Mal (--attempts) und löscht ein fehlgeschlagenes Bild, sodass ein Fehler eine sichtbare Lücke ist, kein defektes Bild. - Betrachte das Ergebnis selbst. Öffne das PNG und überprüfe es anhand der acht Regeln. Das Tor prüft nur die Rechtschreibung. Es kann dir nicht sagen, dass die Hierarchie schwach oder ein Diagramm maßstabsgetreu ist. Wenn das Bild gegen eine Regel verstößt, ändere die Spezifikation (weniger Wörter, eine andere Darstellung) und rendere erneut.
Wenn du das Bild in einen Artikel einfügst, gib ihm eine Bildunterschrift und einen kurzen Absatz, der beschreibt, was es zeigt. Ein Leser, der das Bild nicht sehen kann, muss dennoch die Botschaft erhalten.
Szenen: Eine Person, die mit der Idee arbeitet
Eine Szene ist eine flache Illustration einer Person in dem Moment, den der Artikel beschreibt: ein Entwickler, der sich den Kopf über ein langes Chat-Protokoll kratzt, erleichtert, wenn ein Test bestanden wird, oder einen Plan auf einem Whiteboard skizziert. Szenen machen einen technischen Beitrag persönlich. Eine Szene kann eines der Diagramme des Artikels auf einem Monitor oder Whiteboard zeigen, was die Person mit dem Konzept verbindet. Verwende etwa eine Szene pro Artikel, in einem Moment der Frustration oder Erleichterung.
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox
Eine Szenen-Spezifikation ist ein kurzer Frontmatter-Block (siehe references/spec-format.md): person (wer, was tuend, welches Gefühl), setting, ein optionales diagram (ein PNG-Pfad relativ zur Spezifikation, gesendet als Referenzbild), theme oder palette und aspect (Standard 16:9). Szenen enthalten keinen eigenen Text, haben also kein Text-Tor. Betrachte jede: Die Emotion muss auf einen Blick lesbar sein, und das Bild darf keinen Titel, keine Bildunterschrift und keine Sprechblase haben.
Voraussetzungen
- Die
imagen-CLI (gemini-imagen) im PATH mit einem funktionierenden Schlüssel. - Das imagen-diagrams-Plugin für
--themeund den Engine-Failover in dessengenerate.py. Ohne das Plugin ruft das Skriptimagen generatedirekt auf, und du musstpalette:in der Spezifikation setzen. - Python 3 mit PyYAML.
Führe infographic.py --self-test aus, nachdem du das Skript geändert hast. Es überprüft die Lint- und Kontrastregeln, ohne einen Bildaufruf zu tätigen.