Skill Movie

Skill · 影视制作主流程（总控）

执行卡

• 何时读我：用户要从需求生成完整视频 / 短片 / 预告片 / 广告片，或要在已有项目上继续制作、返工、合成、交付时。
• 我负责：串起主流程，维护唯一状态源，决定什么时候可以进下一环，什么时候必须回流。
• 我不负责：替剧本、编导、提示编译、审查重复写全部专业细则；具体细则回对应阶段规则。
• 输入：用户需求、项目工作目录、script.md、director_plan.json、素材、故事板、生成结果、审查记录。
• 输出：按阶段推进的项目产物、可追踪版本、终版段清单、合成成片和审查结论。
• 失败回流：任何阶段缺关键产物或审查不通过，回到根因环节补齐；不跳闸门、不靠目录扫文件猜状态。

开拍前先过这 12 个闸门

1. 项目必须有落盘的剧本、执行计划和阶段状态源；不能靠聊天摘要或目录猜当前版本。
2. 每段必须有 3×3 九宫格故事板，但故事板只管剧情梗概、事件顺序、情绪 / 信息推进；不代表分镜、人物细节、材质、场景结构或镜头视角。
3. 人物穿过场景、追逐、逃跑、横穿街道、从场景一端到另一端时，必须先有场景左 / 中 / 右视图 + 红线 scene route map；红线只代表路线，不代表镜头视角。
4. 每段视频必须有段内时间轴变化设计：执行计划先粗拆，生成要求再细化；不能只写一串总体动作。
5. 执行计划必须有钉死的调色板和色卡：style_contract.color_palette 写清主 / 辅 / 点缀色、色温、对比度、影调、LUT，色卡登记进资产；每段图和视频生成前都复述同一份颜色，不能只靠一张风格锚点图控色。
6. 主要人物、关键道具、核心场景若有关键视觉状态变化，必须先有状态变体参考图或状态参考组；不能只拿基础参考图靠文字临场改（STATE-1）。
7. 需要观众看清的食材、材质、产品、文字、屏幕、破损或状态证据，必须先有单独关键特写素材；特写要从基础资产 / 状态资产 / 所在场景参考放大而来，不能从全景硬裁，也不能凭空另画导致场景偏移（CU-3）。
8. 涉及吃、喝、拿、夹、舀、切、吸、抿、咀嚼的段落，执行计划和生成要求必须按对象属性写清处理方式；不能把所有东西都手拿、所有饮品都大口喝、所有食物都一口吞（USE-1）。
9. 有食物、液体、热量、重量、湿滑、锋利、燃烧、碰撞的段落，执行计划和生成要求必须写清生活物理与人类本能反应；酱汁会滴、热汤先吹、大块食物分口、液体会晃（PHYS-1）。
10. 每次生成前都要先做调用前自检：能说清本次生成依据、参考素材职责、故事板边界和关键生成设置；自检没明确通过，主流程停。
11. 最终图像 / 视频生成要求必须写满画面细节，并保留执行计划给出的镜头参数、段初段末承接和关键道具持有链。
12. 链式延展必须串行等待上一段过审终版，并把它作为下一段的真实参考依据；不能只用首尾帧文字冒充连续性。

红线速查（主流程层）

主流程层只做闸门，不另起本地编号体系。 需要定位到具体创作硬伤时，回对应阶段规则使用共享故障标签。

---

一、唯一真相源和项目状态

director_plan.json 是全片唯一事实源

长任务上下文会被压缩。 不要另写独立摘要便签来维护半截真相。 回看进度、取台词、取段顺序、取终版文件，一律读 director_plan.json。

director_plan.json 至少维护：

• 一句话故事主线。
• segment 清单、顺序、计划时长、累计时长。
• 每段功能、不可丢信息、逐字台词 / 旁白、画面文字。
• 每段镜头节拍、故事板规划、资产需求、段初承接和段末交接。
• 每段状态：待拍、已生成待审、已过审、需返工。
• 每段终版文件：final_file、版本号、选择理由。
• 关键道具持有链、剪辑决策、音频计划。

