媒体使用:在获取音频/图片之前,请先调用
/media-use以从HeyGen目录中解析背景音乐/音效/图片。运行--adopt以注册现有资产。详情见/media-use技能。
产品发布到HyperFrames 是做什么的?
使用此技能来了解产品、理解其品牌、规划发布视频,并逐步在HyperFrames中构建视频。
在步骤0之前确认路径。 你是编排者。运行每一步,验证其关卡,然后才能继续下一步。此技能适用于正在营销、发布、推广或展示的产品,包括当目的是推广时的“我们网站的推广”等请求。将其他意图路由到别处:一般的非发布网站导览 ->
/website-to-video;没有产品的主题解说 ->/faceless-explainer;GitHub PR ->/pr-to-video;在现有素材上加字幕 ->/embedded-captions;短的无旁白动态图形 ->/motion-graphics。如果用户只说了“制作视频”或路径不确定,请先阅读/hyperframes。
你是编排者。在videos/<project>/目录下工作。按顺序运行步骤,并通过每个关卡后再继续。用户把关的步骤是步骤0、步骤3和步骤6。除了步骤5(你需要为每个帧分派一个子代理)外,其他所有步骤都自己完成。不要在此处放置设计或运动规则;这些规则存在于帧工作子代理、本技能的本地../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/以及hyperframes-creative中。
工作流程:步骤0 设置 -> hyperframes.json;步骤1 捕获 -> capture/;步骤2 设计系统 -> frame.md;步骤3 故事板/脚本 -> STORYBOARD.md 和 SCRIPT.md;步骤3.1 音频 -> audio_meta.json;步骤4 视觉设计 -> 增强后的STORYBOARD.md;步骤5 帧 -> compositions/frames/NN-*.html 和 index.html;步骤6 最终渲染 -> renders/video.mp4。
步骤0:设置和简报
目标:锁定核心视频简报,并在需要时创建HyperFrames项目。
仅在hyperframes.json缺失时初始化。项目名称<project>使用kebab-case格式,来自品牌或域名,例如acme-promo;不要使用工作区名称或时间戳。
npx hyperframes init "videos/<project>" --non-interactive --example=blank — init会检查已安装的技能是否与GitHub上的最新版本一致,如果有任何过期,则更新全局技能集。
在简报之前显示登录状态 — 运行npx hyperframes auth status并逐字转述其输出(不要改写或重新表述)。 它会报告语音/背景音乐是使用HeyGen还是本地引擎,以及当未登录时如何登录。如果未登录,请停止并等待用户选择——登录,或说“go”/“offline”以继续使用本地引擎——然后再询问简报或其他任何事情。 将其视为一个真正的决策点,而不是一个过场提示;不要将选择折叠到简报问题中,也不要将密钥写入每个仓库的.env文件中。(在自主模式下,记录状态并继续离线工作。)参见../hyperframes-media → Preflight 以获取规范指导。
关卡: hyperframes.json已存在,并且角度、时长、宽高比和语言已锁定;登录状态已显示(已登录,或继续离线)。
步骤1:捕获资产
目标:收集视频的源材料、品牌信号和可用资产。
对输入进行分类并选择路径。显式URL -> 捕获它并使用网站作为旁白和资产。粘贴的脚本/简报 -> 原样保存为user_script.txt,询问一次“原样使用还是重新组织?”,将答案存储为VO_MODE,然后解析捕获目标:文本中的URL -> 使用它;仅有品牌名称 -> WebSearch,在一行中确认URL,然后爬取;无URL/网站 -> 无捕获路径。
使用以下命令运行捕获:npx hyperframes capture "<URL>" -o ./capture
如果存在GEMINI_API_KEY、GOOGLE_API_KEY或OpenRouter密钥,捕获会自动为资产添加字幕到capture/extracted/asset-descriptions.md中。这不是一个审查关卡。如果没有视觉密钥,则使用DOM上下文并继续。
无捕获路径:手动创建capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md和capture/assets/。tokens.json应为{ "title": "", "description": "", "colors": [], "fonts": [] };尽可能从简报中填写标题/描述。visible-text.txt包含完整的简报或脚本。asset-descriptions.md应说明没有捕获任何资产,除非用户提供了资产说明。
关卡: capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md和capture/assets/都存在;你能用一句清晰的话说明品牌。将asset-descriptions.md作为主要资产清单。如果在实际捕获后它缺失,请停止并报告捕获不完整。如果存在capture/BLOCKED.md,请遵循它。
步骤2:设计系统
目标:选择一个已交付的帧预设;脚本会将其转换为本视频的frame.md + 字幕皮肤。
你只做一个判断——选择哪个预设。阅读../hyperframes-creative/references/design-spec.md,选择外观最适合该品牌和简报的预设。然后运行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
脚本确定性地完成其余工作:将预设的FRAME.md复制为frame.md,并将其重新混合到capture/extracted/tokens.json中的品牌令牌上(品牌颜色按角色映射到预设的颜色键上——墨色、画布、强调色——保持键/结构/组件不变;预设的显示+正文字体替换为品牌的字体),将预设的字幕皮肤复制到.hyperframes/caption-skin.html,并进行自我验证(遇到映射错误时退出码1)。一旦脚本退出码为0,就继续下一步——无需手动编辑规范。
如果没有品牌颜色/字体的tokens.json(例如,无捕获),则脚本会保留预设自己的调色板,这是一个完整可交付的设计。如果简报中提到了捕获未包含的品牌颜色/字体,请在运行脚本之前将它们添加到capture/extracted/tokens.json中(或使用用户的design.md来填充);之后只有在映射确实需要时才手动调整frame.md。
关卡: build-frame.mjs退出码为0——frame.md来自一个命名预设,并且(当预设附带字幕皮肤时).hyperframes/caption-skin.html作为字幕皮肤源存在。
步骤3:故事板和脚本
目标:将简报和捕获材料转化为已批准的逐帧故事计划。
阅读references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes-core/references/storyboard-format.md和../hyperframes-core/references/script-format.md。使用它们编写STORYBOARD.md,以及在需要旁白时编写SCRIPT.md。
使用story-design.md获取故事蓝图、钩子、说服逻辑、节拍、VO_MODE和资产选择。作为一个软指南,查阅../hyperframes-animation/blueprints-index.md中的角色→蓝图菜单:对于每个节拍,如果合适,记录一个候选蓝图ID。故事的真实性仍然决定哪些节拍存在——永远不要为了适应蓝图而强制使用某个节拍,也不要仅仅因为有可用的经过验证的形状而发明节拍。从capture/extracted/asset-descriptions.md(规范清单)中选择每个视觉帧的asset_candidates——不要浏览原始的capture/assets/。除非该清单缺失或不可用,否则不要要求用户选择资产。使用故事板和脚本参考中要求的精确字段。
草拟完成后,显示逐帧摘要。在同一消息中询问用户两件事:(a) 批准或请求更改,以及 (b) 是否想要故事板脚手架的实时预览(npx hyperframes preview)——仅在用户同意时打开它。迭代直到获得批准,并将预览选择带到步骤6。
关卡: STORYBOARD.md存在,每个视觉帧都有asset_candidates,在需要旁白时SCRIPT.md存在,并且用户已批准逐帧计划。
步骤3.1:音频
目标:根据已批准的脚本生成旁白、单词时间码、音乐和音频元数据。
在步骤3批准后开始音频处理。在后台运行它,然后继续步骤4。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
音频脚本处理旁白、单词时间码、从HeyGen音乐库查找背景音乐以及时间元数据。背景音乐情绪来自故事板的music:字段。这使用HeyGen Audio API进行检索,而不是生成,并使用与TTS相同的~/.heygen凭据。有关提供商详细信息,请阅读../hyperframes-media/references/tts.md。
如果没有旁白且没有SCRIPT.md,则跳过语音生成。如果故事板有音乐情绪,背景音乐仍可能运行。
关卡: 音频任务已启动,或项目被标记为静音。
步骤4:帧视觉设计
目标:为每个故事板帧添加视觉方向、布局意图和运动选择。
直接编辑STORYBOARD.md。不要创建另一个故事板。使用frame.md作为颜色、字体、布局感觉和风格的真实来源。
阅读references/visual-design.md、../hyperframes-animation/blueprints-index.md、references/motion-language.md和../hyperframes-animation/rules-index.md。使用visual-design.md获取方法(带时间码的镜头序列、内联布局词汇和必需的## Video direction块)。使用../hyperframes-animation/blueprints-index.md选择每个帧的镜头形状。使用motion-language.md(运动词汇 + 运动原则)和../hyperframes-animation/rules-index.md(有效的规则名称)来指定运动——不要发明运动名称。
对于每个视觉帧,按照visual-design.md的方法在STORYBOARD.md中编写带时间码的镜头序列:选择该帧的蓝图(或组合),用当前产品的实例化它,并调整每个场景的展示节奏以适应画外音,使得帧在其整个持续时间内展开,而不是提前加载然后冻结。根据每个场景内联说明布局和运动(词汇见visual-design.md和motion-language.md)。添加一个全视频范围的## Video direction块。
不要更改故事、脚本、资产选择、asset_candidates、transition_in或捕获的源材料。在此步骤中不要编写HTML。
在视觉设计锁定后暂存命名的资产:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
关卡: 每个视觉帧都有一个带时间码的镜头序列,其展示节奏与画外音同步(没有提前加载);## Video direction存在;assets/包含命名的资产。
步骤5:构建帧
目标:将每个故事板帧构建为HTML组合,并组装可播放的视频。
如果音频已启动,请等待步骤3.1的音频完成。然后同步时长并获取音效;如果项目静音,则跳过两者。
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
时长同步是机械性的:真实语音时长优先;静音帧保留估计值;永远不要手动编辑同步后的时长。
在分派之前,阅读sub-agents/frame-worker.md和../hyperframes-core/references/subagent-dispatch.md。为每个帧分派一个子代理,如果可能则并行;否则,按批次运行工作器。每个工作器只负责一个帧。
每个工作器上下文必须包含PROJECT_DIR、frame_id、画布大小、字幕状态和如果启用字幕时的禁区带,以及RULES_DIR作为本技能../hyperframes-animation/rules/目录的绝对路径。每个工作器读取frame.md、来自STORYBOARD.md的其自己的## Frame N块、每个引用运动的本地规则配方(../hyperframes-animation/rules/<id>.md)以及该帧的蓝图模板(../hyperframes-animation/blueprints/<id>.md)。每个工作器只写入compositions/frames/NN-*.html。工作器绝不能编辑STORYBOARD.md。
当每个工作器返回时,编排器在STORYBOARD.md中将该帧标记为animated。
在音频时间码存在后,在后台构建字幕并组装索引:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs使用项目的.hyperframes/caption-skin.html(在步骤2中复制)作为字幕外观,注入来自frame.md的品牌令牌;如果没有皮肤存在,则渲染内置的默认药丸形状。captions: skipped (<reason>)是有效的。当明确跳过时,继续不生成字幕。
关卡: 每个帧都被标记为animated,index.html存在,并且字幕已构建或明确跳过。
步骤6:最终确定
目标:验证组装的视频,获得用户批准,并渲染最终的MP4。
注入过渡效果,运行检查,暂停以供审查,然后渲染。
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <frame-midpoints>
snapshot将捕获的帧拼接成一张联系表(snapshots/contact-sheet.jpg)。快速浏览一下;如果没有明显问题,就继续——不要在此停留。
如果某个命令失败,输出stderr并停止——不要堆积恢复命令。自己修复它:对compositions/frames/NN-*.html进行最安全的编辑,然后重新运行失败的检查。
检查通过后,暂停以供用户审查。视频已组装完成,可在Studio中查看和编辑。在步骤3和步骤6之间只管理一次预览:如果用户之前要求过,则打开它;如果他们之前拒绝了,则提供它;如果他们已经在Studio中审查,则不要再询问。
预览:npx hyperframes preview
渲染
…
[为了翻译而截断]