Communitygithub.com

動画コンテ Forge

Erstellt und bearbeitet Videostoryboards auf Basis von Drehbüchern, Konzepten oder Songtexten. Ermöglicht die Planung von Schnittfolgen, Sekunden, Kamerabewegungen, Aktionen, Dialogen, Musik und Soundeffekten für Musikvideos, Animationen, Realfilm, Werbung und Kurzvideos und generiert Schnittbilder, druckbare HTML-Storyboard-Tabellen, CSV, frame-basierte Zeitachsen und optionale einfache Animatics.

Was ist 動画コンテ Forge?

Diese Fähigkeit dient der professionellen Erstellung und Bearbeitung von Videostoryboards auf der Grundlage von Drehbüchern, Konzepten oder Songtexten. Sie ist ideal für die Produktion von Musikvideos, Animationen, Realfilmen, Werbespots und Kurzvideos (z. B. Shorts). Der Arbeitsablauf ist streng strukturiert: Nach der Eingabe von Drehbuch, Länge, Seitenverhältnis und Zweck erstellt das Tool ein YAML-basiertes Storyboard, weist jedem Cut eine `duration_frames` zu, validiert die Daten mit einem Python-Skript, generiert Cut-Bilder (sofern verfügbar), erstellt eine druckbare HTML-Storyboard-Tabelle und gibt die Ergebnisse als YAML, HTML, CSV, timeline.json und Bilder aus. Die Fähigkeit unterstützt die Zusammenarbeit mit verschiedenen KI-Agenten und Bildgenerierungstools, trennt jedoch strikt die Phase der Anweisungserstellung von der Bildgenerierung. Sie verwendet keine Bild-basierten Übergänge wie Überblendungen (nur harte Schnitte) und verzichtet auf die Einbettung von Text, Dialogen oder Tabellenlinien in die generierten Bilder. Stattdessen werden diese Informationen in separaten YAML-Feldern (`dialogue`, `sound`, `on_screen_text`) gespeichert. Das Tool ermöglicht auch Teilkorrekturen, bei denen nur bestimmte Cuts geändert und das Projekt neu erstellt werden, ohne bereits genehmigte Bilder erneut zu generieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add RNA4219/video-storyboard-forge

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht 動画コンテ Forge?

Es werden zeitlich geordnete Cuts als Produktionseinheiten verwendet, nicht Seiten eines Manuskripts. Comic-Panel, Turniere und Sprechblasen werden nicht auf die zeitliche und inszenierende Struktur des Videos übertragen.

Arbeitsablauf

  1. Bestätigung des vom Benutzer angegebenen Drehbuchs, der Länge, des Seitenverhältnisses, des Zwecks und des Materials. Falls nicht angegeben, wird vorläufig mit 24fps, 16:9 und 30 Sekunden gearbeitet; die Annahmen werden dokumentiert und so fortgefahren. Wenn vorhanden, wird die Länge von bestehenden Songs oder Drehbüchern bevorzugt. Keine spezifischen vorherigen Werke oder Charaktere werden ohne Erlaubnis eingebracht.
  2. Lese references/format.md und assets/sample.storyboard.yaml und erstelle ein projektspezifisches YAML. Auch wenn Songtexte gegeben werden, wird das Timing des Gesangs ohne eine tatsächliche Audioquelle nicht als gemessen behandelt.
  3. Verteile duration_frames so, dass die Summe mit target_frames übereinstimmt. Verwende stabile Bezeichner wie C001 für IDs und benenne sie beim Neuanordnen nicht um. Berechne Start- und Endzeiten nicht manuell, sondern durch Skripte.
  4. Validiere die Daten mit python scripts/storyboard.py validate PROJECT.yaml. Mit build wird eine vorläufige Storyboard-Tabelle und Anweisungen zur Bildgenerierung für jeden Cut ausgegeben, um die Struktur und Länge zu überprüfen.
  5. Falls Bilder benötigt werden, verwende verfügbare Bildgenerierungswerkzeuge / Bildgenerierungs-Skills. Übergib Anweisungen aus prompts/C001.txt usw. sowie Referenzen zu angegebenen Charakteren und Hintergründen. Ein Bild pro Cut; Text, Dialoge und Tabellenlinien werden nicht in das Bild eingebrannt. Wenn eine fortlaufende Bewegung beschrieben werden muss, werden die Key Poses innerhalb des Cuts textuell dargestellt und bei Bedarf in separate Cuts aufgeteilt.
  6. Öffne die generierten Bilder tatsächlich und überprüfe Bildausschnitt, Figuren, Bewegung, Blickrichtung, Bildrichtung und Kontinuität. Verwende für die Bildbeschaffung die tatsächliche Tool-Ausgabe und schätze keine Cuts anhand der „neuesten“ Reihenfolge im Generierungsordner. Setze für jeden Cut image auf einen relativen oder absoluten Pfad basierend auf dem YAML. Falls die Generierungsfunktion nicht verfügbar ist, vervollständige die Storyboard-Tabelle, Anweisungen und Zeitachse und kennzeichne sie als „unbebildert“.
  7. Führe build --require-images aus, um die endgültige Storyboard-Tabelle mit Bildern und separaten Spalten für Inszenierung und Audio-Anweisungen zu erstellen. Überprüfe die Anzeige und den Druckseitenumbruch im Browser usw. Erstelle bei Bedarf mit animatic eine MP4-Datei und überprüfe Länge und Reihenfolge mit ffprobe und einer Wiedergabe.
  8. Liefere YAML, HTML, CSV, timeline.json und Cut-Bilder aus. Folge den vom Benutzer angegebenen Speicherorten; in der Work-Umgebung verwende die Speicherverfahren der Library. Gib nach dem Speichern aller erforderlichen Dateien einen Link zurück. Melde kurz die Gesamtlänge, unbebilderte Cuts, ungeprüfte Stellen und das Vorhandensein von echtem Audio.

