Communitygithub.com

hyperframes-commercial-video

用于从网站或产品页面创建 9:16 格式的 HyperFrames 商业视频,包含用户旅程、轮播、优势、价格、行动召唤及最终渲染。

hyperframes-commercial-video 是什么?

这是一个专为 HyperFrames 设计的 AI 技能,用于自动生成 9:16 竖屏商业视频。该技能的核心目标是模拟真实用户浏览产品页面的交互体验,将网页 DOM 内容转化为电影般的动画叙事。它通过 GSAP 时间线控制动画,确保每个点击、滚动和转场都精确可预测,并且渲染过程不依赖网络请求或随机数,从而保证输出的稳定性和一致性。该技能支持 Claude Code、Cursor 等开发环境,通过 `mobile-dom-fidelity` 检查网站后,自动提取页面中的真实文本、图片和价格等信息,并按照预定义的 9 步结构(如轮播、核心卖点、价格、结账)生成包含光标点击、卡片进入、屏幕切换等动画的完整视频。最后,会输出一个可用的 HTML 合成文件和 MP4 视频,并执行严格的验证(如 lint、validate、inspect)来确保动画目标的可视性和点击坐标的准确性。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/galeonel/hyperframes-skills/tree/main/skills/hyperframes-commercial-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames 商业视频

请在使用 mobile-dom-fidelity 检查网站后使用此技能。

视频结构

  1. 简短标题的片头。
  2. 滚动或进入轮播。
  3. 核心产品亮点。
  4. 模拟产品点击。
  5. 主要优势。
  6. 价格。
  7. 用户选择。
  8. 购物车或结账。
  9. 行动召唤或最终确认。

互动旅程

视频应感觉像真实的浏览过程,而非幻灯片序列。 将每个动作建模为因果关系:

  • 滚动揭示该部分;
  • 轮播切换产品;
  • 主卡片回到中心;
  • 光标点击卡片;
  • 产品页面进入;
  • 优势出现;
  • 价格和行动召唤获得焦点;
  • 点击引导至购物车或结账;
  • 最终显示结论或确认。

构图规则

  • 竖屏格式:1080x1920。
  • 使用从 DOM 提取的真实文本。
  • 使用本地资源或允许的 URL。
  • 在 window.__timelines 中注册暂停的 GSAP 时间线。
  • 避免在渲染时进行网络请求。
  • 避免使用非确定性的 Date.now() 和 Math.random()。
  • 每次动画点击必须命中可见的组件。

动画模式

  • 标题:平滑的打字效果,不要过快。
  • 卡片:通过 y、opacity 和轻微的 scale 进入。
  • 轮播:水平移动,并在主卡片上暂停。
  • 点击:光标、涟漪、微缩放和聚焦阴影。
  • 屏幕切换:从右到左的横向过渡。
  • 产品:主图像轻微缩放,优势交错进入。

点击映射

在动画化点击之前,注册:

target selector:
visible from:
click time:
target rect:
click x/y:
post-click scene:

如果出现以下情况,则不应接受该点击:

  • 目标仍然不可见;
  • 目标在视口之外;
  • 另一个覆盖层遮盖了目标;
  • 在进入动画完成之前光标就已到达。

必需的验证

交付前:

npx hyperframes lint ./project
npx hyperframes validate ./project
npx hyperframes inspect ./project --samples 18

如果存在模拟点击,还需要验证:

  • 目标存在;
  • 目标在点击时间戳时可见;
  • 点击中心在边界框内;
  • 无破损图像;
  • 关键帧中无文本重叠。

预期输出

  • 合成文件 index.html;
  • 渲染的 MP4 视频;
  • 验证摘要;
  • 整洁的交付文件夹(如果需要)。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能