Communitygithub.com

Storyboard-Sheet (故事板拼板)

Zerlegt beliebige Geschichten, Drehbücher oder Kurzfilmabschnitte in Einzelaufnahmen, generiert einheitlich stilisierte Storyboard-Bilder und setzt sie automatisch zu einem mehrfeldrigen Storyboard-Panel mit Aufnahmenummern und Zeitangaben zusammen.

Was ist Storyboard-Sheet (故事板拼板)?

Diese Fähigkeit (Skill) für KI-Agenten wandelt narrative Texte – ob Geschichten, Drehbücher oder KI-generierte Videoskripte – in ein professionelles, visuelles Storyboard um. Der gesamte Prozess ist als starre, aber flexible Pipeline definiert: Inhalt → Shot-Liste → statische Validierung → Bildgenerierung → Bildqualitätsprüfung → Rückverfolgbarkeit → Panel-Zusammenstellung → Endabnahme. Drei Qualitätstore stellen sicher, dass keine fehlerhaften Bilder erzeugt, keine mangelhaften Einzelbilder zusammengefügt und keine Ergebnisse ohne vollständige Rückverfolgbarkeit ausgeliefert werden. Kern ist ein JSON-Spezifikationsformat („shot sheet“), das Anker (Anchors) für Stil, Figuren, Raumplan, Kamerapositionen, Beleuchtung und Zustände zentral definiert. Jedes Einzelbild-Prompt wird aus diesen Anker-Originalphrasen zusammengesetzt, um Konsistenz über alle Bilder hinweg zu gewährleisten – der Hauptgrund für fehlgeschlagene Storyboards. Statische Validierungsskripte (validate-shots.ps1) prüfen vor der Bildgenerierung Pflichtfelder, Aufnahmenummern-Kontinuität, Zustandsübergänge und korrekte Anker-Verwendung. Nach der Generierung wird jedes Bild gegen eine zehn-Punkte-Qualitätsliste geprüft; bei Fehlern wird nur das betroffene Bild lokal nachgebessert. Das Zusammenbau-Skript (build-board.ps1) erstellt das finale Raster-Panel (z.B. 3×3, 2×2) im exakten Seitenverhältnis 16:9 ohne verzerrte Einzelbilder. Der Skill unterstützt Windows PowerShell und System.Drawing ohne zusätzliche Bibliotheken.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freedonplus/storyboard-sheet/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Storyboard-Panel (故事板拼板)

Stabilität entsteht nicht durch Improvisation, sondern durch eine festgelegte Kette: Inhaltskarte → Shot-Liste → statische Validierung → Bildgenerierung pro Bild → Qualitätsprüfung pro Bild → Rückverfolgbarkeit → Panel mit Überlagerung → Endabnahme des gesamten Panels. Jeder Schritt ist spezifiziert; nur die Geschichte ändert sich, nicht die Struktur. Drei Tore sichern die Qualität: Keine Bilder ohne Validierung, kein Panel ohne Einzelbild-Qualitätsprüfung, keine Auslieferung ohne Rückverfolgbarkeit.