素材目录里常有多版本、试验片段、废弃文件。 合成、复审、交付都不能扫目录自动猜。

manifest.json 只管粗粒度阶段状态

每个阶段开始、完成、阻塞、复审失败时，更新 phase： in_progress、done、blocked。

记录关键产物或阻塞点。 如果压缩摘要、工作记忆和落盘文件冲突，以 director_plan.json 和 reviews/ 里的实际文件为准。

落盘纪律（读写项目产物时的实操铁律）

项目里的 script.md、director_plan.json、manifest.json 等产物，读写路径一律用创建项目时返回的绝对路径（project_dir / project_id 解析而来）。

• 不靠相对路径赌当前工作目录：agent 的运行 cwd 不一定是项目目录（常见是临时目录），相对路径 projects/... 会被解析到 cwd 之下而落空或写错地方。要么用绝对路径，要么显式基于项目根拼接，别默认 cwd 就是仓库根。
• 用代码生成项目数据时，写宿主语言的值，不要手敲另一种语言的字面量：比如在 Python 里构造 plan / manifest 这类结构，空值写 None、真假写 True / False，不要照抄 JSON 的 null / true / false——那会直接 NameError 崩掉，产物写不出来。
• 能结构化写盘就别用通用代码手拼再 dump：优先用项目工具直接落盘结构化产物；确需用代码兜底时，先构造好宿主语言的数据对象、再一次性序列化，不在字符串里手拼另一种语言的语法。
• 不在通用代码里裸调 ffmpeg / ffprobe：探视频时长、探音轨、拼接、转场、抽帧这类活，一律走项目的视频 / 音频工具，别在 code_run 里自己 subprocess.run(["ffprobe", ...])。SDK 直接使用 imageio-ffmpeg 自带的 ffmpeg；系统 PATH 上可能既没有 ffmpeg 也没有 ffprobe。要探测或处理媒体就用项目工具，不要赌系统环境。

---

二、完整制作流程

1. 需求进入剧本阶段

剧情类内容开拍前必须有过审剧本。 哪怕用户给了现成剧本，也不能仅凭"文件已存在"直接开拍。

剧本必须落盘为 script.md 或等价文件，包含：

• 人物小传。
• 分场景剧情。
• 逐字台词、旁白、画外音。
• 关键道具、场景、风格方向。

只在状态备注里写"剧本完成"，或剧本只活在聊天上下文里，都不算完成。

2. 进入编导阶段

剧本定稿后，必须产出可执行编导方案。 最低要求：

• 一句话主线和每段如何推进主线。
• 黄金三秒钩子。
• 叙事顺序和结构选择。
• 不可丢信息清单。
• 段间因果链、段初承接、段末交接。
• 镜头节拍表。
• 画面文字计划。
• 资产清单。
• 故事板规划。
• 剪辑决策和音频计划。

整片先在 director_plan 写死 style_contract（可复制文字风格契约），后续所有片段逐字沿用。 不能从文学剧本直接跳到生成 prompt。

开拍前检查时长：

• 单段视频生成建议不超过约 15 秒。
• 超长内容必须在编导规划期拆分，写进 director_plan.json。
• 生成阶段发现超时或超过上限，只能停下回编导补拆分，不能由提示编译 / 调用层临时生成 seg02a/seg02b 直接提交。
• 正式子段必须有自己的 ID、时长、镜头节拍、首尾承接、参考资产和审查记录。
• 3 段及以上如果时长全相同，默认怀疑机械均分。
• 机械均分必须回编导按剧情轻重重排，或逐段写清确实同长的创作理由。

对白段要预留尾音 / 呼吸 / 反应空间。 最后一句台词不要刚好卡在段边界上被硬切。

3. 素材生成和资产覆盖

按 director_plan.json 收敛资产清单。 只生成后续片段会用到的角色、场景、道具、关键特写、空间参考、运镜参考。 没用到的不生成，计划里有的必须补齐。

