Communitygithub.com

mertz1999/luma-assistant

创建电影级SaaS演示视频页面和可录屏的产品演示。在Codex被要求构建/demo路由、动画产品导览、SaaS推广演示、录屏页面、旁白产品演示、光标驱动的UI故事或应用/网站的可复用演示视频系统时使用。

luma-assistant 是什么?

该技能旨在帮助开发者快速构建一个全屏、自动播放的SaaS产品演示页面,该页面可以直接录制为高质量的产品视频。它定义了清晰的实现模式,包括场景数据结构、时间线控制(支持播放、暂停、重启等操作)以及使用Framer Motion实现电影级的视觉效果(如变焦、光标平滑移动、揭示动画等)。技能要求根据产品的真实行为进行演示,不虚构功能,并提供了从问题钩子到最终行动号召的标准故事板结构。它主要适用于Next.js等现代框架,并强调通过DOM目标测量和响应式设计确保光标定位准确、内容在手机框架内清晰可见。此外,该技能还涵盖了旁白和音频同步的指导,支持用户提供时间戳以精确匹配场景时长,并提供了全面的验证步骤以确保最终页面无溢出、光标正确、预览场景正常工作。

兼容平台~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

在你喜欢的 AI 中提问

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

文档

SaaS 演示视频

成果

构建一个全屏、自动移动的演示页面,该页面可以录制为精美的SaaS产品视频。优先选择简短的客户故事而非功能巡览:问题钩子、产品操作、客户时刻、结果揭示、业务成果、最终行动号召。

使用此技能创建或改进诸如 /demo、/presentation、/video-demo 或等效的独立HTML/React页面等路由。

必需输入

在实施前收集或推断这些信息。仅在遇到阻碍时提问。

  • 产品名称、领域、受众和主要承诺。
  • 目标时长和宽高比,通常为30-60秒和16:9。
  • 要展示的现有应用路由:注册、仪表盘、产品创建、链接创建、客户页面、分析。
  • 品牌资产:Logo、颜色、字体、产品图片、客户图片、截图、图标、手机框架。
  • 真实工作流程约束:应用实际做什么,什么是手动的,什么是自动的,哪些数据可用。
  • 旁白脚本或时间线。如果用户已生成音频,请使用确切的时间戳。
  • 最终行动号召和录制URL。

切勿编造产品不支持的行为。如果商店手动复制链接,应说明这一点,而不是说应用自动发送。

故事板

默认30-50秒结构:

  1. 问题钩子:展示一个现实的客户问题或痛点。
  2. 管理操作:添加产品、创建私有链接、复制消息。
  3. 客户时刻:客户收到链接、打开链接、上传图片、开始生成。
  4. 结果揭示:与干净揭示动画的之前/产品/结果并排展示。
  5. 业务成果:重要的仪表盘指标。
  6. 最终行动号召:简短的产品承诺和域名。

使用应用的真实域名和真实产品语言。对于社交电商,除非产品实际集成Instagram API,否则仅将Instagram风格的DM界面用作视觉故事工具。

实现模式

使用应用现有技术栈。对于Next.js应用,优先选择:

  • 一个路由,如 src/app/demo/page.tsx。
  • 一个用于定时演示的客户端组件。
  • 使用 Framer Motion 实现场景切换、光标移动、揭示效果、微光和缩放。
  • 使用现有的UI组件、Logo、调色板和资源。
  • 查询参数场景预览,例如 /demo?scene=resultReveal。

核心演示组件行为:

  • 将场景定义为数据:id、title、caption、durationMs、cursor 和可选的视觉焦点/相机元数据。
  • 从 durationMs 计算场景开始时间。
  • 使用挂钟时间线,以便开发热重载或重新渲染不会意外重置播放。
  • 添加播放、暂停、重启、上一个和下一个控件,除非用户想要一个纯粹的录制页面。
  • 如果与生成的音频同步,确保场景时长与音频时间戳范围完全匹配。
  • 添加 data-demo-cursor-target 属性到重要的UI控件,并通过 getBoundingClientRect() 计算光标位置。当存在真实目标时,避免硬编码光标坐标。
  • 使用 ResizeObserver 和 requestAnimationFrame 保持光标目标在不同视口大小下准确。
  • 尊重减少动效设置。

视觉方向

使其感觉像现代SaaS发布/演示视频:

  • 全屏舞台,而非普通文档页面。
  • 对重要点击进行电影级缩放。
  • 从上个光标位置开始连续移动的平滑光标。
  • 简短叠加字幕:“1. 添加产品”、“2. 发送链接”、“3. 客户尝试”。
  • 在浏览器/手机框架内的真实应用截图或逼真的UI模拟。
  • 带有闪烁、擦拭、模糊至清晰或并排比较的结果揭示时刻。
  • 包含2-4个高信号指标的干净仪表盘结果画面。
  • 无密集段落、无开发者日志、无虚假技术术语。

对于移动客户流程,使用手机框架。确保其内部内容在桌面和移动录制视口中保持清晰可读。

旁白和计时

如果用户需要旁白,为语音模型提供提示:

  • 语调:自信、温暖、高端、清晰、不机械。
  • 节奏:匹配目标时长。
  • 产品名称的发音说明。
  • 按场景带有时间戳的脚本。

如果用户提供了生成的音频时间戳,将场景时长更新为这些确切范围,并验证总时长。

请参阅 references/storyboard-and-voiceover.md 以获取可复用的计时和旁白模板。

验证

在完成之前:

  • 本地运行应用或确认现有开发/生产服务器。
  • 运行相关检查:类型检查、Lint、构建或框架等效项。
  • 在桌面和移动尺寸下使用Playwright/浏览器检查。
  • 验证无水平溢出。
  • 验证手机框架内容可见。
  • 使用DOM目标测量验证光标落在预期按钮上。
  • 如果实现了查询参数预览场景,验证每个预览场景正常工作。
  • 验证最终公共URL或本地URL返回 200 OK。
  • 如果嵌入了视频iframe,验证iframe在渲染的HTML中存在。

单独报告任何已知的开发环境警告,例如在公网IP开发服务器上的Next HMR WebSocket失败。

交付

返回:

  • 演示页面URL。
  • 添加或更改的路由/文件。
  • 场景时长表。
  • 旁白提示(如果请求)。
  • 验证命令/结果。
  • 任何录制说明,例如推荐的视口大小以及是否隐藏控件。

相关技能