hyperframes-scene-animator

HyperFrames Scene Animator

在固定舞台交接后，先完成全镜头最终静态页的人工审核，再制作动效并闭环至 preview-v1。固定模板仍归 talking-head-hyperframes 所有。

开工门禁

每次执行先读取：

1. 项目的 manifest 与 template handoff；
2. 已锁定的导演脚本、制作规格、素材计划、对齐字幕和 motion contract；
3. 本地 AESTHETICS.md；
4. 本地 runtime adaptation contract；
5. 当前启用的 hyperframes、hyperframes-core、hyperframes-animation 与 hyperframes-cli skills。只有写 GSAP 时才加载对应 adapter/GSAP reference，只有实现真实 scene boundary 时才加载 transition overview、catalog 和所选转场类别。

进入 proof 与审片阶段时再读 proof and review contract，不要在编排阶段提前加载。

首次执行任何项目 package script 前，先用本 Skill 自带的 scripts/verify_project_bundle.mjs <project-dir> 验证 factory-owned 脚本、完整 package script 集合和只含 ignore-scripts=true 的 .npmrc；任何额外 pre/post hook、项目 Node options 或字节差异都必须停止，不能执行项目代码。通过后只使用生成项目公开的 package scripts 运行校验、proof 和 failure gates；不要复制活动 HyperFrames skills 的运行时文档，也不要依赖不可复现的隐藏手工步骤。

只有 manifest 明确为 READY_FOR_EXECUTION，且 handoff 中每个必填输入的实际路径、项目相对路径、SHA-256、媒体/字幕校验和 motion-contract source hash 都与实物一致，才可写内容 composition。

遇到 TEMPLATE_ONLY、缺失文件、无效媒体/字幕、未确认导演决定、合同缺字段/未覆盖整片或 hash 不一致时：

• 立即拒绝执行；
• 按项目实际状态逐项列出缺失或无效项，包含字段/期望路径、实际路径、期望 hash、实际 hash 或无法取得的原因；
• 指明应回到 factory 还是上游锁定资料；
• 不创建或修改任何内容 composition、场景、动效、转场或声音 cue。

不得用临时导演、占位场景或“先做几个看看”绕过门禁。

五条防回退红线

1. 一镜头只讲一个命题。 屏幕只留口播当下需要记住的关键字；主词必须在字号、对比、位置或空间上显著压过辅助信息。不要把解释性隐喻、来源备注、英文装饰词和多组数据同时堆在画面上。
2. 章节牌是事件，不是常驻挂件。 章节只在独立场景中出现一次，让观众读懂后结束。不得让“招牌热菜”、NO.01、章节标签或装饰卡在后续镜头中持续占位。
3. 一个场景只有一层主空间。 禁止“外面一层页面，里面又塞一层完整背景框”的 PPT 套娃，也禁止没有口播含义的系统框、权限夹、执行工位和未解释标签。概念改变就切新场景；所有可见元素都必须服务当下命题。
4. 先审静态定稿，再做任何动效。 依据字幕交付每个镜头信息完全呈现时的最终静态页和整片联系表。未获得用户对整套静态镜头的明确批准，不得写动效、转场或整片预览。
5. 音频微剪以听感和音素完整性为准。 不得只依赖 silencedetect、波形或字级时间戳判断插入/删除点；停顿只放在完整语义短语边界，不得切在一个字或辅音内。每次从未修改的已批准母带按 EDL 重建，先输出 6–10 秒试听并获得人工批准，再按分段时间偏移同步下游字幕、cue、时长和 hash。本 Skill 不直接改锁定人声；修改后必须回到上游重新锁定输入。

主 Agent 与快速子 Agent

• 主 Agent 是唯一导演、编辑与集成者：它负责字幕→beat→镜头的划分，锁定可见文字、素材、布局层级、每个镜头具体怎么写、时序、转场接力与验收标准，并审查全部合并结果。
• 完成主 Agent 的逐镜锁定简报后，把互不冲突的镜头页/镜头模块优先分配给快速子 Agent。调用 spawn_agent 时默认使用 agent_type: worker、fork_turns: none、model: gpt-5.4-mini、reasoning_effort: medium，并在自包含 prompt 中写清下面的任务合同；该模型不可用时，选当前最快且能稳定完成 HTML/SVG/GSAP 的 worker 模型。
• 每个子 Agent 必须获得自包含的逐镜任务：字幕时段、单一命题、最终静态图、允许的文字/素材、尺寸与设计 token、入/出状态、精确文件所有权和验收帧。子 Agent 只实现，不重新规划、不增删屏幕文案、不改镜头数量、不改全局视觉/动效语言。
• 子 Agent 只修改分配给它的独立文件；content.html、全局 timeline、shared styles/tokens、runtime adaptation、转场接力、音频/字幕及最终集成只由主 Agent 修改。场景不独立或强共享文件时，不强行并行。
• 审查可由其他 Agent 发现问题，但修改仍回到原镜头文件所有者或主 Agent；不得创建第二套竞争实现。所有 Agent 都必须适配共享工作区已有改动，不回退他人的工作。