remotion-orchestrator — Remotion スキルパッケージ エントリポイント
/remotion-video ワンショットコマンド
/remotion-video は、Remotion マーケティング動画用のワンショットコマンドレーンです。大まかなブリーフを、1つの管理されたプロダクションパケット、1つのレンダリングパス、そして1つの最終エビデンスレポートに変換します。
このコマンドパスのハードルール:
- 単一音声のみ。複数音声キャストやシーンごとの音声切り替えは禁止。
- 既存の Synthex ElevenLabs 認証情報と音声設定のみを使用。
- 新しいベンダー、新しいアカウント、コネクタプラットフォームは使用不可。
- オペレーターが明示的にプロダクションレンダリングを要求しない限り、ドライランで開始。
.harness/remotion/<jobId>/production-packet.json、script.md、preflight-report.md、render-command.shを書き込む。- 生成されたMP4は絶対にコミットしない。
このコマンドは、remotion-script、remotion-production、remotion-direction、remotion-editing、remotion-integrations、remotion-professionalism を通じてルーティングされ、以下の既存のRemotionスキルパッケージワークフローを維持します。
Remotion スキルパッケージの単一エントリポイント — 10個の兄弟スキル(remotion-orchestrator、remotion-brand-research、remotion-brand-codify、remotion-designer、remotion-colour-family、remotion-motion-language、remotion-screen-storyteller、remotion-marketing-strategist、remotion-composition-builder、remotion-render-pipeline)から構成され、~/.claude/skills/remotion-* にグローバルインストールされています(~/Pi-Dev-Ops/skills/remotion-* へのシンボリックリンク)。Pi-Dev-Ops だけでなく、すべてのプロジェクトで利用可能です。
ディスカバリーブリーフゲート(ターン1、必須)
nexu-io/open-design(Apache-2.0)から採用。ウェーブ計画を出力する前に、ブリーフを確定します。必須フィールドがすべて埋められるまで処理を進めることを拒否します — 曖昧なブリーフは過度に長いウェーブ計画とブランドから外れたレンダリングを生み出します。
必須フィールド
| フィールド | タイプ | 備考 |
|---|---|---|
brand | BrandSlug | src/brands/ で解決できる必要があります。未知の場合は、最初に remotion-brand-research をディスパッチします。 |
composition | Explainer | Intro | SocialAd | NIRReport | ProductDemo | v1 は Explainer をサポート。その他は注意書き付きでフォールバック。 |
channel | linkedin | youtube | instagram | tiktok | training | アスペクト比と尺の制限を決定。 |
aspectRatio | 1920x1080 | 1080x1920 | 1080x1080 | channel から省略された場合はデフォルト値が使用される。 |
durationSec | 15 | 30 | 60 | 90 | 120 | ウェーブ数の上限を決定。 |
topic | string | 動画の内容を一文で。「ブランド認知動画」だけでは拒否 — 具体的なポイントを指定する必要あり。 |
audience | string | 省略された場合は BrandConfig.audience.primary から継承されるが、創業者の確認が必要。 |
オプション: school(カラー生成器のビジュアルスクールオーバーライド)、voiceoverScript(事前作成済みの場合ストーリーテラーをスキップ)、referenceComposition(リミックス元の既存ジョブ)。
ハードストップ条件
topicがカテゴリ(「私たちの製品」「ローンチ」)であり、具体的な主張でない場合 → ブロック。- v1 で
compositionがExplainer以外で、明示的なフォールバック承認がない場合 → ブロック。 - 1つのブリーフに複数のブランドが記載されている場合 → N個の並列ジョブ(ブランドごとに1つ)に分割。決して混合しない。
ゲートは ウェーブ計画が計算される前 に実行されます。ブロックされたブリーフはディスパッチャーに到達しません。
呼び出し方
ユーザーは以下の方法でパッケージを呼び出すことができます:
- 「Remotionスキルパッケージを使って」、「remotionパッケージ」、「remotionを使って」のいずれかを言う。
- 個々のスキル名を指定する(例:「remotion-designerを使ってこのレイアウトをQAして」)。
app/server/brief.pyを介してintent: "video"に分類されるブリーフを送信する。
フリーテキストのブリーフを、構造化されたレンダリングジョブと、Pi-Dev-Ops オーケストレーター(app/server/orchestrator.py)が P3-B ファンアウトでディスパッチするウェーブ計画に変換します。
Remotion プロジェクト
すべてのコンポジション、ブランド設定、モーション/カラーヘルパー、およびレンダリングエントリは、以下にあります:
../../remotion-studio/
他のプロジェクトから作業する場合、サブスキルはブランド/コンポジションファイルを読み取りまたは編集する前に、そのパスに cd します。レンダリングエントリは、remotion-studio 内から npx tsx render/render.ts ... です。
トリガー
ブリーフに以下のいずれかが含まれている場合:video、explainer、promo、ad、reel、intro、outro、cta、social cut、60s/30s/15s、render、marketing video、training video、release video、feature video。かつ、ブランド識別子 dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse のいずれかとペアになっている場合。
入力
Pi-Dev-Ops プランナー(Opus 4.7)は、このスキルを以下のパラメータで呼び出します:
brief— 元のフリーテキストリクエストrepo_url— 通常はlocal:Pi-Dev-Ops/remotion-studiolinear_team_id、linear_project_id—config/harness/projects.jsonから事前解決
出力
remotion-studio/.research/wave-plans/{job_id}.json に書き込まれるウェーブ計画JSON。形状は以下の通り:
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"brand": "ra",
"composition": "Explainer",
"channel": "linkedin",
"durationSec": 60,
"topic": "RestoreAssist NIR Phase 1 standardisation",
"linear": { "teamId": "...", "projectId": "..." },
"outputPath": "output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"waves": [
{ "id": 1, "parallel": [ {"skill":"remotion-brand-research","if":"brands/ra.ts missing or stale"}, {"skill":"remotion-marketing-strategist"} ] },
{ "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplete"}, {"skill":"remotion-motion-language","if":"motion missing"} ] },
{ "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"any new brand artifacts"}, {"skill":"remotion-designer"} ] },
{ "id": 4, "serial": [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
]
}
ウェーブ数規律
- 出力 <30秒の場合 ≤3 ウェーブ
- 出力 ≤120秒の場合 ≤5 ウェーブ
- 出力 >120秒の場合 ≤8 ウェーブ
過剰な分解が、これで防ぐべき障害モードです。
コンポジションルーティング(ブリーフ → コンポジションID)
| ブリーフのシグナル | コンポジション |
|---|---|
| "explainer", "feature video", "how it works" | Explainer |
| "intro", "title card", "channel opener" | Intro (v1.1) |
| "ad", "promo", "reel", "social cut", "Instagram", "TikTok" | SocialAd (v1.1) |
| "NIR report", "inspection report", RA + "report" | NIRReport (v1.1) |
| "demo", "product walkthrough" | ProductDemo (v1.1) |
v1 は Explainer のみをサポートします。その他のコンポジションIDは、"{Composition} is v1.1 — falling back to Explainer with channel-specific framing" を返します。
ブランド解決
キーワードを BrandSlug にマッチング:
disaster recovery,dr→drnrpg→nrpgrestoreassist,ra,nir→racarsi→carsiccw,carpet cleaners warehouse→ccw
ブリーフに複数のブランドが記載されている場合、プランナーに N 個の並列ジョブ(ブランドごとに1つ)に分割し、N 個のウェーブ計画を出力するよう依頼します。ブランドを1つのコンポジションに混合することは決してありません。
Linear ルーティング
レンダリングスキルがMP4を書き込んだ後、このスキル(またはレンダリングスキル)は、config/harness/projects.json からマッピングされたプロジェクトに Linear チケットを開きます:
| ブランド | Linear チーム | プロジェクト |
|---|---|---|
| ra | a8a52f07-63cf-4ece-9ad2-3e3bd3c15673 (RA) | 3c78358a-b558-4029-b47d-367a65beea7b |
| dr / nrpg | 43811130-ac12-47d3-9433-330320a76205 (DR) | d2c1d63b-1e85-424d-9278-efff15b0d46b |
| carsi | 91b3cd04-... (GP) | 実行時に解決 |
| ccw | 実行時 | 実行時 |
サムネイル&静止画生成(Canva ファースト — 認証情報を探し回らないこと)
動画のサムネイル、ポスター、またはその他のマーケティング静止画の場合、信頼できるパスは 接続された Canva MCP です。生の画像生成APIキーではありません:
generate-design(9:16の場合はdesign_type: your_story、16:9の場合はyoutube_thumbnail)を、詳細なブランドに沿ったクエリで実行 — パレット/見出しをクエリに渡します。Canva は見出しテキストを確実にレンダリングします。- 候補のプレビューをダウンロードし、最適なものを選択します。
create-design-from-candidate→export-design(対象のWxHでPNG、export_quality: pro)。
ハードルール(苦労して学んだ教訓、2026-07-01):
- 画像生成キーのために認証情報を探し回らないこと。
.envファイルをスキャンしたり、プロジェクト/環境をまたいでGEMINI_API_KEY/OPENAI_API_KEY/AI_GATEWAY_API_KEYを探すためにvercel env pullを実行したりしないでください。自動モード分類子がそれを認証情報探索としてブロックし、セッション全体を無駄にします。 - Vercel の「機密」環境変数は書き込み専用です —
vercel env pullはそれらを空で返します。プルしようとしないでください。元のソースから値を取得するか、Canva を使用してください。 - 画像ツールが接続されておらず、1回の直接チェックでキーに到達できない場合は、停止して創業者に一度だけ尋ねてください — Canva を最初に提案します。
- レンダリングされたMP4からのフレームグラブ(バンドルされた ffmpeg、
node_modules/@remotion/compositor-*/ffmpegにあり)がオフラインのフォールバックです。注意:macOS では、兄弟の*.dylibファイルを cwd にシンボリックリンクして、バンドルされた ffprobe/ffmpeg が解決されるようにしてください(SIP がDYLD_*を削除するため)。
このスキルが行わないこと
- コンポジションを作成しない — それは
remotion-composition-builderの役割。 npx remotion renderを実行しない — それはremotion-render-pipelineの役割。- BrandConfig ファイルを編集しない — それは
remotion-brand-codifyの役割。
計画と委任のみを行います。
プロジェクトごとの使用モデル
パッケージは共有インフラストラクチャです。各呼び出し元プロジェクトが、独自のランタイム設定とAPIキーを提供します。
| 関心事 | 場所 |
|---|---|
| スキル定義 | ~/.claude/skills/remotion-*(シンボリックリンク → Pi-Dev-Ops/skills/remotion-*)— グローバルに利用可能。 |
| Remotion Node プロジェクト(コンポジション、ブランド設定、レンダリングエントリ) | ../../remotion-studio/ — 単一の共有基盤。 |
| ブランド設定 | Synthex/packages/brand-config/src/brands/{slug}.ts — ブランドごとに1つの信頼できる情報源であり、そのブランドでレンダリングするすべてのプロジェクトで使用されます。(RA-1985 / Synthex SYN-897 に従い、Pi-Dev-Ops/remotion-studio/src/brands/ から移行済み。) |
| APIキー(ElevenLabs、Telegram、Supabase、Linear、Remotion ライセンス) | 呼び出し元プロジェクトの .env / .env.local。スキルはレンダリング時に process.env を読み取ります。 |
| レンダリングされたMP4出力 | デフォルトでは 呼び出し元プロジェクトの .remotion-renders/ ディレクトリ。--out= で上書き可能。 |
プロジェクトに新しいブランドを追加する
あなたのプロジェクト(例:Synthex)が、まだ src/brands/ にないブランドでレンダリングする必要がある場合:
- ブランドの公開ソースに対して
remotion-brand-researchを実行します。 remotion-brand-codifyを実行してSynthex/packages/brand-config/src/brands/{slug}.tsを生成します。Synthex/packages/brand-config/src/types.tsでBrandSlugユニオンを拡張します。Synthex/packages/brand-config/src/brands/index.tsに登録します。Synthex/packages/brand-config/からnpm run typecheckを実行します(その後npm run buildでdist/を再生成します)。
現在登録されているブランド:dr、nrpg、ra、carsi、ccw、synthex、unite。