remotion-render-pipeline
コンポジションを納品可能なMP4に変換します。
トリガー
remotion-composition-builderがready: trueを報告した場合- ユーザーが既知のジョブに対して「レンダリングして」「送信して」と言った場合
入力
jobIdcomposition—src/Root.tsxに一致するID(例:Explainer)outputPath—remotion-studio/output/からの相対パスprops— 完全な入力プロパティ(ブランド+ストーリーボード+...)をJSONでlinear—{teamId, projectId}チケットルーティング用
方法
- プリフライト型チェック —
cd remotion-studio && npx tsc --noEmitを実行。エラーが出た場合、そのエラーをremotion-composition-builderに返します。 - 音声合成 —
render/voiceover.tsがシーンごとにMP3をpublic/audio/{jobId}/scene-N.mp3に書き込みます(public/下にあるためstaticFile()で解決可能)。キャッシュキーはsha1(voiceId|style|text)を使用します。ELEVENLABS_API_KEYがない場合はスキップされます。その場合でもコンポジションは画面上のテキストのみでレンダリング可能です。 - レンダリング —
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}を実行。600秒のタイムアウトでラップし、ハングアップ/クラッシュ時には1回再試行します。 - 検証 — ファイルが存在すること、期間が期待値±0.5秒以内、コーデックが
h264、解像度がコンポジションと一致、サイズが100MB未満であることを確認します。 - 配信:
- Supabaseバケット
remotion-rendersにアップロード — 署名付きURL、90日保持。 app.server.telegram_video.send_telegram_video()(共有ユーティリティ)経由でTelegramに送信。ファイルが45MBを超える場合は、インラインアップロードではなく署名付きURLのリンクを送信します(Telegramの上限は50MB)。- Linearチケットを
{teamId}/{projectId}に作成:レンダリングURL、ソース概要、BrandConfigバージョン(src/brands/{slug}.tsのgit SHA)、コンポジションファイルのパス。
- Supabaseバケット
- ステータス — サマリーを
.research/renders/{jobId}.jsonに書き込みます。
出力
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
境界
tsc --noEmitが失敗している状態でレンダリングを絶対に実行しないこと — 2〜5分を無駄にして確実に不良出力になります。- レンダリング検証が成功する前にソースPR(コンポジション+ブランド変更)を自動マージしないこと。
[DRAFT]が含まれたレンダリングをブランドバケットにアップロードしないこと — ドラフトはremotion-draftsに送ります。
障害エスカレーション
- タイムアウト/ハングアップ → 強制終了、1回再試行 → 2回目も失敗した場合は、
priority: 2のLinearチケットを作成し、stderrを添付します。 - 検証失敗(期間/コーデックの誤り) →
priority: 3のLinearチケットを作成し、期待値との差分を添付します。 - Telegram送信失敗 →
send_telegram_document()にフォールバックし、.mp4を添付ファイルとして送信します。
再利用
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(共有ユーティリティ)config/harness/projects.json(Linearチーム/プロジェクト解決用)
プロジェクトごとのAPIキー
このスキルは 呼び出し元のプロジェクト内部から(Synthex、Pi-SEO、RestoreAssistなど、任意の場所)呼び出されます。各プロジェクトは自身の .env / .env.local で自身のキーを提供します。スキルは Pi-Dev-Ops からキーを読み取ることはありません。
レンダリング時に必要な(または警告される)環境変数:
ELEVENLABS_API_KEY— 音声合成。欠落 = 画面上のテキストのみでサイレントレンダリング(警告をログに出力し、レンダリングは続行)。TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID— Telegram配信。欠落 = Telegramステップをスキップ(設定されていればMP4はディスク+Supabaseに残ります)。SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— 署名付きURLアップロード。欠落 = Supabaseステップをスキップ。LINEAR_API_KEY— チケット作成。欠落 = Linearステップをスキップ。REMOTION_LICENSE_KEY— Remotionのフェアソースライセンスに基づく商用レンダリングに必須。
プロジェクトシェルからの呼び出しパターン:
cd ~/Pi-CEO/Synthex
source .env.local # プロジェクト自身のキー
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
または、Pi-Dev-Ops オーケストレーターAPIを介して呼び出すこともできます。このAPIはセッション生成時に呼び出し元プロジェクトの環境変数を継承します。
出力規則: MP4をデフォルトで <呼び出し元プロジェクト>/.remotion-renders/(gitignore対象)に書き込みます。これにより各プロジェクトのアーティファクトがそれぞれのツリーに保持されます。--out=... で上書き可能です。