**插件安装:**在执行设置或更新命令之前,当该技能位于HyperFrames插件中时,请遵循插件执行规则。独立安装则保留下面的更新说明。
首先,保持技能更新——在运行前与用户确认:
npx hyperframes skills update product-launch-video。若一切为最新,则快速无操作;否则,在依赖之前刷新此技能及其所依赖的核心领域技能。
media-use:在获取音频/图像/标志前,调用
/media-use从HeyGen目录和官方来源解析BGM/SFX/图像及品牌标志。先运行--adopt注册现有资产。请参见/media-use技能。当宿主应用提供自己的音乐或音效工具时,使用它们来处理音乐和音效。
figma源:如果来源是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外,每个步骤都由你完成(步骤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 或输出文件。
在 init 之后立即写入 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 第2节。
关卡: 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捕获后,不要制造合成的不捕获回退。仅在原始简介提供了源材料,或者用户在失败后明确切换到提供的截图或简介时,才继续通过无捕获路径。
警告如非常少的文本内容同时资产目录为空时,并不能证明页面的可用性。对于网站导览或“按原样展示”的简介,要求可信的捕获结构或提供的截图;如果两者都不存在,则停止。不要仅仅因为捕获不可用就发明或重建页面。
对于网站导览或“按原样展示”的简介,捕获的页面是视觉真理源。使用真实截图,而不是重新构建完整的网站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 <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 作为字幕皮肤源存在;所选预设已记录为偏好(--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。故事真相仍决定哪些节拍存在 —— 绝不强制节拍适应蓝图,也绝不要仅仅因为有一个经过验证的形状可用就发明节拍。从 capture/extracted/asset-descriptions.md(规范清单)中选择每个视觉帧的 asset_candidates —— 不要浏览原始的 capture/assets/。除非清单缺失或不可用,否则不要要求用户选择资产。使用故事板和脚本参考中要求的精确字段。
起草后,运行审查循环的计划传递 —— ../hyperframes/references/review-loop.md 第1节:将计划作为建议呈现,并问两个问题 —— 批准或更改,以及是否先画草图(推荐)或跳过。反馈以
…
[出于翻译目的进行了截断]