Ausführungsablauf

  1. Inhaltskarte ausfüllen. Siehe prompt-templates.md für die Felder: Titel und Genre, Figurenanker, Szene, Positionskarte, Raumplan und Kamerapositionen, Zustandskarte, Licht und Textur, Bildformat und Anzahl der Bilder, Shot-Liste, Verbote. Fehlende Angaben werden vom Agenten basierend auf der Geschichte sinnvoll ergänzt; der Benutzer wird nicht nach Stilpräferenzen gefragt.
  2. Shot-Liste erstellen. Nach Inhalt-Ereignissen, nicht nach Wortzahl oder Bildästhetik aufteilen: Ein Bild pro wesentlicher Aktionsänderung. Als JSON im gleichen Schema wie assets/shots.example.json schreiben, Felder und Benennung exakt übernehmen. Alle szenenübergreifend wiederholten Sätze werden zentral im obersten anchors-Block gesammelt (single source of truth): style/characters/blueprint/blocking/axis/lighting/props/negative. Jedes Bild-Prompt wird aus diesen acht Originalsätzen zusammengesetzt. Eigenständige Varianten pro Bild sind verboten. Kamerapositionen in cameras schreiben. Jedes Bild muss camera/in_state/out_state haben.
  3. Statische Validierung (keine Bilder ohne Validierung). Zuerst scripts/validate-shots.ps1 ausführen: Pflichtfelder, Anzahl der Bilder, Aufnahmenummern-Kontinuität, zeitliche Abschnitte nahtlos aneinandergereiht, in_state/out_state Buchstabe-für-Buchstabe-Übergabe, ob jedes Bild-Prompt alle Anker-Originalsätze enthält, ob referenzierte Kamerapositionen existieren, Richtung der Referenzbildkette. Bei jedem FAIL zuerst das JSON reparieren, nicht in die Bildgenerierung gehen.
  4. Bildgenerierung pro Bild (einheitlicher Stil). Ein image_gen-Aufruf kann alle Bilder derselben Szene als mehrere Requests in request_list enthalten. Jedes Bild 1536×864. Jedes Bild-Prompt nach Vorlage aus prompt-templates.md: globaler Textur-Satz + Figurenanker-Satz + Szenen-Satz + Positionsanker-Satz + Skalenanker + Zustandskarte + Eintrittszustand + Aktionssatz + Austrittszustand + Verbotssatz. Alle Anker-Sätze werden in jedes Bild als wörtliche Kopie eingefügt. Innerhalb derselben Szene gemäß Kamerapositionsliste die Referenzbildkette verwenden: Das fertige Bild der vorherigen Aufnahme wird als Referenz an die nächste übergeben, mit der festen Anweisung „Nur die räumliche Anordnung, Figurenproportionen, Bodenbeziehung und Lichtrichtung referenzieren, nicht die Komposition kopieren“. Beim Szenenwechsel die Kette abbrechen und mit dem ersten Bild neu beginnen. Siehe continuity.md.
  5. Qualitätsprüfung pro Bild (kein Panel ohne Einzelbild-Qualitätsprüfung). Sobald ein Bild erzeugt ist, sofort die zehn Punkte aus prompt-templates.md prüfen: Gesichtsform/Kleidung zum Anker? Position im Raumplan? Links/rechts gemäß Achsenregel? Proportionen zum Skalenanker? Beleuchtungszustand/Zustandskarte semantisch korrekt? Lichtposition/Farbtemperatur konsistent? Wurde der Eintrittszustand der vorherigen Aufnahme übernommen? Gibt es Wasserzeichen? Bei Nichtbestehen lokal neu generieren: Prompt ändern, aber keine Anker-Sätze neu schreiben, nur den fehlerhaften Teil korrigieren. Bei zweimaligem Neugenerieren immer noch Drift: Das erste fertige Bild als zweites Referenzbild hinzufügen. Falls immer noch nicht, in eine geringere Einstellungsgröße wechseln (Nahaufnahme ist stabiler als Totalen).
  6. Rückverfolgbarkeit (keine Auslieferung ohne Rückverfolgbarkeit). Nach der Endabnahme jedes Bildes vier Dinge in das entsprechende shot-Objekt im JSON schreiben: prompt (vollständiger, an das Bildmodell gesendeter Originalsatz, kein Wort geändert), seed (falls vom Tool zurückgegeben), ref (die im Bild verwendete Referenzbild-ID-Kette, z.B. "SH003" oder "SH001+SH003"), qa (Qualitätsprüfungsergebnis und Anmerkungen). Dieses JSON ist das einzige Rückverfolgbarkeitsarchiv: Jeder kann damit jedes Bild reproduzieren und fehlerverantwortliche Sätze lokalisieren.
  7. Panel mit Überlagerung. Mit scripts/build-board.ps1 (parametrisiert: Spezifikations-JSON + Einzelbildverzeichnis + Ausgabepfad) gemäß der Formel in output-spec.md Anzahl der Bilder und Leinwandgröße bestimmen. Aufnahmenummern, Dauern und Aufnahmennamen werden nachträglich als halbtransparenter Balken am unteren Rand jedes Feldes überlagert. Das Bildmodell darf keine Texte zeichnen. Vor dem Zusammenbau erneut validate-shots.ps1 -PanelsDir <Einzelbildverzeichnis> -RequirePanels ausführen.
  8. Endabnahme des gesamten Panels und Auslieferung. Nach dem Zusammenbau das gesamte Panel prüfen: Passen benachbarte Bilder zusammen? Sind Figuren links/rechts im gesamten Panel konsistent? Sind Szenen-fixe Objekte (Haltelinien, Bordsteine, Türrahmen etc.) in Form im gesamten Panel konsistent? Sind die Informationen auf der Titelkarte korrekt? Bei Problemen zu Schritt 5 zurückgehen und nur die problematischen Bilder neu generieren. Das zusammengebaute Panel-Bild ausliefern (PNG-Original + JPG für einfache Ansicht) und das Shot-Liste-JSON. Wenn vom Benutzer angefordert, auch die Einzelbilder separat ausliefern.

