remotion-composition-builder
実際に手を動かす部分です。他のすべてを読み取り、TSXを書き出します。
トリガー
remotion-orchestrator計画のWave 4。- ユーザーが「{topic}のコンポジションを作成して」と依頼し、ブランドとストーリーボードが既にわかっている場合。
入力
同じジョブ内の以前のスキル出力からすべて取得:
BrandConfig(src/brands/{slug}.tsから)— ランタイムと動作: 音声、ナレーション、モーション、オーディエンス、チャンネル、禁止ワード{slug}.design.md(src/brands/loadDesign.tsのloadDesign(slug)で読み込み)— ビジュアルトークン: 色、タイポグラフィ、スペーシング、コンポーネント、レイアウト、エレベーション- ストーリーボードJSON(
remotion-screen-storytellerから) - レイアウト仕様(
remotion-designerから)— design.mdのトークンを名前で参照 - モーションブロック(
BrandConfigの一部) - チャンネル仕様/アスペクト比(
remotion-marketing-strategistから)
BrandConfig と design.md の完全な所有権の境界については src/brands/CONTRACT.md を参照してください。
方法
- コンポジションを特定 —
src/compositions/{Name}.tsxは存在するか?- はい → そのままパッチ(既存のAPIを維持)。
- いいえ →
Explainer.tsxをテンプレートとして新しいファイルを作成。
- インポートを接続 — ランタイム用に
import { brands } from '../brands'、ビジュアルトークン用にimport { loadDesign, colour, spacing, componentRecipe, typography } from '../design'、モーションヘルパー用に../motionからインポート。 - スキーマを定義 — ストーリーボードの形状に一致する入力プロパティ用の
z.object。 - シーンを構成 — ストーリーボードの各シーンに1つの
<Sequence>。各シーンコンポーネントはcfg = brands[props.brand](モーション/音声/ナレーション用)およびtokens = loadDesign(props.brand)(色/タイポグラフィ/スペーシング/コンポーネントレシピ用)を読み取り、それらを合成します。componentRecipe(tokens, 'cta-primary')を使用して、16進数をインライン化する代わりに、完全に解決されたCSS対応オブジェクトを取得します。 - オーディオ — 各シーンにパスが設定されている場合、
<Audio src={staticFile(scene.voiceoverAudioPath)} />を配線します。 - Rootに登録 —
src/Root.tsxに<Composition id="{Name}" ... />を追加または更新。durationInFrames = sum(scene.durationSec) * fps。 - ファイルの衛生管理 — コンポジションファイルは500行以下に。それを超えた場合はシーンを
src/compositions/{Name}/scenes/*.tsxに抽出。 - 型チェック —
npx tsc --noEmitを実行。エラーがあれば修正して1回再試行。
出力
編集されたファイル:
src/compositions/{Name}.tsx(またはシーンサブファイル)src/Root.tsx(登録エントリ)
remotion-orchestrator へのステータスレポート:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
境界
- ブランド値を決してインライン化しない(16進コード、フォント名、スペーシングリテラル)— 常に
tokens(ビジュアル)またはcfg(ランタイム)から読み取る。どちらが何を所有するかはCONTRACT.mdを参照。 durationInFramesをストーリーボードのシーン継続時間 × fps の合計なしに設定しない。- 存在しないアセットパスに対して
staticFile()を使用しない — レンダリング時に沈黙するのではなく、ビルド時に大きなエラーを出す。 - エントリモーションに
signatureEntry()を使用しないことを迂回しない — モーション言語の一貫性を保つ。 BrandConfig.tsと{slug}.design.mdの間でトークンを重複させない。値が.design.mdにある場合、.tsで再宣言してはならない。
再利用されるもの
src/compositions/Explainer.tsx— 標準テンプレートsrc/motion/index.ts—signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts—readableOn,brandGradient,contrastsrc/design/index.ts—loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts—{slug}.design.mdの型付きローダーsrc/brands/CONTRACT.md—BrandConfig↔design.mdの所有権境界
引き継ぎ先
remotion-render-pipeline が実際にレンダリングを行います。