RSS

第 9 章 / 共 9 章

把「需求→成片」固化成你的工作流

约 8 分钟 更新于

前八章,你完成了一条片子。但一条片子的价值是有限的,一套能反复出片的工作流才是资产。本章把散落在各章的方法收拢成六步标准流程,再把它固化到项目里(AGENTS.md 说明文件 + 验收清单 + 模板仓库),让下一次接任务时,你打开的不是空文件夹,而是一条已经校准好的流水线。最后给一张进阶地图,告诉你这套能力还能往哪些方向长。

9.1 端到端六步:从零到成片的标准流程

无论片子多简单或多复杂,把工作拆成下面六步,每一轮只做一步的验收:

  1. 拆需求:把「做个视频」拆成 结构(几个场景)、内容(文案/数据)、规格(画幅/帧率/时长)、交付物(MP4)四件事,写进任务卡;
  2. 写说明:把项目的规矩写进 AGENTS.md(见 9.2),让 Codex 每次开工都带着同一套上下文;
  3. Codex 给计划:先让它说「我打算改哪些文件、怎么做」,你看方向对不对,再放行;
  4. 实现与预览:Codex 逐场景实现,你在 Studio 里按配方卡验收画面(第5章),通过即提交;
  5. 渲染:按第8章先小范围渲染关键段,再全片渲染;
  6. 合规交付:走成片验收清单 + 素材/授权合规两查,最后交付。

这六步的精华在于:第1、2步占用的时间越多,第3-6步返工越少。一份写清了结构与验收标准的说明,抵得上十轮「感觉不对再改改」的对话。判断你的工作流是否成熟,就看一件事:你接到新需求后,是在「拆需求和写说明」上花时间,还是直接在终端里让 Codex 开干——前者是导演,后者是赌徒。

第9章:从需求到成片的标准六步
图 9.1:六步工作流全景。注意箭头是单向前进但每一步都允许「验收失败就退回上一步」。最值得反复看的两处:第2步「写说明」决定了 Codex 的上下文质量,第4、6步的两个验收闸口决定了交付质量。整条流程中,标「人」的环节(拆需求、写说明、两次验收、合规)永远不能外包。

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 进阶地图与官方资源

这套入门能力之上,值得探索的方向按性价比排序如下:

  1. 官方模板与 Agent Skills:šRemotion 官方提供大量可复制的模板,以及专门教智能体遵守最佳实践的 Agent Skills(安装后,Codex 会「知道」如何创建 composition、排版、启动 Studio、渲染等)。你第3章踩过的「AI 凭记忆写错 API」的坑,官方技能正是标准解药——安装与用法以官方文档为准;
  2. 参数化与批量渲染:第6章的「换数据出片」放大到几十上百条,配合批量渲染脚本;若要做到产品级自动化,研究云渲染与按需渲染方案;
  3. 字幕与语音:Remotion 对字幕、语音转写有官方支持,想做「文案转口播视频」类作品时是核心能力;
  4. Player 与交互:把 Remotion 视频作为可交互播放器嵌进网页/应用,适合做「视频简历」「数据报告」等产品形态;
  5. 把工作流包成技能:像第9.2 节一样,把你自己的「出片规矩」整理成 Codex 可安装的技能/说明包,形成个人资产——社区里已经有人把整套 Codex+Remotion 的成片流程(声音优先、素材登记、人工审核门)开源成可复用的生产包,值得对照学习;
  6. 保持跟进:Codex 本身迭代极快(子代理、更细的审批、企业能力都在持续增加),Remotion 同样月月更新。别追每个版本号,每季度读一次双方的官方更新说明即可,教程里的「核对习惯」会一直保护你。

9.5 行动:固化你自己的模板仓库

到此,你走完了从「一句需求」到「一套工作流」的完整旅程。还记得第1章你写下的第一条导演守则吗——你现在可以更新它了:你不仅知道 Codex 负责写、Remotion 负责渲染、验收在你,你还有了让这一切稳定运转的流水线。下次再收到「周四要交一条视频」,你打开模板仓库,拆好需求,写好说明,然后坐下来,像导演一样开始工作。

下一步:别停在这本教程里。用你的模板仓库立刻做一条「不是教程示例」的片子——你自己的产品、你的课程、你的城市。第一条属于自己的片子做完时,把 9.3 的评分表翻出来看看,你会发现,最难的部分已经不是技术,而是你想讲什么故事。那才是真正属于导演的工作。