| name | cyxj-remotion-produce |
| description | Remotion 出片流程编排器。从「要做一条视频」到「成片交付」的 8 阶段顺序:判型→起手→初始化三查→装配→字幕→QA 闸门→渲染交接→收工。用户说"做一条新视频 / 开一条新片 / 开新片 / 出片 / 渲染 / 渲全片"时使用。只管流程顺序与判断点,每步规则真源另有其主;叠加官方 Remotion skill 与 cyxj-remotion-overlay(管一段画面怎么做),不替代任何一个。 |
cyxj-remotion-produce — 出片流程编排器
分工:本 skill 管「一条片子从头到尾的顺序」;「某一段画面怎么做」→ cyxj-remotion-overlay;「做完把学到的回写规则」→ cyxj-remotion-evolve。三者构成 produce(流程)→ overlay(画面)→ sedimentation(沉淀)闭环,互相指认、不合并。
单一真源纪律:本文件只放阶段顺序 + 判断点 + 指针,不抄任何规则原文(clamp 怎么写、禁什么动画……一律去指针指向的真源读)。真源变了,本文件不用跟着改。
8 阶段编排表
| 阶段 | 做什么 | 判断点 | 真源 |
|---|
| 0 判型 | 定这条片走哪条生产路 | 纯 Remotion 一把成片,还是 Remotion 出图形层 + 后期(剪辑软件)精剪叠层 | 你自己的后期 SOP(本仓不含) |
| 1 起手 | 定起点工程 | 像某个现成项目 → 抄它;否则复制 template/ 开新工程 | template/CLAUDE.md |
| 2 初始化三查 | 新工程落地后逐项核对 | 依赖钉死不带 ^?跨仓 alias CROSS_REPO_PKGS 配了(template/remotion.config.ts)?zod schema 内联在出片层 src/Root.tsx? | docs/HARD_RULES.md §7 / §10 / §9 |
| 3 装配 | 拼 props.json 时间轴 | 用注册表选镜头 type(清单以注册表为准,勿写死);每一段画面怎么做(原生造还是复用)→ 整体委托 overlay skill | kit/scenes/sceneMap.ts + cyxj-remotion-overlay |
| 4 字幕 | 按判型走字幕链路 | A 路:Whisper 转写 → 字幕修正 → parseSrt 进片(<SrtCaptions>);B 路:字幕归后期,Remotion 不烧字幕 | 你自己的字幕 SOP(本仓给了 <SrtCaptions> 组件) |
| 5 QA 闸门 | 渲全片前的自检 | ① 新/大改镜头逐个 npm run qa:still -- <type>(见下);② 验收清单逐项勾;③ 用 remotion-rule-reviewer 语义审放行 | assets/qa-still.mjs |
| 6 渲染交接 | 出成品并交接 | 4K 决策:图形主导 → 1080 合成 + --scale=2;实拍铺满 → 原生 4K 工程。R3F 场景渲染带 --gl=angle | docs/HARD_RULES.md §10 |
| 7 收工 | 沉淀与进化 | 工程内组件要不要晋升进 kit?本次学到的要不要回写规则?(收工进化闸 hook 会兜底提醒) | kit/CLAUDE.md 组件晋升节 + cyxj-remotion-evolve |
QA 抽帧一键化(阶段 5 的工具)
在出片工程根目录跑(如 template/;工程 package.json 已接 qa:still 入口):
npm run qa:still -- <type>
npm run qa:still -- <type> --frames=a,b,c
- 脚手架(qa-entry)自动建、自动删,产物落
qa-frames/(自动进 .gitignore)。
- 脚本只肯在出片工程根目录跑,在 kit / 仓库根会直接报错退出。
- 为什么必须真渲一帧看:tsc / compositions 全绿也抓不到运行时错;中文尤其要肉眼看(字体没加载好会掉成豆腐块,预览看不出)。
使用姿势
- 用户说「开一条新片」→ 从阶段 0 顺序走;说「渲染 / 出片」→ 从阶段 5 进入,前面阶段只补漏。
- 每进一个阶段,先把该阶段「真源」列里的文件读了再动手;本表只负责「别漏步骤、别乱顺序」。
- 改任何
.tsx / props.json 前,官方三查照走(hook 会提醒)。
私有沉淀说明:作者的完整生产线还包含「上传口播一键成片」的前门、后期(剪辑软件)交接 SOP、字幕修正工具链、几十个品牌镜头——这些是私有资产,本仓不含。本 skill 给的是可复用的流程骨架,鼓励你按同样机制沉淀自己的那几层。