Harte Regeln

  • Drei Tore: Statische Validierung der Shot-Liste nicht bestanden → keine Bildgenerierung; Einzelbild-Qualitätsprüfung nicht bestanden → kein Panel; prompt/seed/ref/qa nicht zurückgeschrieben → keine Auslieferung.
  • n×n-Raster + jedes Feld 16:9 = gesamtes Panel strikt 16:9. 3×3 aus 1280×720 ergibt 3840×2160; 4 Felder als 2×2; 6 Felder als 3×2 (breit) oder 2×3 (hoch); 9 Felder als 3×3. Nicht-quadratisches Raster-Seitenverhältnis = (Spalten×16):(Zeilen×9).
  • Anker als single source of truth: Figuren, Positionen, Raumplan, Beleuchtungsposition, Zustandskarte, Verbote haben jeweils einen einzigen Originalsatz im obersten anchors-Block. Jedes Bild-Prompt kopiert diese Originalsätze. „Wie oben“, „konsistente Gestaltung“ und umschreibende Sätze sind verboten. Figuren, die von Bild zu Bild ihr Gesicht ändern, sind der häufigste Fehler bei Panels.
  • Positionen basieren auf Szenen-fixen Objekten, werden ins jedes Bild als wörtliche Kopie übernommen: Haltelinien, N-te weiße Linie, Bordstein, Tischkante, Türrahmen, Geländerpfosten. „Vordergrund/Hintergrund/linke Bildhälfte“ zur Figurenbeschreibung ist verboten – diese ändern sich mit Einstellungsgröße und Kamera und sind die Hauptursache für Positionsdrift. Positionsänderungen werden nur als Richtung und Entfernung relativ zum Anker beschrieben (z.B. „einen Schritt nach vorne, über die Haltelinie treten“).
  • Szenenkonsistenz-Dreiklang: Raumplan (räumliche Koordinaten) + Zustandskarte (semantik veränderlicher Objekte) + Szenen-fixe Objektform (Material/Farbe/Anzahl) – alle als wörtliche Kopie in jedes Bild; nur bei Szenenwechsel ändern, der in der Shot-Liste mit scene_break: true markiert wird und die Referenzbildkette unterbricht.
  • Beleuchtungssatz ist im gesamten Set einheitlich; nur bei narrativem Zeitwechsel ändern, und das in der Shot-Liste vermerken.
  • Ein Bild eine Aktion: Startzustand → Weg/Berührungspunkt → sichtbares Ergebnis. Mehrere Aktionen auf benachbarte Bilder aufteilen.
  • Benachbarte Bilder müssen übergeben: Das out_state jedes Bildes muss wörtlich mit dem in_state des nächsten Bildes übereinstimmen (Position/Richtung/Aktionsphase/Berührungspunkt/Emotionsintensität – fünf Punkte). „Im Wesentlichen gleich“ ist verboten. Szenenwechsel werden explizit mit scene_break: true deklariert, nicht stillschweigend unterbrochen.
  • Nicht die Achse überschreiten, gemäß Kamerapositionsliste bewegen: Alle Kameras auf derselben Seite; Figuren tauschen nicht links/rechts im Bild. Winkel zwischen benachbarten Kameras ≤ 90°, Höhenunterschied ≤ eine Figurhöhe, Einstellungsgröße springt nicht zwei Stufen.
  • Skalenanker in jedes Bild schreiben: Ein fest dimensioniertes Szenenobjekt angeben (weiße Linie 45 cm, Bordstein 15 cm, Tischbreite 60 cm). Figurengröße über diesen Anker berechnen, um plötzliche Größenänderungen zu verhindern.
  • Zustandskarte als wörtliche Kopie in jedes Bild; Beleuchtungszustände müssen semantisch korrekt sein: Ampelfußgängerrot = stehende rote Figur; Ampelfußgängergrün = gehende grüne Figur; Fahrzeugampel = einfarbige Scheibe. Angeben, welche Lampe zu wem zeigt, und Fahrzeugfluss und Durchfahrtsrecht konsistent halten. Vermischungen wie eine Menschensilhouette in einer Scheibe oder grüne Ziffern auf rotem Grund sind verboten.
  • Schnittpunkt klar angeben, was übernommen wird: „Natürlicher Übergang“ oder „flüssige Verknüpfung“ ist verboten.
  • Leere Wörter durch konkrete ersetzen: Hochwertigkeit, beeindruckend, kinoreif, Stimmung maximieren – immer durch konkrete Angaben zu Licht, Material, Geschwindigkeit, Entfernung, Einstellungsgröße ersetzen.
  • Verbotsliste enthält fest: Keine Texte, Untertitel, Wasserzeichen, Nummern, Rahmen; genreabhängig erweitern (z.B. keine Blutspritzer, keine modernen Schusswaffen, nicht cartoonhaft).
  • Weniger als Spalten×Zeilen Bilder und mit title_cell aktiv: Das letzte Feld wird zur Titelkarte; sonst leere Felder dunkel lassen, keine Füllbilder einfügen.

