Regieanweisung (Kursschritt 10)
Lange Filme sind Produktionen. Die Briefings hinter den Übernachtfilmen im Kurs beschreiben kein Video; sie beauftragen ein
Team: eine Logline, an der jede Entscheidung gemessen wird, Referenzen, Werkzeuge und Budget, eine Charakter-Bibel, ein
Beat-Blatt, Text-auf-Bildschirm-Regeln, Gates, eine Kritik-Schleife und Liefergegenstände. Dieses Skill verwandelt die Idee
des Benutzers in dieses Briefing und führt die Produktion durch die Gates. Für Clips bis zu etwa 45 Sekunden ohne Kapitel
verwenden Sie stattdessen /motion-studio:motion-reel (denselben Schwellenwert, den dieses Skill verwendet, um einen
längeren Film an dieses Skill zu übergeben).
Argumente, einmal angezeigt:
Die Dateien dieses Skills befinden sich in ${CLAUDE_SKILL_DIR} (die Briefing-Vorlage ist
${CLAUDE_SKILL_DIR}/assets/brief-template.md, assets/brief-template.md).
Kosten dieses Skills
Es läuft mit der Anstrengung max: der tiefsten Überlegung und der höchsten Token-Nutzung aller motion-studio-Skills.
Planungsfehler summieren sich über Stunden autonomer Arbeit, daher werden die Ausgaben hier sinnvoll investiert. Setzen
Sie Erwartungen mit dem Benutzer, bevor Sie beginnen. Gemeldete Datenpunkte aus dem Kurs: Ein Übernacht-Musikvideo dauerte
etwa 12 Stunden und verbrauchte etwa 80 % des Nutzungskontingents eines Max-Plans plus 75 $ für Bild-/Video-API-Guthaben;
ein 45-Sekunden-Handanimations-Kurzfilm benötigte 163 Modellaufrufe, 62,7 M Token (96 % Cache-Lesevorgänge), etwa 34 $
zu API-Listenpreisen und etwa 6,75 Stunden. Halten Sie den Rest günstiger: Kapitel-Animatoren laufen mit ihrer eigenen
Anstrengung (hoch), und Reparaturen und Neurenderungen sind mittelschwere Arbeit. Sagen Sie dem Benutzer, er solle die
Sitzungsanstrengung mit /model senken, sobald der Plan genehmigt ist, wenn das Budget eine Rolle spielt.
1. Eingaben sammeln
Nur die Hauptsitzung kann dem Benutzer Fragen stellen (Subagenten können das nicht). Wenn der Benutzer ein langes Briefing diktiert hat, parsen Sie es, anstatt erneut zu fragen. Fragen Sie andernfalls einmal, in einer Nachricht, nach dem, was fehlt:
| Eingabe | Warum |
|---|---|
| Logline, und was der Zuschauer am Ende fühlen soll | Jede Entscheidung wird daran gemessen |
| Dauer, Formate, wo es veröffentlicht wird | Kapitelanzahl, Renderzeit, Sicherheitsbereiche |
| Referenzen (Video, Einzelbilder, Bildbibliothek, vorheriges Repository) | Grammatik übernehmen, zu vermeidende Inhalte |
| Musik: ein Track (und seine Lizenz) oder „synthetisieren“ | Das Beat-Raster, an dem sich alles orientiert |
| Route (A Standard; B nur, wenn sie Remotion/HyperFrames nennen; C generate-then-trace) und API-Schlüssel nach Variablennamen | Werkzeuge und Ausgaben |
| Budget: Modellnutzung, kostenpflichtige APIs, Wanduhrzeit | Wann das Generieren beendet werden soll |
| Modus: PLAN FIRST oder GO | Ob nach dem Plan angehalten werden soll |
2. docs/brief.md schreiben
- Wenn es keine
studio.jsongibt, führen Sie zuerst/motion-studio:studio-initaus (setzen Sie--duration,--bpm,--formats). - Kopieren Sie
${CLAUDE_SKILL_DIR}/assets/brief-template.mdnachdocs/brief.md. Füllen Sie Teil A mit den Antworten des Benutzers; lassen Sie Teil B wie er ist. - Aktualisieren Sie
studio.json, um dies abzugleichen (Titel, Dauer, fps, bpm, Formate, Marke,loop). - PLAN FIRST: Zeigen Sie das ausgefüllte Briefing und stoppen Sie, bis der Benutzer zustimmt. GO: Zeichnen Sie jede
Entscheidung, die Sie für den Benutzer getroffen haben, in
docs/decisions.mdauf und fahren Sie fort.
3. Gate 1: Planungsdokumente
| Datei | Inhalt | Wer schreibt sie |
|---|---|---|
docs/style_guide.md | Palette, Typografie, Tempo, Übergänge, Textur, verbotene Looks | style-analyst Subagent aus Referenzen (/motion-studio:reference-style), oder Sie |
docs/STORYBOARD.md | Die Idee, Besetzung, was alles zusammenhält, Kapitel mit zeitlich festgelegten Einstellungen und Übergängen | motion-director Subagent, oder Sie |
docs/shotlist.md | Jede Einstellung auf dem Beat-Raster (Takten), Kamera, Text, Soundeffekte | motion-director |
| Kapitelplan (in STORYBOARD) | Kapitelgrenzen auf Downbeats, Besitzer pro Kapitel | Sie |
Messen oder synthetisieren Sie die Musik, bevor Sie etwas timen (/motion-studio:sound-design): Kapitel- und
Einstellungszeiten sind grid.bar(n)-Werte, keine Schätzungen. Halten Sie Kapitel zwischen 8 und 30 Sekunden, damit ein
Subagent eines in einer Sitzung fertigstellen und überprüfen kann. Der motion-director schreibt nur docs/** (der
Rollen-Guard-Hook erzwingt dies).
4. Gate 2: Rig und Anleitung
- Schreiben Sie
docs/ANIMATION_GUIDE.mdaus der Vorlage imdocs/-Verzeichnis des Projekts, bevor ein Kapitel-Animator beginnt, damit jedes Kapitel im gleichen Stil codiert: wie ein Kapitel funktioniert, Eigentum, Layout und reservierte Bänder, die gemeinsame API, gemeinsame Elemente, Stilregeln mit einem Paint-Time-Budget und genaue Prüfbefehle. - Bauen Sie gemeinsame Elemente (Held-Figur, UI-Kit, Paletten-Helfer) selbst in
film/scenes/shared_<name>.js. Kapitel-Animatoren importieren sie und bearbeiten sie nie. Rendern Sie Standbilder jedes Elements in jedem Zustand. - Stubben Sie jedes Kapitel, damit der Film durchgängig rendert, während die Kapitel bearbeitet werden:
// film/scenes/ch03_build.js (Stub geschrieben von der Hauptsitzung; der Kapitel-Animator ersetzt die Einstellungen)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20]; // Spanne in Takten aus docs/STORYBOARD.md (null = bis zum Ende)
export default function ch03(ctx) {
const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] }); // keine Einstellungen = Platzhalterkarte
}
- Verdrahten Sie
film/film.jseinmal.buildFilmakzeptiertchapter()-Ergebnisse innerhalb vonscenes, glättet deren Szenen und führt deren Cues zusammen. Filmweite Ebenen (Untertitel, Naht-Übergänge) gehen in dieoverlays: Scene[]des Factories: sie malen nach jeder Szene, in Array-Reihenfolge, auf der gleichenfrom <= t < to-Regel (am letzten Frame des Films endinklusive), und sie zählen nie als Einstellungen, daher listen Standbild-Labels, Kritik-Einstellungsgrenzen und die Vorschau-Leiste nur Kapitel-Einstellungen. Der Kapitel-Code bleibt unberührt; wickeln oder patchen Sie keine Kapitel-draw-Funktionen. Verschachtelte Arrays,nullundchapter()-Ergebnisse werden auch inoverlaysakzeptiert, sodass ein Kapitel seine eigenen Overlay-Szenen liefern kann. Um gewöhnliche Szenen zu stapeln, geben Sie einer Szene einelayer-Nummer (Standard 0): Szenen malen nach(layer, from).
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';
const CHAPTERS = [ch01, ch02, ch03];
export default defineFilm((ctx) => ({
scenes: CHAPTERS.map((make) => make(ctx)),
overlays: [
scene(0, ctx.dur, 'captions', (g, lt, c) => { /* filmweite Untertitel: zeichnen von Filmzeit c.t */ }),
// eine kurze Szene pro Kapitelnaht, die einen Übergang benötigt, getimed vom Raster
scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* Wischen oder Blitzen */ }),
],
cues: (grid) => [{ t: grid.bar(0), type: 'hit' }], // Filmebenen-Cues; Kapitel-Cues werden automatisch zusammengeführt
}));
5. Kapitel ausrollen
Starten Sie einen chapter-animator-Subagenten (motion-studio:chapter-animator) pro Kapitel, mehrere parallel.
Briefen Sie jeden ein mit: seiner Datei (film/scenes/chNN_<name>.js), seiner Spanne (dem BARS-Export in seinem
Stub, plus derselben Spanne in Sekunden für die Prüfbefehle), seinem STORYBOARD-Abschnitt und „befolgen Sie
docs/ANIMATION_GUIDE.md“. Der Rollen-Guard-Hook erlaubt einem Kapitel-Animator nur, film/scenes/** zu schreiben
(außer film/scenes/shared_*, die für Kapitel-Animatoren schreibgeschützt bleiben, die stattdessen Fehler in
gemeinsamen Dateien melden) und out/check/**. Jeder gibt einen Bericht zurück: was er gebaut hat,
Überprüfungsstandbilder, bekannte Probleme und Fehler, die er in gemeinsamen Dateien gefunden hat. Sie reparieren
gemeinsame Dateien, führen die filmweiten Prüfungen erneut aus und briefen ein Kapitel neu, wenn sein Bericht ein
Problem zeigt.
Kapitelspannen sind Takte, berechnet mit ctx.grid innerhalb des Kapitel-Factories, sodass aufeinanderfolgende
Kapitel sich immer treffen und einer gemessenen Spur folgen. Einstellungszeiten sind absolute Filmsekunden, die vom
Raster genommen werden (shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]); jede Einstellung läuft bis zum
nächsten at, und ihre draw(g, lt, c) erhält lt ab dem Start der Einstellung. Eine Einstellung außerhalb der
Kapitelspanne lässt chapter() einen Fehler werfen und der Film stoppt das Laden (z. B. lehnt ein wörtliches TO = 4
eine Einstellung bei grid.bar(1) = 4,003 s ab, sobald eine gemessene Spur den ersten Downbeat bei 2,0 s platziert).
6. Gates 3 bis 8
| Gate | Machen | Prüfen |
|---|---|---|
| 3 Standbilder | node tools/stills.mjs --shots (ein Standbild pro Einstellung) | Kritikrunde (/motion-studio:critique-loop) |
| 4 Animatic | npm run animatic (halbe Skalierung, 30 fps, kein Weichzeichner) mit dem echten oder Platzhalter-Track | Tempo: jede Lesung landet vor dem nächsten Beat |
| 5 schwierigstes Sample | node tools/render.mjs --from A --to B --out out/check auf den schwierigsten 2 bis 4 s | node tools/critique.mjs --strip-at <t>; Determinismus; Synchronisation |
| 6 vollständiger Durchlauf | kein Platzhalter mehr vorhanden (kein Einstellungslabel in node tools/stills.mjs --shots endet auf /placeholder) | Kritikrunde auf dem gesamten Film |
| 7 Polieren und Sound | /motion-studio:sound-design: Partitur oder Beats, Cues, Soundeffekte, Stimme | Synchronisationsmetrik, Tonachse |
| 8 Finale | npm run build | Die Definition von „Fertig“ in Briefing B6 |
Lange Filme rendern in fortsetzbaren Segmenten: node tools/render.mjs --format all --final --chunk 10 schreibt
out/<fmt>/.parts/seg_<a>_<b>.mp4 und überspringt fertige Segmente, wenn es nach einer Unterbrechung erneut ausgeführt
wird. Führen Sie lange Renderings im Hintergrund aus (das Bash-Tool run_in_background oder eine Logdatei, die Sie
abfragen), anstatt die Sitzung zu blockieren, und warten Sie im Vordergrund nie länger als etwa 2 Minuten. Kalkulieren
Sie etwa 20 s Wandzeit pro Sekunde Film für drei Formate bei 60 fps und 4 Subframes (ein 2-Minuten-Film entspricht etwa
40 Minuten Rendering); das Pipeline-Runbook von /motion-studio:motion-reel enthält das Muster und die erwartete Zeit
für jeden anderen Befehl. Ein Kapitel-Animator oder ein anderer Subagent darf nicht zurückkehren, während ein von ihm
gestarteter Befehl noch läuft.
7. Route C: generate-then-trace (optional)
Nur wenn das Briefing Route C auswählt und die Schlüssel auflistet (nach Variablennamen: FAL_KEY,
ELEVENLABS_API_KEY in .env) und ein Budget. Videomodelle liefern Physik, Timing und Gesichter, die schwer zu
handcodieren sind; die Code-Ebene liefert ein konsistentes Aussehen, das dem Benutzer gehört. Zuschauer sehen die
Code-Ebene.
- Generieren Sie Charakterblätter und Basis-Einstellungen mit dem vom Benutzer gewählten Dienst, gemäß dessen eigener
Dokumentation. Speichern Sie jedes Ergebnis unter
refs/base/mit einem Manifest-Eintrag (Dienst, Modell, Prompt, Seed, Kosten, Lizenz). Stoppen Sie beim Budget. - Extrahieren Sie Einzelbilder zum Studieren:
node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01. - Zeichnen Sie jede Einstellung in Code auf diesem Timing neu (schauen Sie sich die Einzelbilder an, bauen Sie die
Bewegung mit Federn und Spuren wieder auf). Basis-Filmmaterial wird zur Renderzeit nie aus dem Netzwerk geladen;
wenn eine Einstellung ein Basis-Bild compositet, laden Sie es aus einer lokalen Datei in
setup(). - Überprüfen Sie die Synchronisation: Standbilder der Code-Ebene neben Basis-Einzelbildern zu denselben Zeiten und die Audio-Cues auf dem Raster. Wiederholen Sie den Schritt für jede Einstellung, die driftet.
Schlüssel: niemals drucken, ausgeben, protokollieren oder einfügen. Werkzeuge lesen .env selbst; nennen Sie die
Variable in Eingabeaufforderungen und Dokumenten.
8. Definition von Fertig und Bericht
Das Briefing B6 ist der Vertrag: Lautstärke -14 LUFS +-0,5 und <= -1 dBTP auf der gelieferten MP4, mindestens 3
Kritikrunden mit jeder Achse >= 8 und kein P0 (npm run gate), ein Neurender ergibt identische Einzelbilder
(Kritik-Determinismus-Prüfung plus gleiche framesDigest-Werte von zwei --hash-Renderings), exakte Dauer und
Einzelbilder in jedem Format, und alle Liefergegenstände vorhanden (npm run deliver prüft das meiste und schreibt
docs/production.json). Beenden Sie mit dem B7-Bericht: Liefergegenstände, Bewertungen pro Runde, tatsächliche Ausgaben,
bekannte Mängel, was Sie beim nächsten Mal verbessern würden.
Credits: Das Briefing-Skelett folgt Schritt 10 des Kurses; die Aufteilung Ausfüllen/Unverändert-Lassen, PLAN FIRST vs
GO und eine Definition von Fertig folgen einem öffentlichen Vorlagenmuster von @pradeepXkapoor (umformuliert); die
Abnahmegates sind angepasst von athemeroy/awesome-opus-5-5-videos docs/production-brief.md (CC BY 4.0); das
Guide-plus-Storyboard-Subagenten-Muster wurde in JohnHeibel/PDoomVideo studiert (nur Ideen, kein Text wiederverwendet).
Weiter: /motion-studio:critique-loop nach jedem Gate ab 3, dann /motion-studio:ship-formats zur Auslieferung.