/3d-video-studio
┌──────────────────────┐
│ "Warum Autofahrer │ Titel fragt nach einem Verhalten, nennt nie die Erfindung
│ anfingen, die │
│ Straße zu filmen" │
│ ◕‿◕ ▶ 💥 │ Haken: die Untat des Schurken, Auszahlung bis 4 s
│ Schlupfloch → Gier │ Eskalation, todernstes Gegenhalten, zwei „Aber“-Wendungen
│ ruhiger Typ zeigt ▣ │ Enthüllung durch die Sicht der Erfindung
│ "und so wurde die ___│ Merksatz beantwortet den Titel, letzter Schuss loopt zum ersten
│ erfunden." │
└──────────────────────┘
Arbeiten Sie die Schritte der Reihe nach durch. ⏸ markiert ein Gate: anhalten, das Ergebnis zeigen und auf die Antwort des Benutzers warten. Sagen Sie an jedem Gate, welcher Schritt als Nächstes kommt. Lesen Sie nur die Dateien, die der aktuelle Schritt auflistet.
SKILL_DIR="<Basisverzeichnis dieser Skill>"; ENGINE="$SKILL_DIR/engine"
KIT="$SKILL_DIR/kit"; [ -d "$KIT/node_modules/playwright" ] || KIT="$HOME/.claude/kit"
PY="$KIT/.venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$KIT/.venv/bin/python"
[ -d "$ENGINE/node_modules/three" ] && [ -x "$PY" ] || bash "$SKILL_DIR/setup.sh"
Erfordert Node 18+, ffmpeg und Python 3.9+. bash "$SKILL_DIR/setup.sh" installiert den Rest einmalig (three.js, Playwright + Chromium, eine Python-Venv mit dem Parakeet-Wortzeitsteuerungsmodell). Führen Sie jedes Python-Tool unten mit "$PY" aus.
Das Referenzprofil ist der Maßstab für jedes Gate.
PROFILE="$SKILL_DIR/story/examples/dashcam"enthält die gemessenen Zahlen (profile.json), einen Frame pro Einstellung (frames/) und jeden Frame jedes Übergangs (transitions/).- Wenn der Benutzer eine neue Referenz mitbringt, erstellen Sie zuerst ihr Profil („Lernen von einer neuen Referenz“ unten) und zeigen Sie mit
PROFILEdarauf. - Frames sind nicht im öffentlichen Repository enthalten.
story/examples/dashcam/undstory/examples/cashier/enthalten die gemessenen Zahlen (profile.json) und die geschriebenen Beat-Sheets, aber nicht die Frames der Referenz (sie gehören zum ursprünglichen Kanal). Wenn$PROFILE/framesfehlt, fragen Sie den Benutzer nach dem Referenzvideo (jeder Short in diesem Format funktioniert) und führen Sie Schritt 2 von „Lernen von einer neuen Referenz“ mit$PROFILEals Ausgabeordner vor Schritt 4 aus. Wenn der Benutzer kein Referenzvideo hat, beurteilen Sie nur anhand vonprofile.jsonund den geschriebenen Beispielen und sagen Sie dies an jedem Gate. - Beurteilen Sie niemals nur unsere Frames: Jeder Review-Bogen stellt die Referenz neben unsere.
Schritt 1 · Thema ⏸
Lesen Sie story/topic-bank.md. Verwenden Sie das Thema des Benutzers oder bieten Sie drei an. Führen Sie den Vier-Fragen-Test durch und nennen Sie die schwächste Prüfung.
Gate: Der Benutzer wählt ein Thema.
Schritt 2 · Titel und Skript ⏸
Lesen Sie story/title-formula.md, story/formula.md, story/hook-rules.md, story/script-template.md, story/script-check.md.
Lesen Sie auch story/rig-check.md (was unsere flachen Charaktere können und nicht können) und führen Sie "$PY" "$SKILL_DIR/tools/rig_check.py" <projekt>/script.json
vor der Bewertung aus; zeigen Sie jedes Flag mit dem Hinweis „Bühnen Sie es als“ an. Eine Zeile, die das Rig nicht zeigen kann, muss vor der Sprachaufnahme korrigiert werden.
Schreiben Sie zuerst den Titel, dann das Skript Beat für Beat. Bewerten Sie es (bei unter 9/10 umschreiben).
Zeigen Sie den Titel, das Skript (ein Satz pro Zeile, Beat-Bezeichnungen am Rand), die Wortanzahl, die geschätzte Länge bei 3,8 Wörtern pro Sekunde und die Bewertung.
Gate: Der Benutzer genehmigt oder bearbeitet. Speichern Sie die genehmigten Sätze als <projekt>/script.json
(erstellen Sie das Projekt mit cp -r "$ENGINE/template" <projekt> zuerst; <projekt> darf nicht existieren).
Schritt 3 · Visuelle Bibel ⏸
Lesen Sie look/style-guide.md (der Haus-Look: glänzende lackierte Oberflächen, Tinte auf alles im Fokus, natürliches Licht, leicht unscharfe Hintergründe, dichte Einrichtung) und look/visual-bible.md (Regeln und Vorlage).
Generieren Sie zuerst die Looks: node "$ENGINE/cast.mjs" new <projekt> --chars <rollen> --cars <rollen>. Schreiben Sie dann
<projekt>/visual_bible.md mit:
- jedem Charakter (Bau, Kopf und Haare, Outfit-Schichten in Hex, Accessoires, die Gesichter, die die Geschichte braucht);
- jeder Umgebung (Layout, Oberflächen, sichtbare Lichtquellen, 4 bis 8 Einrichtungsgegenstände pro Wand, genaue Textgags, Tiefe);
- den Innenräumen (Autos, Kabinen, Bildschirme), den Requisiten (die Helden-Erfindung vollständig) und den 2D-Grafiken;
- einem Asset-Plan, der jedes Element als
library + params,library + new textodernewmarkiert. Zeigen Sie die Bibel mit der Cast-Ausgabe. Gate: Der Benutzer genehmigt, bearbeitet oder bittet um einen Neuwurf.
Schritt 4 · Look-Bogen ⏸
Zeigen Sie das visuelle Design, das in 3D vor jedem Storyboard in endgültiger Detailstufe erstellt wurde. Lesen Sie look/setup-types.md.
lookdev.html,lookdev.jsundsets.jskamen mit der Vorlage. Schreiben Sie den geschäftigsten Set der Geschichte insets.js(heroSet()ist das ausgearbeitete Beispiel des Haus-Looks: ersetzen Sie es, behalten Sie seine Schichten), genau der Bibel folgend. Das Video importiert später dasselbesets.js, diese Arbeit wird also nicht weggeworfen.lookdev.jserstellt bereits die Karten:- jeden
cast.json-Charakter, in Dreiergruppen mit Beschriftungen; - die Gesichter des Leads;
- den Helden-Set: weit, mit Lens Blur 10, und eine Requisiten-Nahaufnahme mit Blur 14;
- das Helden-Auto.
Fügen Sie eine Karte für die Helden-Requisite und für jeden anderen Set hinzu, den die Bibel als
newmarkiert.
- jeden
- Eine Karte pro Setup-Typ, den die Geschichte verwendet (
interior,pov,tracking,house,twoshot,talker,device), jede in ihrem echten Set mit ihrer echten Kadrierung gebaut, mit jedem „Muss haben“ auslook/setup-types.md. Die Dashboard-POV, die Talker-Wand und die Device-Ansicht sind die, die übersprungen werden; bauen Sie sie jetzt. - Paaren Sie sie mit der Referenz:
"$PY" "$SKILL_DIR/tools/sbs_sheet.py" <projekt>/review/look_pairs.jpg --ours <karten> --ref <die gleichen Typen aus $PROFILE/frames>. - Fügen Sie einen Streifen von 400-Px-Ausschnitten im Verhältnis 1:1 hinzu (Anzeigen, Wandgags, Karosserie, Straße), damit fehlende Details und Unschärfe sichtbar werden.
node "$ENGINE/film.mjs" check <projekt> 0 <karten> 0.5 --page lookdev.html, beheben Sie jeden FAIL (einschließlichclipped-art: die Haare, der Hut oder die Kopfgrafik eines Charakters, die flach an ihrer Kante abgeschnitten sind), dannnode "$ENGINE/film.mjs" sheet <projekt> <projekt>/review/look.jpg 0.5 1.5 2.5 ... --page lookdev.html --w 360 --cols 4.- Bewerten Sie es im Code:
node "$ENGINE/film.mjs" lookcheck <projekt> <projekt>/review/lookcheck 0.5 1.5 ... --page lookdev.html(Glanz, Konturen, Licht, Tiefe, Dichte, Farbe, Gesichter; 0 bis 10 gegenlook/targets.json). Beheben Sie jedenLOW, dann betrachten Sie den Bogen einmal mit dem Auge, auf Dinge, die Zahlen nicht beurteilen können (Story-Requisiten, Anziehungskraft). Zeigen Sie die Bewertungen mit dem Bogen. Führen Sielookcheckauch bei den Frames jedes Akts in Schritt 8 aus. Übergeben Siereview/look.jpgundreview/look_pairs.jpg. Gate: Der Benutzer genehmigt den Look der Charaktere, der Welt und jedes Setup-Typs oder listet Korrekturen auf. Jeder Set im Video ist bis zu dieser Detailstufe gebaut.
Schritt 5 · Storyboard + Sprachskript ⏸
Zwei Dokumente auf einmal:
- Storyboard
<projekt>/storyboard.md: eine Zeile pro Kamera-Setup (18 bis 21):# | Satz/Sätze | Beat | Setup-Typ | Kamerabewegung | Aktion und Gesichter | Requisitengag | Übergang hinein (Frames) | Akt/Stimmung. Regeln ausstory/formula.md(„Bild und Schnitt“);story/examples/dashcam.mdzeigt ein vollständiges.- Setup-Typ ist einer der Namen in
look/setup-types.md; er wird dertypedes Shots im Code. - Aktion und Gesichter nennt eine Engine-Pose (
stand,walk,sitOn,point,lean,armTo…) oder eine Requisite für jede Aktion; alles andere schlägt instory/rig-check.mdfehl und wird vor dem Bauen umgeschrieben. - Kamerabewegung: jede Zeile nennt ihre Bewegung und Geschwindigkeit (z. B. „Push-In 6%/s“, „Pull-Back to wide“, „Orbit 120°“); nur die Device-Ansicht darf „locked“ sagen.
- Übergang hinein: Überblendungen sind 7 bis 10 Frames (bis zu 16 für die Enthüllung), oder nennen Sie den In-World-Übergang. Sets, Charaktere und Requisiten stammen aus der genehmigten visuellen Bibel: nennen Sie sie wie die Bibel. Unterhalb der Tabelle kopieren Sie den Asset-Plan der Bibel mit allem, was das Storyboard hinzugefügt hat.
- Kontinuitätstabelle (unter dem Storyboard): jede Requisite oder jeder Charakter, der den Ort oder Zustand wechselt, erhält eine Zeile,
ding: zustand → zustand → zustand, mit der Setup-Nummer jeder Änderung (z. B.schlüssel: tasche (1) → boden (3) → hundemaul (5)).- Jede Änderung geschieht auf dem Bildschirm in einem benannten Setup oder wird durch eine On-Screen-Aktion gezeigt, die der Betrachter lesen kann (sie wird geworfen, sie landet, sie wird übergeben).
- Kein Setup darf mit einem Zustand beginnen, den der Betrachter nie gesehen hat. Eine spätere Aktion, die von einer unsichtbaren Änderung abhängt (Suche nach etwas, das niemand fallen sah), ist ein Storyboard-Fehler: fügen Sie die Aktion zu einem Setup hinzu oder fügen Sie ein Setup hinzu. Über einen erzählten Zeitsprung hinweg sind gewöhnliche Off-Screen-Schritte erlaubt (ein Ticket aus seinem Versteck nehmen).
- Kennzeichnen Sie jede Requisite als Story-Objekt (reist mit der Handlung) oder Gag-Requisite (ein Versteck, Behälter oder Witz-Objekt, das in seinem eigenen Beat bleibt). Eine Gag-Requisite an einem neuen Ort schlägt fehl, es sei denn, die Erzählung nennt sie dort.
- Unter der Tabelle eine Tragezeile pro Ort: wer dort ist, was jeder trägt und warum.
- Realitätscheck (
story/rig-check.md, letzter Abschnitt): jede Aktion und jeder getragene Gegenstand hat einen Grund, den eine reale Person in diesem Moment hätte. Wenn der einzige Grund die Kontinuität ist, schreiben Sie die Zeile um.
- Setup-Typ ist einer der Namen in
- Sprachskript
<projekt>/voice/cartesia.md: lesen Siestory/voice-cartesia.mdund schreiben Sie die getaggten Blöcke (Emotion pro Block, Geschwindigkeitshinweis, Pausen nur vor den „Aber“-Wendungen und dem Merksatz).
Zeigen Sie beide. Gate: Der Benutzer genehmigt das Storyboard. Dann fragen Sie nach der Stimme: „Generieren Sie die Blöcke in
voice/cartesia.md in Cartesia und legen Sie die Dateien in <projekt>/audio/ ab (vo_01.wav, vo_02.wav... oder eine vo.wav).
Ich baue inzwischen die 5-Sekunden-Vorschau.“ Warten Sie nicht auf das Audio, um mit Schritt 6 fortzufahren.
Schritt 6 · 5-Sekunden-Vorschau ⏸
Bauen Sie nur den Hook (die ersten 5 s, normalerweise Setups 1 bis 3), damit der Benutzer den Look vor dem langen Bau beurteilen kann.
Lesen Sie engine/API.md; kopieren Sie Blöcke aus engine/template/video.js (öffnen Sie niemals engine/src). Bauen Sie jeden Charakter
und jedes Auto aus cast.json (makeChar(CAST.characters.x), buildCar(CAST.cars.x)) und verwenden Sie stand/sit-Posen.
- Timing:
sentenceStarts/captionsFromWordsmit der Schätzung (estimateWords) oder der echten Wortdatei, wenn das Audio bereits angekommen ist (Schritt 7). - Importieren Sie die Sets aus
./sets.jsund verwenden SiemakeStage({ mood: withLook(mood, 'indoor' | 'outdoor') }). - Der Look, der beurteilt werden soll, ist der genehmigte Look-Bogen: sauberes 3D mit glänzenden Oberflächen, Tinte auf alles im Fokus,
natürliches Licht, ein leicht unscharfer Hintergrund und jeder Frame randgefüllt. Wenn ein Gesicht leer ist oder den Hinterkopf zeigt,
wurde die Kamera nach der Pose platziert (siehe
engine/API.md, chars.js). - Geben Sie jedem Gesicht ein
markund jedem Shot seinentype. Führen Sienode "$ENGINE/film.mjs" check <projekt> 0 5 0.25aus; es beendet sich mit 1 bei jedem FAIL, also beheben Sie alle. - Ein Bogen:
node "$ENGINE/film.mjs" sheet <projekt> <projekt>/review/preview.jpg 0.2 0.8 1.6 2.6 3.6 4.6 --w 180 --cols 6. Betrachten Sie ihn einmal; beheben Sie, was offensichtlich falsch ist. - Rendern:
node "$ENGINE/film.mjs" render <projekt> <projekt>/review/preview.mp4 0 5(etwa 1 Minute). Wenn die Stimme da ist, fügen Sie die ersten 5 s davon hinzu:ffmpeg -i review/preview.mp4 -i audio/vo.wav -map 0:v -map 1:a -c:v copy -t 5 review/preview_vo.mp4. - Vergleichen Sie den Hook mit dem Hook der Referenz:
"$PY" "$SKILL_DIR/tools/compare_video.py" <projekt>/review/preview.mp4 "$PROFILE" <projekt>/review/cmp_preview --range 0 5;- legen Sie unseren Ausflugstreifen neben
$PROFILE/transitions/(der Ausflug passiert das Glas in etwa 4 Frames und landet auf einer Totalen). Beheben Sie FAILs in Bewegung, Schärfe und Detail, bevor Sie die Vorschau zeigen. Übergeben Sie den mp4-Pfad und den Paar-Bogen. Gate: Der Benutzer genehmigt den Look (Charaktere, Farben, Kamera, Untertitel) oder bittet um Änderungen. Änderungen an Charakteren oder Stil sind hier billig und später teuer.
Schritt 7 · Stimme rein
Wenn der Benutzer sagt, das Audio sei in <projekt>/audio/: befolgen Sie „Wenn das Audio ankommt“ in story/voice-cartesia.md
(Blöcke zusammenfügen, words.py, Länge und Tempo prüfen).
- Das Tempo ist ein hartes Gate: außerhalb von 3,5 bis 4,1 Wörtern pro Sekunde (
film.mjs checklässt es durchfallen), bitten Sie um eine neue Aufnahme mit einer anderen Geschwindigkeit und bauen Sie nicht auf der langsamen auf. Das letzte Video lief bei 3,4 und dauerte 71 s gegenüber 62 der Referenz. - Ansonsten fortfahren: der Schnitt basiert auf Satznummern, er passt sich also selbst neu ein. Wenn die Stimme bis zum Ende von Schritt 8 nicht angekommen ist, fragen Sie erneut; rendern Sie das Finale nicht ohne sie.
Schritt 8 · Den Rest bauen, Akt für Akt
Für jeden Akt (1 Tag, 2 Abend/Dämmerung, 3 Regen), der Reihe nach:
- Neue Sets und Requisiten zuerst, in
sets.js, gebaut bis zur Detailstufe des genehmigten Look-Bogens und der Bibel (siehe „Noch nicht gebaut“ inengine/API.md). - Shot-Blöcke für jedes Setup im Akt, jeweils mit seinem
type, Übergängen wie im Storyboard angegeben (dissolvevon 7 bis 10 Frames,burstmitcashBurst()/paperBurst(), ein Wipe oder ein harter Schnitt). film.mjs checkfür den Zeitbereich des Akts muss mit 0 enden (kein FAIL). Die FAILs, die am wichtigsten sind:- eine Kamera, die langsamer ist als das
slow-camera-Limit (ein Push-In sollte 6 bis 10 % pro Sekunde zoomen); - ein Heldengesicht außerhalb des Größenbereichs seines Typs;
- eine Überblendung außerhalb von 5 bis 12 Frames;
- ein Etikett, das vom Objekt, an dem es befestigt ist, herunterhängt (
decal-overhang): registrieren Sie Aufkleber und Etiketten miton: <oberfläche>; - Schlüsseltext, der vom Bildrand abgeschnitten, von einem Kopf verdeckt oder versteckt ist (
text-cut). Registrieren Sie jede Zahl, jeden Preis, jeden Bildschirm und jedes Etikett, von dem der Witz abhängt, mitreadable(mesh, label, { key: true }), wenn der Set oder Shot gebaut wird.
- eine Kamera, die langsamer ist als das
- Paar-Bogen des Akts: unsere Setup-Mitten in der unteren Reihe, die Setups der Referenz derselben Beats oben
(
tools/sbs_sheet.py, Frames aus$PROFILE/frames). Fügen Sie einen Streifen von 400-Px-Ausschnitten im Verhältnis 1:1 aus dem Akt hinzu. - Übergangsprüfung: rendern Sie jeden Übergang im Akt als kurzen Clip (
film.mjs renderüber etwa 1 s um ihn herum). Erstellen Sie einen Frame-für-Frame-Streifen und legen Sie ihn neben den Referenzübergang derselben Art in$PROFILE/transitions/. Prüfen Sie, dass:- Schnitte sich in einem sauberen Frame ändern;
- Überblendungen einer erleichterten Kurve folgen, während beide Shots sich weiterbewegen;
- ein Burst nie mehr als etwa zwei Drittel des Frames bedeckt und der nächste Shot darunter einblendet;
- ein Wipe Reveal...
... [für die Übersetzung gekürzt]