素材阶段只做流程闸门，不重新决定专业规划。 哪些对象要单独出图、场景要几张视角、是否需要 blocking 图 / 动线参考，以编导方案为准。

硬闸门：

• director_plan.json 里有固定 style_contract，不是只有一张风格锚点图。
• style_contract.color_palette 钉死主 / 辅 / 点缀色、色温、对比度、影调、LUT，并有一张登记进资产的色卡；色卡只锁颜色规格，不当画面参考。
• 主要角色有角色卡 / character sheet，同图包含正面全身、侧面全身、背面全身三视图。
• 需要表演或特写时，补面部近景、表情、手部、服饰、配饰细节。
• 每个实际拍摄场景都有多视角参考包：主视角、反向或侧向视角、俯视 / 总览或关键区域视角。
• 人物穿过场景、追逐、逃跑、横穿街道、进入房间这类空间运动段，场景参考包升级为左 / 中 / 右三视图 + 俯视场景运动轨迹图；红线只代表人物 / 物体路线，不代表镜头视角。
• 多人进出、推门、穿街、追逐、对峙、换手等关键调度， 有 blocking 图标出人物站位、运动路线和门内外关系。
• 关键道具、产品、屏幕、纸条、表盘、UI、文字特写等有清晰参考；关键特写继承对应基础资产、状态资产或所在场景参考，不能脱离母资产另起一套画面。
• 风格锚点图只锚色调、光影、构图、质感，不塞复杂人物、手、文字和道具。
• 角色、场景、道具、关键特写和视频生成要求都继承 style_contract。 写实片必须持续排除动漫、插画、游戏 CG、塑料 3D 和玩具感。

素材收口前，对着 director_plan.json 逐段做资产对照：

• beat 里推进到"观众必须看清"的内容是否都有参考。
• 故事板里出现的角色、场景、关键道具是否都有终版资产依据。
• 计划里写"可选 / 如需要 / 靠描述兜底"的，退回编导补明确。

声明即承诺：plan 写了就得真做出来，不能只在文字里存在。 编导方案里凡是列成清单、数组、字段的规划件——每个场景要几个视角、要不要色卡、要不要 blocking / 轨迹图、哪些主体 / 道具 / 场景要状态变体——都是承诺，不是可选建议。 素材收口不是"看 plan 里写没写"，是"逐条点数：plan 承诺了 N 个，实际生成并过审了几个"。承诺 3 个视角只出 1 个、承诺登记色卡却一张色卡都没生成、承诺 blocking / 轨迹图却只有一张单机位场景图，都算素材阶段未完成，不能进故事板 / 生成环节。 把颜色、空间、调度这类控制信息只写进后续每条 prompt 的文字里（"全片调色板是…""从门口视角看…"），当成已经落地，是这一环最隐蔽的漏法：文字口述对生成模型的约束远弱于一张真实参考图，缺图就等于没有视觉锚点，颜色会各段漂、空间会跨镜跳。声明了视觉锚点就必须生成出对应的图，让它真正作为参考进入下游，不能用一句描述替代。 自检一句话：合上 plan，只看 entities 里真实存在的图，能不能凑齐 plan 承诺的每一类锚点？凑不齐就回素材补，别靠"生成时我会在 prompt 里带"糊过去。

参考图和故事板默认保留官方 AI 生成标识。 只有用户明确要裸图交付，且该图不再作为视频参考时，才考虑去掉。

4. 故事板闸门

每个片段进入视频生成前，必须有过审的 3×3 九宫格手绘故事板。 本层只验三件事：

• director_plan.json 写清本段故事板分格规划。
• 实际故事板能看出九宫格、顺序箭头和剧情流动。
• 故事板中出现的角色、场景、关键道具有终版资产依据。

故事板只提供故事梗概、剧情流动、事件顺序和情绪 / 信息推进。 它不代表分镜，不决定切几刀，不锁人物细节、材质细节、场景结构或镜头视角。 成片外观、材质、光影、颜色和统一风格，回到角色 / 场景 / 道具参考图和风格锚点决定。 人物穿过场景的精确空间路线，回到场景运动轨迹图 / blocking 图决定。