Ausführungsbeispiel

Skripte werden relativ zum Stammverzeichnis des Skills angegeben. Python 3.10+ und PyYAML sind erforderlich. Falls nicht installiert, verwende python -m pip install -r scripts/requirements.txt. Für die Anzeige und PDF-Ausgabe von japanischem Text ist eine japanische Schriftart in der Ausführungsumgebung erforderlich.

python scripts/storyboard.py validate assets/sample.storyboard.yaml
python scripts/storyboard.py build assets/sample.storyboard.yaml --out /absolute/path/board-v1
python scripts/storyboard.py build PROJECT.yaml --out /absolute/path/board-v2 --require-images
python scripts/storyboard.py animatic PROJECT.yaml --out /absolute/path/animatic.mp4

build wird angehalten, wenn der vorhandene Ordner nicht leer ist. Bei einer Überarbeitung wird in einen anderen Ordner ausgegeben. animatic erfordert ffmpeg und echte Bilder für alle Cuts. Die Ausgabe-MP4 darf noch nicht existieren, sonst wird abgebrochen. Es erfolgt keine automatische Übermittlung an externe APIs oder CLIs. Die Phase der Ausgabe von Anweisungen und Daten wird von der Phase der Bildgenerierung durch ein Bildgenerierungs-Tool getrennt.

Inszenierungsdesign

  • Jeder Cut verfolgt einen Hauptzweck: Situationsdarstellung, Aktion, Reaktion oder Höhepunkt.
  • Gib in camera.framing die Größe, in angle die Vogelperspektive / Augenhöhe usw. und in movement FIX, PAN, DOLLY usw. an. Verwechsle nicht die Bewegung von Figuren mit der Bewegung der Kamera.
  • Unterteile Dialoge in dialogue, Musik und Soundeffekte in sound und Text im Bild in on_screen_text. Stille wird ebenfalls explizit angegeben.
  • Inszenierungs-Timing innerhalb eines Cuts wird in cues von Beginn bis Ende mit relativen Frames [start_frame,end_frame) angegeben. Da das Bild ein Standbild ist, wird die Gültigkeit von Kamerabewegungen, Tanz oder Lippensynchronisation nicht allein durch das Bild als verifiziert betrachtet.
  • Für Musikvideos werden die Entsprechungen von Abschnitten, Takten und Songtexten in notes und cues festgehalten. Auch wenn die Schlagposition aus dem BPM berechnet wird, müssen der Einsatz der Audioquelle und Tempovariationen separat überprüft werden.
  • Überprüfe, ob lange Dialoge zeitlich in den Cut passen, indem du sie vorliest. Überprüfe die imaginäre Linie, Blickrichtung, Hintergrund, Kostüme und die Kontinuität des Haltens von Gegenständen.
  • In der aktuellen Version werden Übergänge nur als harte Schnitte verwendet. Überblendungen usw. werden als Produktionshinweise in notes vermerkt. Die Animatic dient der Überprüfung von Standbildwechseln und Stille und ist kein fertiges Video.

Teilkorrekturen

Ändere nur das YAML und die Bilder der betreffenden IDs und erstelle das Projekt in einem neuen Ausgabeordner neu. Nach einer Änderung der Länge wird die Gesamtsumme erneut validiert. Bereits genehmigte Bilder werden nicht pauschal neu generiert.

Herkunft

Dies ist eine Abwandlung des Arbeitsablaufs von sa-san10/rimochan-nyamuru-manga-forge („strukturiertes Design -> Bildgenerierung -> explizite Erfassung -> Qualitätsprüfung“), neu konzipiert für Video. Referenz-commit ist e1f002cd1073ea01fe17965ea0a8b32f6b6e70e3. Es gibt keine direkte Kompatibilität mit OMNY/OMAY für Comics. Code und Prompts wurden neu für Video implementiert. Die ursprüngliche Lizenz wird in LICENSE beibehalten. Die Beispiele verwenden eigene Personen und Szenen; Bilder der ursprünglichen Charaktere sind nicht enthalten.

Verwandte Skills