video-script

Video Script · Director Layer（短视频留存增强）

把已锁定的完整声音和字幕时间轴转成全片一致、可确认、可还原的导演处理稿。先回答“观众经历什么、画面世界如何演进”，再回答“每一段真实口播时间里发生什么”。

本 Skill 是逐字稿与实现管线之间的导演层。它不默认把所有内容做成 MG，也不把“运动优先”误解为“所有东西一直动”。真人、真实录屏、截图、B-roll、图形动画和留白都可以成为正确答案；关键是它们是否共同服务同一条叙事与注意力路径。

对短视频，本 Skill 可作为“爆款潜力导演”：它负责让镜头继续履行上游稿件的停滑、留存和传播意图，但不承诺流量结果，也不用画面替上游修稿。

职责门禁

• 正式视频导演稿必须同时具备：已确认逐字稿、已锁定完整音频、主字幕文件和校准后的带时间码字幕数据。只有选题、素材、大纲、逐字稿或 8–15s 声音试听时，先完成上游，不得进入正式分镜。
• 用户同时要求“写逐字稿＋做分镜”时，先完成当前工作区可用的上游逐字稿创作/审稿流程，再完成声音试听、完整配音、字幕生成和校准，最后把同一版本交给本 Skill。不要一边写正文、一边生成声音、一边预设画面。
• 不改写原稿的事实、观点、顺序、句子或连接词。发现口语、逻辑、事实或段间衔接阻塞制作时，引用具体相邻句，标为“上游逐字稿阻塞”，转回当前可用的逐字稿修订流程；若未安装专用 Skill，则明确告知用户需先修稿。用户明确要求按草稿原样继续时才做导演处理。
• 不输出 HTML、JSX、Remotion 组件、HyperFrames DOM 或 ChatCut MG 实体。实现属于下游 Skill。

执行职责

• 导演规划者完成导演诊断、素材职责、导演稿和制作规格；角色和能力要求以当前运行时与工作区指令为准，不在 Skill 中写死模型版本。
• 本阶段不得启动任何镜头执行者，也不得提前写场景代码。只有导演稿、制作规格、素材计划和 motion contract 锁定后，才交给已选管线的单一执行者；本工具包的 HyperFrames 执行者是 hyperframes-scene-animator。

单一导演来源

锁定后的 导演契约 + beat graph 是下游的叙事与视觉单一事实源。

• 下游可以补坐标、组件、帧、选择器、缓动和渲染细节。
• 下游不得擅自更换核心视觉命题、贯穿物、证据顺序、运动语法或转场关系。
• 实现不可行时，记录冲突与保守替代方案，返回导演阶段确认；不要静默重新导演。

默认保持管线无关

1. 用户未指定工具时，不选择默认实现工具，也不写 pipeline。
2. 使用真人、录屏、截图、B-roll、仿真 UI、流程关系、图形动画、空间和镜头等通用语言，不在导演契约中混入平台属性、坐标、帧号或组件名。
3. 用户明确指定 Remotion、ChatCut、HyperFrames、剪映或其他管线时，保留同一份导演契约，只追加最少必要的应用说明。
4. 能用真实证据直接说明的内容，不用抽象隐喻替代；抽象逻辑才优先寻找可演进的视觉隐喻。

按需读取

• 每次正式生成导演稿时读取 references/director-treatment.md。
• 导演方向锁定后读取 references/beat-graph.md。
• 完成导演稿前读取 references/anti-ppt-gate.md；写制作规格时在实现前再检查一次。低清 proof 后的语义运动、转场中点、AI 味硬拒绝项和联系表连续性由下游执行者检查；HyperFrames 管线使用 hyperframes-scene-animator。
• 正式交付时读取 references/output-template.md。
• 目标是短视频、平台分发型视频，或用户明确要求完播、留存、爆款/传播潜力时，读取 references/short-video-retention-directing.md；只提取稿件已有意图，不调用上游选题或片头改写流程。
• 中长视频、复杂剪辑判断或节奏诊断时读取 references/editing-methodology.md。
• 命中既有平台风险或用户要求复盘经验时读取 references/lessons-learned.md，只应用相关规则。
• 分镜已确认且用户要求继续制作时读取 references/production-spec.md。制作规格必须使用已经锁定的最终声音和带时间码字幕，并在代码动画管线中同步产出 work/motion-contract.json。
• 用户明确要求 HyperFrames 制作时：若尚无固定舞台工程，先读取 talking-head-hyperframes 生成模板与素材交接；交接状态为 READY_FOR_EXECUTION 后，一律读取 hyperframes-scene-animator 实现所有镜头。模板 Skill 不制作场景。
• 使用 Studio 暖白 Remotion 模板、沿用 J-space 视觉或用户锁定同类背景时，在给方向卡前用 view_image 查看 Studio 暖白蓝金网格高清参考图，并按 references/director-treatment.md 把背景当作导演约束，而不是实现阶段再补的装饰。
• 需要实际生成图片时读取 imagegen；导演阶段默认只写资产职责和规格。