remotion-orchestrator — Remotion 技能包入口点
/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 技能包工作流。
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。
发现简报门(turn 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 技能包”、“remotion 包”、“使用 remotion”。
- 命名任何单个技能(例如“使用 remotion-designer 检查此布局”)。
- 提交一个分类为
intent: "video"的简报(通过app/server/brief.py)。
将自由文本的简报转化为结构化的渲染任务和波形计划,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"} ] }
]
}
波次数量纪律
- ≤3 个波次用于输出 <30s
- ≤5 个波次用于输出 ≤120s
- ≤8 个波次用于输出 >120s
过度分解是此纪律防范的失败模式。
合成路由(简报 → 合成 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} 将在 v1.1 中推出 — 回退到 Explainer,使用特定渠道框架”。
品牌解析
匹配关键词 → BrandSlug:
disaster recovery,dr→drnrpg→nrpgrestoreassist,ra,nir→racarsi→carsiccw,carpet cleaners warehouse→ccw
如果简报中提到了多个品牌,要求规划器拆分为 N 个并行任务(每个品牌一个)并发出 N 个波形计划。绝不将品牌混入一个合成中。
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返回它们为 EMPTY。不要试图拉取一个;从原始来源获取值或使用 Canva。 - 如果没有连接图像工具且没有密钥在一次定向检查中可达,停止并一次性询问创始人 — 首先提供 Canva。
- 从渲染的 MP4 中抓取帧(位于
node_modules/@remotion/compositor-*/ffmpeg的捆绑 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 — 每个品牌单一事实来源,由每个为该品牌渲染的项目使用。(根据 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。