HyperFrames Editorial Video 技能用于把 SRT 字幕文件制作成 HyperFrames + GSAP 的 Editorial 风格视频，仅支持 SRT 字幕输入。
用途 该技能面向需要根据字幕文本自动生成 Editorial 风格动画视频的场景。调用时必须由用户提供 SRT 字幕文件路径；若无 srtPath，主 Agent 必须先暂停并要求用户提供 .srt 文件路径。制作前用户必须明确选择一个主题，不能默认代选。可选主题为：暗色风格（dark-editorial）、牛皮纸风格（kraft-editorial）、克莱因蓝风格（klein-blue）、鼠尾草绿风格（sage-green）。
核心原则 SRT 时间是唯一时间事实源。AI 只负责语义分组、视觉转译和局部场景设计；脚本负责 SRT 解析、连续性校验、相对时间计算、creator 分片、scene-plan 校验和最终 composition 组装。creator 不直接修改最终 index.html，只写独立 scene 片段。
工作方式与流程 流程包括：0 环境预检；1 确定主题和 SRT 路径；2 初始化项目；3 生成 groups.json 和 storyboard.json；4 按 creator 分片并并行实现 scene；5 组装 HyperFrames composition；6 交付前校验；7 渲染最终视频。
环境预检需运行 node --version（须为 v22.0.0 或更高）、npm --version、npx hyperframes --version、ffmpeg -version，任一失败即暂停并报告缺失项。
初始化项目运行：node "{scriptsRoot}/init-project.mjs" --srt-path "{srtPath}" --theme "{themeId}"，脚本会创建项目目录、复制模板样式与主题 token、写入 .theme，并创建 src/scenes/ 与 scene-plans/。
第 3、4 步为强制 SubAgent 阶段。若运行环境没有可用 SubAgent 工具，主 Agent 必须暂停并说明阻塞原因，不得降级自行完成。storyboard SubAgent 读取 storyboard-parser.md 与 SRT，生成 groups.json，再运行 generate-storyboard.mjs 生成 storyboard.json。之后主 Agent 每 10 个 storyboard scene 分配一个 creator，通过 generate-creator-scenes.mjs 切片，并为每个 creator 分片启动独立 creator SubAgent（多个时尽量并行）。creator 不得修改最终 index.html。
组装阶段运行 generate-composition.mjs 生成最终 index.html，创建唯一 paused GSAP timeline，硬切 scene，并调用每个 scene 片段注册的 builder。最终 HTML 需同时服务 GSAP 主 timeline 与 Studio/调试时间轴。
交付前校验至少运行 validate-ed.mjs、npx hyperframes lint（须 errorCount: 0）、generate-inspect-times.mjs 与 npx hyperframes inspect --json（不使用 --strict）。ghost 装饰性大字的 text_box_overflow 视为设计允许的溢出。
渲染最终视频执行：npx hyperframes render "{projectRoot}" --quality high --output "{projectRoot}/output.mp4" > "{projectRoot}/render.log" 2>&1，并运行 validate-render-log.mjs 检查日志。若日志出现 timeline 未注册、JS exception、q(...) 被当作 DOM 元素使用或 GSAP target not found，须回到对应 src/scenes/SceneXXX.js 修复后重跑。
数据结构 storyboard.json 包含 totalDuration、sceneCount 与 scenes 数组，每个 scene 含 id、startTime、duration、displayDuration（可选）与 segments（含 text、relativeStart、relativeDuration）。
资源 技能提供 assets/template/（composition 样式模板）、themes/（内置主题，含 theme.json 与 tokens.css）、references/（storyboard-parser.md、scene-creator.md、TIMING-CANON.md、VISUAL-SYSTEM.md、BEAT-ARCHETYPES.md、layout-patterns/、MOTION-CANON.md）以及多个 scripts 校验与生成脚本。
快捷指令 “生成 4K 60 帧版本”：不重新走分组/creator/composition 流程，直接执行 npx hyperframes render 使用 --resolution landscape-4k --fps 60 --quality high 输出 {projectRoot}/output-4k.mp4，并校验 render-4k.log（landscape-4k 输出 3840x2160）。
“打开调试模式”：使用 HyperFrames Studio preview，需先确定含 index.html 的 projectRoot 并提供调试音频，音频写入 index.html 的固定调试音频槽位（ED_DEBUG_AUDIO_SLOT_START/END），再运行 npx hyperframes preview 从 3002 起选择未占用端口。“停止调试模式”：清空槽位内临时音频、停止 preview 进程，不删除用户原始音频。
限制 仅支持 SRT 输入；主题必须由用户指定；第 3、4 步强依赖 SubAgent 环境；最终视频固定输出到 {projectRoot}/output.mp4，不输出到默认 renders/ 时间戳目录。价格、收费、跨平台与其它未在资料中说明的信息暂未提供。