第 9 章 / 共 9 章
把「需求→成片」固化成你的工作流
前八章,你完成了一条片子。但一条片子的价值是有限的,一套能反复出片的工作流才是资产。本章把散落在各章的方法收拢成六步标准流程,再把它固化到项目里(AGENTS.md 说明文件 + 验收清单 + 模板仓库),让下一次接任务时,你打开的不是空文件夹,而是一条已经校准好的流水线。最后给一张进阶地图,告诉你这套能力还能往哪些方向长。
9.1 端到端六步:从零到成片的标准流程
无论片子多简单或多复杂,把工作拆成下面六步,每一轮只做一步的验收:
- 拆需求:把「做个视频」拆成 结构(几个场景)、内容(文案/数据)、规格(画幅/帧率/时长)、交付物(MP4)四件事,写进任务卡;
- 写说明:把项目的规矩写进 AGENTS.md(见 9.2),让 Codex 每次开工都带着同一套上下文;
- Codex 给计划:先让它说「我打算改哪些文件、怎么做」,你看方向对不对,再放行;
- 实现与预览:Codex 逐场景实现,你在 Studio 里按配方卡验收画面(第5章),通过即提交;
- 渲染:按第8章先小范围渲染关键段,再全片渲染;
- 合规交付:走成片验收清单 + 素材/授权合规两查,最后交付。
这六步的精华在于:第1、2步占用的时间越多,第3-6步返工越少。一份写清了结构与验收标准的说明,抵得上十轮「感觉不对再改改」的对话。判断你的工作流是否成熟,就看一件事:你接到新需求后,是在「拆需求和写说明」上花时间,还是直接在终端里让 Codex 开干——前者是导演,后者是赌徒。

9.2 给 Codex 一份「项目说明书」
AGENTS.md 是放在项目根目录的说明文件,Codex 这类编码智能体会在每次开工时自动读取它。把项目里「只有你知道、每次都要提醒」的规矩写进去,你就再也不用在每条任务里重复。下面是一份可以直接套用的模板(改成你自己的项目即可):
项目说明(Codex 每次开工前请先读这里)
这个项目是什么
一个用 Remotion 生成短视频的项目。当前主视频 composition id 是 LaunchVideo,
画幅 1920x1080,30fps,总帧数 540(18 秒)。内容为虚构品牌「山雾乌龙」上新片。
常用命令
- 启动预览:npm run dev(Studio 热更新,改完代码保存即刷新)
- 渲染成片:npx remotion render LaunchVideo out/launch.mp4
- 抽帧检查:npx remotion still LaunchVideo out/frame-030.png --frame=30
- 类型检查:见 package.json scripts(改数据后务必运行)
结构约定
- 内容(文案/数据)放 src/data.ts;版式组件禁止内联业务文案
- 素材放 public/ 下,引用一律用 staticFile(),路径逐字符一致
- 每个场景组件独立文件,时间用 Sequence 切分,动画只依赖帧号
- 禁止:改 src/index.ts 的入口注册;新增依赖前先征得同意
渲染纪律
- 画面必须确定:不依赖系统时钟、真随机、运行时网络
- 动画值与样式只由 useCurrentFrame/interpolate/spring 计算
改动规范
- 先看现状与相关文件,再给实现计划;确认后再动手
- 涉及 Remotion API 拿不准时,先查官方文档(remotion.dev/docs)再写
- 改完报告:改了哪些文件、每处目的、如何在 Studio 验证
验收标准写法
- 每次任务给出可观察的验收点(谁动、何时、停在哪),不要只写「好看」
写完放进项目根目录,让 Codex 读一遍并复述它理解的规矩,确认它「看见」了这份说明。随着项目变大,你还可以加 ROADMAP 之类的计划文件、或把常用子任务做成可复用的技能包——但 AGENTS.md 是最小、最通用的起点。固化工作流,本质就是把你脑子里的规矩,变成 Codex 每次都能读到的文件。
9.3 交付验收清单与自查评分表
把你的工作流「可检查化」:每次交付前,用下表给每个维度打分(0=没做,1=做了但凭感觉,2=做了且有证据)。总分 16 以上,这条片子可以放心交付;低于 12,说明流程某环被跳过了,回到对应章节补上。
| 维度 | 0 分表现 | 2 分表现(合格) | 对应章节 |
|---|---|---|---|
| 需求拆解 | 直接让 Codex「做个视频」 | 任务卡齐全:目标/位置/验收标准/约束 | 第3章 |
| 说明文件 | 每次口头重复规矩 | AGENTS.md 写好且 Codex 会读 | 第9章 |
| 版本管理 | 改坏了只能重来 | git 每轮提交,diff 可回溯 | 第2章 |
| 预览验收 | 「看着能跑就行」 | 对照配方卡逐条验收动画与内容 | 第5、7章 |
| 渲染确定性 | 结果随缘 | 不依赖时钟/随机/网络,两次渲染一致 | 第5、8章 |
| 成片验收 | 能播就算完成 | 关键帧抽帧 + 音画同步抽查 | 第8章 |
| 数据驱动 | 换内容就改代码 | 内容在数据文件,换数据即换片 | 第6章 |
| 合规 | 素材来源不明 | 素材三查 + Remotion 授权场景确认 | 第7、8章 |
9.4 进阶地图与官方资源
这套入门能力之上,值得探索的方向按性价比排序如下:
- 官方模板与 Agent Skills:Remotion 官方提供大量可复制的模板,以及专门教智能体遵守最佳实践的 Agent Skills(安装后,Codex 会「知道」如何创建 composition、排版、启动 Studio、渲染等)。你第3章踩过的「AI 凭记忆写错 API」的坑,官方技能正是标准解药——安装与用法以官方文档为准;
- 参数化与批量渲染:第6章的「换数据出片」放大到几十上百条,配合批量渲染脚本;若要做到产品级自动化,研究云渲染与按需渲染方案;
- 字幕与语音:Remotion 对字幕、语音转写有官方支持,想做「文案转口播视频」类作品时是核心能力;
- Player 与交互:把 Remotion 视频作为可交互播放器嵌进网页/应用,适合做「视频简历」「数据报告」等产品形态;
- 把工作流包成技能:像第9.2 节一样,把你自己的「出片规矩」整理成 Codex 可安装的技能/说明包,形成个人资产——社区里已经有人把整套 Codex+Remotion 的成片流程(声音优先、素材登记、人工审核门)开源成可复用的生产包,值得对照学习;
- 保持跟进:Codex 本身迭代极快(子代理、更细的审批、企业能力都在持续增加),Remotion 同样月月更新。别追每个版本号,每季度读一次双方的官方更新说明即可,教程里的「核对习惯」会一直保护你。
9.5 行动:固化你自己的模板仓库
到此,你走完了从「一句需求」到「一套工作流」的完整旅程。还记得第1章你写下的第一条导演守则吗——你现在可以更新它了:你不仅知道 Codex 负责写、Remotion 负责渲染、验收在你,你还有了让这一切稳定运转的流水线。下次再收到「周四要交一条视频」,你打开模板仓库,拆好需求,写好说明,然后坐下来,像导演一样开始工作。
下一步:别停在这本教程里。用你的模板仓库立刻做一条「不是教程示例」的片子——你自己的产品、你的课程、你的城市。第一条属于自己的片子做完时,把 9.3 的评分表翻出来看看,你会发现,最难的部分已经不是技术,而是你想讲什么故事。那才是真正属于导演的工作。