故事板必须真实参与下一步视频生成。 只画不用，或视频完全没有继承故事板的剧情流动和事件顺序，算本阶段失败。 但故事板不决定成片切几刀，切镜按 director_plan。

5. 生成前提示编译与自检

每次正式生成之前，都要先把执行计划、剧本文字、参考素材职责和本次生成要求统一编译成一份完整输入。 编译完成后，先做调用前自检，再进入生成。 主流程只要求 agent 能说明本次生成为什么可以继续：依据哪段计划、用了哪些参考、故事板边界是什么、关键设置是否和生成要求一致。 这不是固定工作流产物，不规定具体工具、字段名、记录格式或文件名。 自检明确可继续，才进入生成；说不清、缺参考、边界冲突或设置互相打架，主流程必须停下。

调用前自检至少要覆盖：

• 本段逐字对白 / 旁白没有丢。
• 画面文字逐字落进生成要求。
• prompt 没改写 direct plan 的镜头参数、光圈数字、画面文字、段初段末承接和关键道具持有链。
• 真实生成设置和生成要求不冲突：例如画幅、时长、音频、参考输入等关键设置不能互相打架。
• 角色、场景、道具、状态变体参考图、九宫格故事板、blocking 图、场景运动轨迹图、风格锚点作为真实参考参与。
• 每张参考的职责写清：锁身份、锁空间结构、锁材质、锁风格、锁剧情流动、锁人物 / 物体运动路线。
• 若本段主要人物 / 关键道具 / 核心场景处于特殊状态，已绑定正确状态参考图，写清 state_id 和状态从哪来、延续到哪（STATE-1）。
• 若本段有食材、材质、产品、文字、屏幕、破损或状态证据的看清任务，已绑定单独关键特写素材，写清 closeup_id、用途和它继承的原始素材；特写没有漂成另一件物品或另一处场景（CU-3）。
• 最终图像 / 视频生成要求已按七层骨架写清镜头、主体、材质、空间、天气空气、光和色彩；没有因为怕长省略。
• 视频生成要求已按本段时长拆出段内时间轴，覆盖主体动作、表情、道具、副主体、环境、镜头和声音变化；不能只写动作链。
• plan 给过焦距 / 光圈数字时，prompt 原样保留数字。
• 视频生成要求已写清副主体运动和物理细节，不只写主体动作。
• 涉及吃、喝、拿、夹、舀、切、吸、抿、咀嚼的动作，已按对象属性写清处理方式和入口节奏；没有该用工具却手拿、该抿却大口灌、该嚼却直接吞这种 USE-1 问题。
• 涉及食物、液体、热量、重量、湿滑、锋利、燃烧、碰撞的动作，已写清生活物理和人的本能反应；没有热汤不吹就喝、大块食物一口吞、酱汁不滴、液体不晃这种 PHYS-1 问题。
• 如果本段是链式延展，上一段终版已经存在且过审，并作为本段真实参考依据；生成要求写清"基于参考继续往后扩写"。
• 故事板只作为故事梗概、剧情流动、事件顺序和情绪 / 信息推进参考；未注册资产、箭头、编号、格号、标签、说明字不进入成片。
• 人物穿过场景 / 追逐 / 长距离移动时，prompt 已把场景运动轨迹图红线翻译成自然语言路线，并声明红线不代表镜头视角、不出现在成片里。
• 人物与场景构图比例明确，大场景里人物该小就小。
• 段初承接状态、段末交接状态、关键道具持有链写清。
• 人声用固定音色档案，不写"同上"。
• 成片镜头没有把参考白底带进去，环境和光照由提示编译环节重建。
• 生成要求里没有工具层字段、路径、参数和轮询细节。

上面任一条缺失，调用前自检必须阻塞，主流程不得进入生成。 先回提示编译环节改生成要求；若缺的是 plan、资产、故事板来源或生成设置，回对应上游补齐后再重编译，再跑一次调用前自检。