remotion-orchestrator — Remotion Skills Package 進入點
/remotion-video 一鍵命令
/remotion-video 是 Remotion 行銷影片的一鍵命令通道。它將粗略的簡報轉換為一個受控的生產包裹、一個渲染路徑和一份最終的證據報告。
此命令路徑的嚴格規則:
- 僅限單一語音;不允許多語音演員或每場景語音切換。
- 僅使用現有的 Synthex ElevenLabs 憑證和語音配置。
- 不引入新的供應商、新帳戶或連接平台。
- 除非操作員明確要求生產渲染,否則從乾執行(dry-run)開始。
- 寫入
.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 Skills Package 工作流程。
Remotion Skills Package 的單一進入點 — 一組 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 | 字串 | 一句話說明影片內容。單純「品牌認知影片」會被拒絕 — 必須指出具體要點。 |
audience | 字串 | 若省略,則從 BrandConfig.audience.primary 繼承,但創始人必須確認。 |
可選:school(顏色產生器的視覺學派覆寫)、voiceoverScript(若預先編寫則跳過說書人)、referenceComposition(現有任務用於混音)。
硬停止條件
topic讀起來像分類(「我們的產品」、「上市」)而非具體主張 → 阻擋。- v1 中
composition≠Explainer且未明確確認回退 → 阻擋。 - 一份簡報命名多個品牌 → 分割為 N 個平行任務(每個品牌一個);從不混合品牌。
關卡在波動計劃計算之前執行。被封鎖的簡報永遠不會到達調度器。
喚起方式
使用者可透過以下方式喚起此套件:
- 說出任何下列詞語:「使用 Remotion Skills Package」、「remotion 套件」、「使用 remotion」。
- 命名任何個別技能(例如「使用 remotion-designer 對這個佈局進行 QA」)。
- 提交一個經由
app/server/brief.py分類為intent: "video"的簡報。
將自由文本簡報轉換為結構化的渲染任務和波動計劃,由 Pi-Dev-Ops 協調器(app/server/orchestrator.py)透過 P3-B 扇形展開調度。
Remotion 專案
所有 composition、品牌設定、動作/色彩輔助工具及渲染進入點都位於:
../../remotion-studio/
從任何其他專案工作時,子技能會在讀取或編輯 composition / 品牌檔案前先 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預先解析
輸出
一個波動計劃 JSON,寫入 remotion-studio/.research/wave-plans/{job_id}.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"} ] }
]
}
波動數量紀律
- 輸出 <30s 時 ≤3 個波動
- 輸出 ≤120s 時 ≤5 個波動
- 輸出 >120s 時 ≤8 個波動
過度分解是此規則防止的錯誤模式。
Composition 路由(簡報 → composition id)
| 簡報訊號 | composition |
|---|---|
| "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。其他 composition id 返回:"{Composition} 將在 v1.1 提供 — 回退為 Explainer 並使用頻道特定的框架"。
品牌解析
比對關鍵字 → BrandSlug:
disaster recovery、dr→drnrpg→nrpgrestoreassist、ra、nir→racarsi→carsiccw、carpet cleaners warehouse→ccw
若簡報命名多個品牌,請規劃器分割為 N 個平行任務(每個品牌一個)並發出 N 個波動計劃。從不混合品牌為一個 composition。
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(design_type: your_story用於 9:16,youtube_thumbnail用於 16:9),附上詳細的品牌對齊查詢 — 在查詢中傳遞色板/標題;Canva 能可靠地渲染標題文字。- 下載候選預覽並選取最佳;
create-design-from-candidate→export-design(PNG 格式,指定 WxH,export_quality: pro)。
嚴格規則(從 2026-07-01 的經驗學到):
- 永遠不要尋找圖片生成金鑰。 不要在跨專案/環境中掃描
.env檔案或執行vercel env pull以尋找GEMINI_API_KEY/OPENAI_API_KEY/AI_GATEWAY_API_KEY。自動模式分類器會將其封鎖為憑證探索,並浪費整個會話。 - Vercel 的「敏感」環境變數是唯寫的 —
vercel env pull返回的內容為空。不要嘗試拉取一個;請從原始來源取得值,或使用 Canva。 - 如果沒有連結任何圖片工具,且在一次定向檢查中找不到金鑰,請停止並向創始人詢問一次 — 直接提供 Canva。
- 從渲染的 MP4 中擷取畫格(捆綁的 ffmpeg 位於
node_modules/@remotion/compositor-*/ffmpeg)是離線備援方案。注意:在 macOS 上,將同級目錄中的*.dylib檔案符號連結到目前工作目錄,以便捆綁的 ffprobe/ffmpeg 能正確解析(SIP 會移除DYLD_*環境變數)。
此技能不做的事
- 不編寫 composition — 那是
remotion-composition-builder的工作。 - 不執行
npx remotion render— 那是remotion-render-pipeline的工作。 - 不編輯 BrandConfig 檔案 — 那是
remotion-brand-codify的工作。
它僅負責規劃 + 委派。
每個專案的使用模型
此套件是共享基礎設施;每個呼叫端專案提供自己的執行時期設定和 API 金鑰。
| 關注點 | 位置 |
|---|---|
| 技能定義 | ~/.claude/skills/remotion-*(符號連結 → Pi-Dev-Ops/skills/remotion-*)— 全域可用。 |
| Remotion Node 專案(compositions、品牌設定、渲染進入點) | ../../remotion-studio/ — 單一共享基底。 |
| 品牌設定 | Synthex/packages/brand-config/src/brands/{slug}.ts — 每個品牌單一事實來源,由每個為該品牌渲染的專案使用。(根據 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。