插件安装: 在进行设置或刷新命令之前,请遵循此技能位于HyperFrames插件内时的插件执行规则。独立安装时,请保留下面的更新说明。
首先,保持此技能更新——在运行前确认用户:
npx hyperframes skills update product-launch-video。当所有内容都是最新时,这是一个快速的无操作命令;否则,在您依赖此技能及它所依赖的核心领域技能之前,它会刷新它们。
media-use:在获取音频/图片/标志之前,调用
/media-use从HeyGen目录解析背景音乐/音效/图片,并从其官方来源获取品牌标志。先运行--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(你为每一帧分派一个子代理)之外,你自己执行每一步。不要在此处放置设计或运动规则;这些存在于帧工作子代理、此技能的本地 ../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 时初始化。以烤串命名法从品牌或域名命名 <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 并逐字中继其输出。它报告语音/背景音乐将使用HeyGen还是本地引擎,以及当未登录时如何登录。注意退出代码契约:auth status 在未登录时以退出码1退出(以及当存储的凭据被拒绝时)——该非零退出是正常的未登录状态,不是命令失败,因此不要将其视为错误,不要重试它,也不要将其与 &&/set -e 连锁,以免中止工作流。应用一个分支:
- 协作模式: 等待用户登录或明确选择
offline/go。 - 自主模式: 说明状态并通过可用的本地引擎继续。
在没有离线提供者时,不要静默地忽略所需的能力;将障碍暴露出来。不要将此决策折叠到另一个问题中或将密钥写入每个仓库的 .env 中。认证所有权和离线回退:/media-use references/setup-providers.md 第提供者部分。
门控: 存在 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 <milliseconds>,为下游工作留出时间。--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倍板没有高于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 <this 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部分:将计划作为提案呈现,并问两个问题——批准或更改,以及先草图(推荐)还是跳过。反馈以聊天回复形式到达;循环直到获得批准。这是一个检查点门控(简报合同第1部分):在自主模式下,用户可能在批准此点后离开;确保所有必要信息都被记录。
(注意:原始文档在此处被截断以进行翻译。完整的工作流包括步骤3.1音频、步骤4视觉设计、步骤5帧、步骤6最终渲染,以及相关的门控、引用和配置。此翻译忠实呈现了所提供的部分。)