remotion-composition-builder
Die Hände. Liest alles andere, schreibt das TSX.
Auslöser
- Welle 4 eines
remotion-orchestrator-Plans. - Benutzer bittet darum, "eine Komposition für {topic} zu bauen", mit bereits bekannten Brand- und Storyboard-Daten.
Eingaben
Alle aus vorherigen Skill-Outputs desselben Jobs übernommen:
BrandConfig(aussrc/brands/{slug}.ts) — Laufzeit & Verhalten: Stimme, Voiceover, Motion, Zielgruppe, Kanal, verbotene Wörter{slug}.design.md(geladen vialoadDesign(slug)aussrc/brands/loadDesign.ts) — visuelle Tokens: Farbe, Typografie, Abstände, Komponenten, Layout, Elevation- Storyboard-JSON (von
remotion-screen-storyteller) - Layout-Spezifikation (von
remotion-designer) — referenziert design.md-Tokens mit Namen - Motion-Block (Teil von
BrandConfig) - Kanal-Spezifikation / Seitenverhältnis (von
remotion-marketing-strategist)
Siehe src/brands/CONTRACT.md für die vollständige Eigentumsgrenze zwischen BrandConfig und design.md.
Methode
- Komposition lokalisieren — existiert
src/compositions/{Name}.tsx?- Wenn ja → inplace patchen (bestehende API bewahren).
- Wenn nein → neue Datei erstellen, mit
Explainer.tsxals Vorlage.
- Imports verdrahten —
import { brands } from '../brands'für Laufzeit,import { loadDesign, colour, spacing, componentRecipe, typography } from '../design'für visuelle Tokens, Motion-Helfer von../motion. - Schema definieren —
z.objectfür Eingabe-Props, die der Storyboard-Struktur entsprechen. - Szenen komponieren — ein
<Sequence>pro Storyboard-Szene. Jede Szenen-Komponente liestcfg = brands[props.brand](für Motion/Stimme/Voiceover) UNDtokens = loadDesign(props.brand)(für Farbe/Typografie/Abstände/Komponenten-Rezepte), und setzt diese zusammen. VerwendecomponentRecipe(tokens, 'cta-primary')um ein vollständig aufgelöstes, CSS-bereites Objekt zu erhalten, anstatt Hex-Codes inline zu setzen. - Audio —
<Audio src={staticFile(scene.voiceoverAudioPath)} />pro Szene einbinden, wenn Pfad gesetzt ist. - In Root registrieren —
<Composition id="{Name}" ... />insrc/Root.tsxhinzufügen oder aktualisieren.durationInFrames = sum(scene.durationSec) * fps. - Dateihygiene — Kompositionsdatei ≤500 Zeilen. Szenen nach
src/compositions/{Name}/scenes/*.tsxauslagern, falls sie darüber hinauswächst. - Typenprüfung —
npx tsc --noEmitausführen. Bei Fehlern korrigieren und einmal wiederholen.
Ausgabe
Bearbeitete Dateien:
src/compositions/{Name}.tsx(oder Szenen-Unterdateien)src/Root.tsx(Registry-Eintrag)
Statusbericht an remotion-orchestrator:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
Grenzen
- Brand-Werte niemals inline setzen (Hex-Codes, Schriftnamen, Abstands-Literale) — immer von
tokens(visuell) odercfg(Laufzeit) lesen. SieheCONTRACT.mdwelche Seite was besitzt. durationInFramesniemals setzen ohne die Summe der Storyboard-Szenen-Dauern × fps.- Niemals
staticFile()für einen Asset-Pfad aufrufen, der nicht existiert — laut scheitern beim Build, nicht still beim Rendern. - Niemals
signatureEntry()für Einstiegs-Motion umgehen — hält Motion-Language konsistent. - Niemals ein Token sowohl in
BrandConfig.tsals auch in{slug}.design.mdduplizieren. Wenn der Wert in.design.mdlebt, darf die.ts-Datei ihn nicht neu deklarieren.
Wiederverwendet
src/compositions/Explainer.tsx— kanonische Vorlagesrc/motion/index.ts—signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts—readableOn,brandGradient,contrastsrc/design/index.ts—loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts— typisierter Lader für{slug}.design.mdsrc/brands/CONTRACT.md—BrandConfig↔design.mdEigentumsgrenze
Übergabe an
remotion-render-pipeline zum tatsächlichen Rendern.