cyxj-remotion-produce

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>                 # 默认从 ./props.json 取该 type 的 props/时长,抽入场/中段/落点 3 帧
npm run qa:still -- <type> --frames=a,b,c  # 覆盖帧号;更多参数见 assets/qa-still.mjs 头注释

• 脚手架(qa-entry)自动建、自动删,产物落 qa-frames/(自动进 .gitignore)。
• 脚本只肯在出片工程根目录跑,在 kit / 仓库根会直接报错退出。
• 为什么必须真渲一帧看:tsc / compositions 全绿也抓不到运行时错;中文尤其要肉眼看(字体没加载好会掉成豆腐块,预览看不出)。

使用姿势

• 用户说「开一条新片」→ 从阶段 0 顺序走;说「渲染 / 出片」→ 从阶段 5 进入,前面阶段只补漏。
• 每进一个阶段,先把该阶段「真源」列里的文件读了再动手;本表只负责「别漏步骤、别乱顺序」。
• 改任何 .tsx / props.json 前,官方三查照走(hook 会提醒)。

私有沉淀说明:作者的完整生产线还包含「上传口播一键成片」的前门、后期(剪辑软件)交接 SOP、字幕修正工具链、几十个品牌镜头——这些是私有资产,本仓不含。本 skill 给的是可复用的流程骨架,鼓励你按同样机制沉淀自己的那几层。