Ressourcen

DateiZweck
references/prompt-templates.mdInhaltskarte, Einzelbild-Prompt-Vorlage, gesamtes Panel-Vorlage, Schreibweise für Aktion und Kamerafahrt, Einzelbild-Qualitätsprüfung, Fehlerliste
references/continuity.mdÜbergabekarten: Raumplan, Achsenregeln, Kamerapositionsliste, Zustandsübergabe, Referenzbildkette, Skalenanker, Rückverfolgbarkeit, Selbstcheckliste
references/output-spec.mdFormel für Bildanzahl und Seitenverhältnis, Auflösung, Überlagerungslayout, JSON-Feldspezifikation (mit Anker und Rückverfolgbarkeitsfeldern)
assets/shots.example.jsonVollständiges Beispiel einer Shot-Liste (8 Bilder + Titelkarte, mit anchors/cameras/Rückverfolgbarkeitsfeldern)
assets/demo.jpgBeispiel-Endprodukt: Vorschau des gesamten Panels aus obiger Shot-Liste (8 Bilder + Titelkarte, 3×3, lange Seite 2560 als JPG)
scripts/validate-shots.ps1Statische Validierung der Shot-Liste: Felder, Übergabe, Anker-Originalsätze, Kamerareferenzen, Existenz der Einzelbilddateien
scripts/build-board.ps1Panel-Zusammenbau mit Überlagerung: Liest JSON, gibt ganzes Panel als PNG und JPG-Vorschau aus

Beide Skripte nutzen Windows-eigenes PowerShell und System.Drawing, benötigen keine zusätzlichen Bibliotheken. Ausführung:

# Vor der Bildgenerierung: Statische Validierung (keine Bilder ohne Validierung)
& "<skill-verzeichnis>\scripts\validate-shots.ps1" -SpecPath <shots.json>

# Vor dem Zusammenbau: Mit Einzelbilddateien validieren (fehlende Bilder führen sofort zu FAIL)
& "<skill-verzeichnis>\scripts\validate-shots.ps1" -SpecPath <shots.json> -PanelsDir <einzelbildverzeichnis> -RequirePanels

# Panel zusammenbauen mit Überlagerung
& "<skill-verzeichnis>\scripts\build-board.ps1" -SpecPath <shots.json> -PanelsDir <einzelbildverzeichnis> -OutputPath <panel.png> -PreviewPath <vorschau.jpg>

Das Zusammenbauskript schneidet die Bilder mittig und füllt (cover), ohne sie zu verzerren; bei abweichenden Seitenverhältnissen der Einzelbilder vom Feldverhältnis gibt es keine Verzerrung.

Ein Beispiel-Endprodukt siehe assets/demo.jpg: Vorschau des gesamten Panels (8 Bilder + Titelkarte), entsprechende Shot-Liste ist assets/shots.example.json. Führen Sie zuerst validate-shots.ps1 aus und generieren Sie dann mit derselben JSON erneut, um ein Panel identischer Struktur zu erhalten.

Verwandte Skills