插件安装: 在执行设置或更新命令之前,当此技能位于HyperFrames插件内部时,请遵循插件执行规则。独立安装则保留下面的更新说明。
首先,保持此技能更新——运行前请与用户确认:
npx hyperframes skills update product-launch-video。如果一切为最新状态,则快速无操作;否则,在依赖这些技能之前,会刷新此技能及其依赖的核心领域技能。
media-use:在获取音频/图片/标志之前,调用
/media-use从HeyGen目录中解析BGM/SFX/图片,并从其官方来源获取品牌标志。首先运行--adopt来注册现有资产。请参阅/media-use技能。
figma source:如果来源是 figma.com 的URL,首先运行
/figma——如果需要,导出资产、品牌令牌和组件/故事板重建——然后从其输出构建此工作流。不要直接通过原始的MCP工具驱动Figma:这会跳过SVG净化、.media/manifest.jsonl来源追踪和品牌令牌var()绑定,因此后续的品牌更改无法在不完全重新导入的情况下传播。
产品发布到HyperFrames
使用此技能来捕捉产品、理解其品牌、规划发布视频,并在HyperFrames中逐帧构建。
正门是
/hyperframes。 您是编排器。运行每个步骤,验证其门控,然后才继续下一步。此技能适用于正在被营销、发布、推广或展示的产品,包括当目的是推广时的“为我们的网站做宣传”等请求。网站导览/展示类型的请求也留在此处:BRIEF.md包含“按原样展示”的意图,捕捉的截图成为视频所展示的资产。任何其他意图、单纯的“制作视频”请求或任何不确定的情况 → 首先阅读/hyperframes——意图层拥有所有路由决策权,而一个没有BRIEF.md就直接到达这里的全新创作无论如何也会通过它(设置的开场规则)。
您是编排器。在 videos/<project>/ 目录下工作。按顺序运行步骤,并在继续之前通过每个门控。用户门控的步骤是步骤0、步骤3和步骤6。在步骤0之前阅读 ../hyperframes/references/brief-contract.md——它定义了门控类型以及 BRIEF.md 的 flow/storyboard 如何推导出管理模式步骤3/4/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项目,并使简介持久化。
简介由意图层确认,而非此处提出的问题确认。 开场规则,按顺序:(1) BRIEF.md 存在 → 读取它,不提问任何问题——简介已确定,其 flow/storyboard 推导出模式(简介合同 § 1)。(2) 不存在 BRIEF.md,但项目存在(磁盘上的 hyperframes.json / STORYBOARD.md)→ 从故事板的前言和记录的偏好中恢复;绝不要重新询问一个半成品的项目。(3) 两者都不存在——一个直接到达此处的全新创建请求 → 读取 /hyperframes 并运行其意图层(references/intent-interview.md):它会检查配方和记录的默认值,进行此路由的问题询问(../hyperframes/references/routes/product-launch-video.md),并返回锁定的简介。编辑请求跳过所有这些——直接进行编辑。
仅当 hyperframes.json 缺失时才初始化。用品牌或域名的kebab-case命名 <project>,例如 acme-promo;绝不使用工作区名称或时间戳。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init 会检查已安装的技能与GitHub上的最新版本,如果任何技能过时则更新全局集。
初始化后,令 <PROJECT_ROOT> 为 videos/<project>,并以此目录作为工作目录运行所有后续的相对路径命令。在下面的命令中,. 表示 <PROJECT_ROOT>;绝不会在调用者目录中写入 .media、capture 或输出文件。
在初始化之后立即写入 BRIEF.md(绝不在之前——init 拒绝非空目录):意图层锁定的简介,格式见 ../hyperframes/references/brief-format.md。将 <MEDIA_DIR> 解析为已安装的 /media-use 技能目录。然后使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 记录每个基于偏好的答案(brief-format.md 列出了子集)。如果意图层采用了配方,请运行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它会将其 frame.md 复制到项目中(步骤2随后跳过),并返回步骤3草稿所用的骨架。配方填充答案,而非审批;审查门控仍然运行。
在继续设置之前显示登录状态 — 运行 npx hyperframes auth status 并逐字传递其输出。它会报告语音/BGM将使用HeyGen还是本地引擎,以及当未登录时如何登录。注意退出代码约定:auth status 在未登录时退出码为1(以及当存储的凭证被拒绝时)——非零退出是正常的未登录状态,不是命令失败,因此不要将其视为错误,不要重试,也不要将其与 &&/set -e 链接,以免导致工作流中止。应用以下分支之一:
- 协作模式: 等待用户登录或明确选择
offline/go。 - 自主模式: 报告状态并通过可用的本地引擎继续。
当没有离线提供商时,不要静默地省略必需的能力;要明确指出阻碍。不要将此决定合并到另一个问题中,也不要将密钥写入每个仓库的 .env 文件。认证所有权和离线回退:请参阅 /media-use 的 references/setup-providers.md § Providers。
门控: hyperframes.json 和 BRIEF.md 存在;基于偏好的答案已被记录(简介合同 § 2);登录状态已显示(已登录,或继续在离线模式下运行)。
步骤1:捕捉资产
目标:收集视频所需的源材料、品牌信号和可用资产。
对输入进行分类并选择路径。明确的URL -> 捕捉它并使用网站进行叙述和资产提取。粘贴的脚本/简介 -> 原样保存为 user_script.txt;VO_MODE(逐字或重构)来自 BRIEF.md — 当脚本到达时,意图层会询问此问题(仅在简介中缺失时才在此处询问一次)。然后解析捕捉目标:文本中的URL -> 使用它;仅品牌名称 -> WebSearch,用一行确认URL,然后抓取;没有URL/网站(或简介说不要抓取) -> 无捕捉路径。
使用以下命令运行捕捉:npx hyperframes capture "<URL>" -o ./capture --json。除非调用者拥有更短的截止日期,否则保留默认的导航后预算;然后传递一个正数的 --capture-budget <毫秒>,为下游工作留出时间。--timeout 仅控制页面导航。仅在可选图片说明被有意禁用时才使用 --skip-vision。
立即检查命令结果和输出目录。非零退出、JSON ok: false 或 capture/BLOCKED.md 是捕捉路径的硬性停止:报告记录的原因,不要使用部分截图、DOM、令牌或资产。在失败的URL捕捉后,不要人为地制造一个合成式的无捕捉回退。仅在原始简介提供了源材料,或用户在失败后明确切换到提供的截图或简介时,才继续执行无捕捉路径。
诸如 very little text content 之类的警告加上空的资产目录并不能证明页面可用。对于网站导览或“按原样展示”的简介,需要可信的捕捉结构或提供的截图;如果两者都不存在,则停止。不要仅仅因为捕捉不可用就发明或重建页面。
对于网站导览或“按原样展示”的简介,捕捉到的页面是视觉真相来源。使用真实截图而不是在HTML中重建整个网站。如果截图需要内部移动,则保留截图作为基础,并在测量位置叠加真实的捕捉资产,或者只重建移动的单个组件。对于滚动截图,通过 capture/screenshots/full-page.png 对视口进行动画处理——这是整个文档的1倍图板,像素精确地用于1920宽的视口向下移动。当页面太高无法一次性捕捉时,此文件将不存在;回退到同一目录中重叠的滚动位置截图。放大超过1:1需要该区域自己的2倍捕捉,因为图板没有超过1倍的空间。仅当用户明确要求风格化诠释时才重建整个页面;单独一个不可用的捕捉并非授权。
如果存在 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 应说明未捕捉到任何资产,除非用户提供了资产说明。
门控: 捕捉JSON报告 ok: true;capture/BLOCKED.md 不存在;capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/ 存在;并且您可以用一个清晰的句子说明品牌。将 asset-descriptions.md 视为主资产清单。如果在真实捕捉后它缺失,请停止并报告捕捉不完整。仅当此结构门控仍然通过时,关于降级可选阶段的警告才是可接受的。
步骤2:设计系统
目标:选择一个已发布的帧预设;一个脚本将其转换为此视频的 frame.md + 字幕皮肤。
当 BRIEF.md 指定了 style_preset —— 用户在意图层通过展示图挑选的 —— 则使用它;仅在简介未指定时,判断权才归您。然后您做出一个决定——选择哪个预设:阅读 ../hyperframes-creative/references/design-spec.md 并选择外观最适合品牌和简介的预设。然后运行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <名称> --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 作为字幕皮肤源存在;选择的预设已记录为偏好(--key style_preset --workflow <此工作流>,简介合同 § 2)。
步骤3:故事板和脚本
目标:将简介和捕捉到的材料转化为一个经批准的逐帧故事计划。
阅读 ../hyperframes-creative/references/story-spine.md(钩子语言、先价值后证据、故事板作为提案、来源可追溯的视觉效果)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/script-format.md。使用它们来编写 STORYBOARD.md,以及当需要叙述时编写 SCRIPT.md。将前言中的 duration: 设置为来自简介的 length —— 这是一个粗略的预期;组合报告会显示实际剪辑时长与它的对比。
使用 story-design.md 获取故事蓝图、钩子、说服逻辑、节拍、VO_MODE 和资产选择。作为软指南,参考 ../hyperframes-animation/blueprints-index.md 中的角色→蓝图菜单:对于每个节拍,如果某个蓝图ID合适,则记录一个候选蓝图ID。故事的真实性仍然决定哪些节拍存在——绝不要强制一个节拍去适应蓝图,也绝不要仅仅因为有一个经过验证的形状可用就发明一个节拍。从 capture/extracted/asset-descriptions.md(规范清单)中选择每个视觉帧的 asset_candidates——不要浏览原始的 capture/assets/。除非该清单缺失或不可用,否则不要要求用户选择资产。使用来自故事板和脚本参考的具体必需字段。
草拟后,运行审查循环的计划通读——../hyperframes/references/review-loop.md § 1:将计划作为提案呈现,并询问两个问题——批准或更改,以及先看草图(推荐)还是跳过。反馈以聊天回复形式到达;循环直到获得批准。这是一个检查点门控(简介合同 § 1):在自主模式下,如果用户已配置偏好此操作,则门控可以自动通过;否则会在该点暂停。通过后,如果用户要求先看草图,则在不运行完整的帧构建的情况下为每个故事板帧生成草图,然后进入审查循环的草图通读(§ 2);否则,跳过草图并直接进入步骤4。
门控: 故事板(和脚本,如果需要)已写入并获得批准;关于先看草图的决定已做出;BRIEF.md 的前言已更新为 status: drafting → under_review → storyboard_approved,具体取决于审查状态。
步骤3.1:音频源
目标:为视频解决BGM和画外音音频源。
首先运行 /media-use 来解决此问题:它会处理HeyGen或本地引擎的BGM/SFX/图像以及官方品牌的标志。请参阅 /media-use 技能以获取详细工作流。
如果选择HeyGen,请运行相关命令来注册资产并从其目录中选择BGM。
如果使用本地引擎或HeyGen不可用,则设置本地音频源的 audio_meta.json 配置。该文件应包含BGM和任何画外音片段的路径和持续时间信息。
步骤4:视觉设计
目标:为每个故事板帧分配一个具体的视觉布局、动画蓝图和复合指令。
阅读 ../hyperframes-creative/references/visual-design.md、../hyperframes-animation/blueprints/<候选蓝图>/*.md 以获得工作流程和指令。使用 ../hyperframes-animation/references/layout-engine.md 获取布局规则,使用 ..、hyperframes-animation/references/motion-philosophy.md 获取运动模式。更新 STORYBOARD.md,为每个帧添加 layout、motion_blueprint 和 composite_instructions 键。使用规范资产清单 capture/extracted/asset-descriptions.md 中的资产ID。
STORYBOARD.md 中的现有 asset_candidates 是指向 capture/ 中资产ID的指针。不要将原始文件路径放入 STORYBOARD.md;而是使用规范的资产ID。
门控(检查点,简介合同 § 1): 视觉设计已作为提案呈现并已批准。BRIEF.md 的前言已更新为 storyboard_approved → visual_design_approved。
步骤5:帧创建
目标:基于批准的视觉设计,为视频的每一帧渲染单个HTML文件。
遵循 ../hyperframes-animation/references/composition-rules.md 以获取工作流程和指令。从 STORYBOARD.md 读取帧列表。对于每一帧,调用一个框架创建子代理(您自己是编排器)。该子代理应在 compositions/frames/NN-<简短描述>.html 创建一个独立的HTML文件。它必须使用 frame.md 中定义的设计令牌,遵循所选的动画蓝图,并使用 capture/assets/ 中的资产。它不应假设视频布局的外部框架——每一帧都是独立的。
第一帧必须是标题帧(NN-01-title-card.html),最后一帧必须是结尾帧或行动号召帧。
创建compositions/frames/index.html作为测试查看器。
门控: 所有预期帧的HTML文件都存在,并且index.html显示帧序列。
步骤6:最终渲染
目标:将所有帧合成最终视频,添加音频,并进行审查。
使用npx hyperframes render compositions/frames/index.html renders/video.mp4进行最终渲染。假设渲染器会基于frame.md中的设计令牌处理分辨率、编解码器和帧合成。
渲染后,运行npx hyperframes play renders/video.mp4播放视频。
通过呈现视频和计时的剪辑计划,让用户审查,记录最终剪辑的持续时间。询问用户是否批准渲染。
门控(用户门控): 用户批准最终视频。如果需要,可以进行编辑——循环回到步骤3(故事板更改)或步骤5(仅帧更改)。