导演简报(课程步骤 10)
长片即制作。课程中隔夜影片背后的简报描述的不是一个视频;它们雇佣了一个团队:一个用于检查每个决策的单行梗概、参考、工具和预算、角色圣经、节拍表、屏幕文本规则、门控、评审循环和最终交付物。此技能将用户的想法转化为该简报,并引导整个制作流程通过各个门控。对于不超过约 45 秒且无章节的片段,请改用 /motion-studio:motion-reel(该技能使用相同的阈值将更长的影片移交给此技能)。
参数,仅显示一次:
此技能的文件位于 ${CLAUDE_SKILL_DIR}(简报模板是${CLAUDE_SKILL_DIR}/assets/brief-template.md,assets/brief-template.md)。
此技能的成本
它以 max 级别的算力运行:这是 motion-studio 所有技能中最深的推理和最高的令牌使用量。规划错误会在数小时的自主工作中累积放大,因此规划就是耗费这些成本的意义所在。在开始之前应设定用户的预期。课程中报告的数据点:一部隔夜音乐视频运行了约 12 小时,使用了约 80% 的 Max 计划用量,另加 75 美元的图像/视频 API 信用额度;一部 45 秒的手绘短片使用了 163 次模型调用,6270 万令牌(96% 缓存读取),按 API 列表价格计算约 34 美元,耗时约 6.75 小时。保持其他部分更便宜:章节动画师以其自身的算力级别运行(高),而修复和重新渲染是中等算力的工作。如果预算重要,请在计划批准后告知用户使用 /model 降低会话算力级别。
1. 收集输入
只有主会话可以向用户提问(子智能体不能)。如果用户口述了一个长篇简报,则解析它而不是重新询问。否则,一次性在一条消息中询问缺失的信息:
| 输入 | 原因 |
|---|---|
| 单行梗概,以及观众在结尾应感受到什么 | 每个决策都以此为基础进行检查 |
| 时长、格式、发布平台 | 章节数量、渲染时间、安全区域 |
| 参考(视频、帧、图片库、先前项目仓库) | 采用的语法、避免的内容 |
| 音乐:一首曲目(及其许可证)或“合成” | 所有内容锁定的节拍网格 |
| 路由(A 默认;仅当用户指定 Remotion/HyperFrames 时为 B;C 生成-追踪)以及按变量名命名的 API 密钥 | 工具和花费 |
| 预算:模型使用量、付费 API、实际时间 | 何时停止生成 |
| 模式:优先规划或直接执行 | 是否在计划后停止 |
2. 编写 docs/brief.md
- 如果没有
studio.json,首先运行/motion-studio:studio-init(设置--duration、--bpm、--formats)。 - 将
${CLAUDE_SKILL_DIR}/assets/brief-template.md复制到docs/brief.md。用用户的回答填充 A 部分;保持 B 部分不变。 - 更新
studio.json以匹配(标题、时长、fps、bpm、格式、品牌、loop)。 - 优先规划:显示填好的简报并停止,直到用户批准。直接执行:在
docs/decisions.md中记录你为用户做出的每一个决定并继续。
3. 门控 1:计划文档
| 文件 | 内容 | 编写者 |
|---|---|---|
docs/style_guide.md | 调色板、字体、节奏、转场、纹理、禁用外观 | style-analyst 子智能体(参考 /motion-studio:reference-style),或由你编写 |
docs/STORYBOARD.md | 核心理念、演员阵容、整体串联线索、带有定时镜头和转场的章节 | motion-director 子智能体,或由你编写 |
docs/shotlist.md | 节拍网格上的每个镜头(小节)、摄像机、文本、音效 | motion-director |
| 章节计划(在 STORYBOARD 中) | 强拍上的章节边界,每个章节的所有者 | 你 |
在对任何内容进行计时之前,测量或合成音乐(/motion-studio:sound-design):章节和镜头时间应为 grid.bar(n) 值,而非猜测。保持章节时长为 8 到 30 秒,以便一个子智能体可以在一个会话中完成并检查一个章节。motion-director 只编写 docs/**(角色守卫钩子强制执行此规则)。
4. 门控 2:装备和指南
- 在任何章节动画师开始之前,从项目
docs/中的模板编写docs/ANIMATION_GUIDE.md,以便每个章节以相同风格编码:章节如何工作、所有权、布局和保留区域、共享 API、共享元素、带有绘制时间预算的风格规则以及精确的检查命令。 - 在
film/scenes/shared_<name>.js中自行构建共享元素(英雄角色、UI 套件、调色板辅助函数)。章节动画师导入它们但从不编辑。渲染每个元素在所有状态下的静态图像。 - 对每个章节进行桩代码,以便在章节进行过程中影片可以端到端渲染:
// film/scenes/ch03_build.js(由主会话编写的桩代码;章节动画师将替换镜头)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20]; // 来自 docs/STORYBOARD.md 的小节跨度(null = 到结尾)
export default function ch03(ctx) {
const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] }); // 无镜头 = 占位卡片
}
- 一次性地连接
film/film.js。buildFilm接受scenes内的chapter()结果,展平其场景并合并其提示。影片级图层(字幕、章节间转场)放置在工厂函数的overlays: Scene[]中:它们在每个场景之后绘制,按数组顺序,遵循相同的from <= t < to规则(在影片最后一帧包含结尾),且它们从不计为镜头,因此静态标签、评论镜头边界和预览条仅列出章节镜头。章节代码保持不变;不要包装或修补章节draw函数。overlays也接受嵌套数组、null和chapter()结果,因此一个章节可以提供自己的叠加场景。要堆叠普通场景,请为场景指定一个layer编号(默认为 0):场景按(layer, from)顺序绘制。
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';
const CHAPTERS = [ch01, ch02, ch03];
export default defineFilm((ctx) => ({
scenes: CHAPTERS.map((make) => make(ctx)),
overlays: [
scene(0, ctx.dur, 'captions', (g, lt, c) => { /* 影片级字幕:从影片时间 c.t 绘制 */ }),
// 每个需要转场的章节接缝处的一个短场景,从网格计时
scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* 擦除或闪烁 */ }),
],
cues: (grid) => [{ t: grid.bar(0), type: 'hit' }], // 影片级提示;章节提示自动合并
}));
5. 分派章节
为每个章节生成一个 chapter-animator 子智能体(motion-studio:chapter-animator),可并行处理多个。为每个智能体提供以下简报:其文件(film/scenes/chNN_<name>.js)、其跨度(其桩代码中的 BARS 导出,以及用于检查命令的相同以秒为单位的跨度)、其 STORYBOARD 部分,以及“遵循 docs/ANIMATION_GUIDE.md”。角色守卫钩子允许章节动画师仅写入 film/scenes/**(film/scenes/shared_* 除外,章节动画师对其保持只读,而是报告共享文件中的错误)和 out/check/**。每个返回一份报告:构建了什么、检查静态图像、已知问题以及在共享文件中发现的错误。你修复共享文件,重新运行整部影片的检查,并在报告显示问题时重新简报章节。
章节跨度是以小节为单位的,在章节工厂内部使用 ctx.grid 计算,因此连续的章节总是相互衔接并遵循已测量的轨道。镜头时间是取自网格的绝对影片秒数(shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]);每个镜头运行到下一个镜头的 at 时间,其 draw(g, lt, c) 从镜头开始处接收 lt。一个超出其章节跨度的镜头会导致 chapter() 抛出异常并停止加载影片(例如,字面上的 TO = 4 会拒绝一个位于 grid.bar(1) = 4.003 秒的镜头,一旦已测量的轨道将第一个强拍置于 2.0 秒)。
6. 门控 3 到 8
| 门控 | 操作 | 检查 |
|---|---|---|
| 3 静态帧 | node tools/stills.mjs --shots(每个镜头一个静态帧) | 评审轮次(/motion-studio:critique-loop) |
| 4 分镜动画 | npm run animatic(半分辨率,30 fps,无模糊),使用真实或占位轨道 | 节奏:每次阅读都在下一个节拍之前结束 |
| 5 最难示例 | 对最难处理的 2 到 4 秒执行 node tools/render.mjs --from A --to B --out out/check | node tools/critique.mjs --strip-at <t>;确定性;同步 |
| 6 完整通过 | 无剩余占位符(node tools/stills.mjs --shots 中没有以 /placeholder 结尾的镜头标签) | 对整部影片进行评审轮次 |
| 7 润色和声音 | /motion-studio:sound-design:配乐或节拍、提示、音效、配音 | 同步指标、声音轴 |
| 8 最终 | npm run build | 简报 B6 中定义的完成标准 |
长片以可恢复的片段形式渲染:node tools/render.mjs --format all --final --chunk 10 写入 out/<fmt>/.parts/seg_<a>_<b>.mp4,并在中断后重新运行时跳过已完成的片段。在后台运行长时间渲染(使用 Bash 工具的 run_in_background,或轮询日志文件),而不是阻塞会话,且前台等待时间切勿超过约 2 分钟。以 60 fps 和 4 个子帧为三种格式预算约 20 秒的实际时间来渲染每秒影片(一部 2 分钟的影片大约需要 40 分钟渲染);/motion-studio:motion-reel 的管道运行手册包含模式以及所有其他命令的预期时间。章节动画师或任何其他子智能体,在其启动的命令仍在运行时不得返回。
7. 路由 C:生成-追踪(可选)
仅当简报选择路由 C 并列出密钥(按变量名:.env 中的 FAL_KEY、ELEVENLABS_API_KEY)和预算时使用。视频模型提供了很难手工编码的物理效果、时机和面部特征;代码层提供用户拥有的一致外观。观众看到的是代码层。
- 使用用户选择的服务,遵循其自身文档,生成角色表 and 基础镜头。将所有结果保存在
refs/base/下,并附带清单行(服务、模型、提示、种子、成本、许可证)。在达到预算时停止。 - 提取帧以供研究:
node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01。 - 在该时序之上用代码重新绘制每个镜头(查看帧,用弹簧和轨道重建运动)。基础素材在渲染时从不从网络加载;如果某个镜头合成基础帧,请在
setup()中从本地文件加载它。 - 验证同步:相同时间点上代码层和基础帧的静态图像,以及网格上的音频提示。对任何存在漂移的镜头重新运行此步骤。
密钥:绝不打印、回显、记录或粘贴密钥。工具自行读取 .env;在提示和文档中命名变量。
8. 完成标准和报告
简报的 B6 是合同:交付的 MP4 响度为 -14 LUFS ±0.5 且 <= -1 dBTP,至少 3 轮评审,每项指标 >= 8 且无 P0(npm run gate),重新渲染产生相同的帧(评审确定性检查加上两次 --hash 渲染的 framesDigest 值相等),每种格式的精确时长和帧数,以及所有交付物存在(npm run deliver 检查大部分内容并写入 docs/production.json)。以 B7 报告结束:交付物、每轮得分、实际花费、已知缺陷、下次将改进的内容。
鸣谢:简报框架遵循课程的步骤 10;填充/保持原样分割、优先规划与直接执行以及完成标准遵循 @pradeepXkapoor 的一个公共模板模式(已重新措辞);验收门控改编自 athemeroy/awesome-opus-5-5-videos 的 docs/production-brief.md(CC BY 4.0);指南加故事板子智能体模式研究自 JohnHeibel/PDoomVideo(仅为理念,未重复使用文本)。
下一步:从门控 3 开始,每个门控之后运行 /motion-studio:critique-loop,然后运行 /motion-studio:ship-formats 进行交付。