Community编程与开发github.com

Product Demo Integration Skill

用于产品演示视频片段集成的技巧、脚本和生产工作流。

Product Demo Integration Skill 是什么?

本技能专注于处理产品演示视频素材的集成工作流,涵盖从素材审查、裁剪决策、过渡处理到最终QA的完整流程。当最终视频中包含产品屏幕录制或演示片段时,使用此技能。它支持通过预审素材时长、分辨率、帧率及音频等信息,识别关键产品状态及其时间戳,确保与解说词对齐。平台方面,此技能适用于任何基于视频片段的编辑环境(如 HyperFrames、FFmpeg 等)。工作方式上,它强调在保留UI完整性和视觉效果之间取得平衡,通过剪裁决策矩阵决定是否、如何及何时进行裁剪,并使用过渡动画替代硬切以保持连续性。QA阶段要求检查首帧、缩放峰值、产品状态及字幕遮挡情况。最终输出包含裁剪/非裁剪决策、修剪/重定时段、渲染路径及关键证明帧。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

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

文档

产品演示集成

当最终视频中包含产品素材时,使用此技能。

素材审查

在编辑前:

  • 确定录制的时长、分辨率、帧率及音频。
  • 识别录制中是否包含画布、浏览器窗口、光标、缩放、滚动或空档时间。
  • 确定所需的产品时刻及其时间戳。
  • 识别必须与产品状态对齐的解说短语。
  • 在可能裁剪掉重要UI时,请在裁剪前获得批准。

裁剪决策

默认情况下,优先保留 UI 而非移除背景画布。

仅在以下情况使用裁剪:

  • 重要 UI 在缩放和滚动过程中始终保持可见。
  • 裁剪不会切掉标题、标签、光标上下文或最终状态。
  • 确认帧证明最缩放处仍然有效。

在以下情况使用无裁剪或轻度裁剪:

  • 录制在不同区域之间缩放。
  • 产品时刻在画布上移动。
  • 用户已表示裁剪输出切掉了关键文本。

参考 references/crop-and-zoom.md 获取检查清单。

过渡到产品素材

  • 从前一个场景的最后一帧开始。
  • 如果需要连续性,使用镜头平移或推拉运动而非硬切。
  • 停止在产品录制的当前第一帧。
  • 如果录制以空档时间开始,仅在不破坏同步的情况下修剪。
  • 如果产品时刻必须与解说词对齐,则重新定时该段之前的部分,而非更改之后的所有同步。

过渡出

  • 保留最后一个有意义的产品状态足够长的时间,让观众能够注意到它。
  • 如果需要,创建镜头平移到下一个场景。
  • 避免屏幕录制末尾出现意外的空白帧。
  • 在过渡边界处提取一个证明帧。

质量检查

  • 检查第一个产品帧。
  • 检查每个缩放峰值。
  • 检查每个必需的产品状态。
  • 检查进出过渡。
  • 确认字幕不覆盖产品 UI。

输出

返回:

  • 使用的源录制。
  • 裁剪/非裁剪决策。
  • 修剪/重定时段。
  • 渲染路径。
  • 最紧裁剪和关键产品时刻的证明帧。

产品时刻映射

在编辑前创建时刻映射:

  • 录制时间戳。
  • 可见内容。
  • 解说短语。
  • 期望的全局时间戳。
  • 光标是否重要。
  • 滚动位置是否重要。
  • 字幕是否会重叠。
  • 裁剪是否安全。

使用此映射来决定修剪和重定时。

裁剪决策矩阵

在以下情况选择无裁剪:

  • 用户接受画布/背景。
  • 缩放操作在屏幕上移动。
  • 主要文本被紧裁剪切掉。
  • 产品状态比“美观”更重要。

在以下情况选择轻度裁剪:

  • 画布分散注意力,但 UI 保持居中。
  • 字幕需要更多空间。
  • 可以安全地移除浏览器边框或空白边缘。

仅在以下情况选择动态裁剪:

  • 每个裁剪矩形都已映射。
  • 运动感觉有目的性。
  • 所有关键产品状态都有证明帧。

解说同步

将产品状态与口语短语同步:

  • 在短语开始前启动过渡,确保产品在短语开头时可见。
  • 如果理解需要,在短语结束后让最终产品帧保持片刻。
  • 减慢产品之前的内容速度,而非不自然地加速产品滚动。
  • 不要为了达到产品状态而在解说词中间断开单词。

屏幕录制清理

检查:

  • 光标可见性。
  • 浏览器 UI。
  • 通知弹窗。
  • 空档时间。
  • 空白加载屏幕。
  • 意外的桌面边缘。
  • 滚动速度。
  • 缩放焦点。

仅在不损害产品清晰度的情况下移除或隐藏这些内容。

字幕安全

如果字幕已烧录:

  • 检查底部导航栏。
  • 检查产品表格。
  • 检查模态按钮。
  • 检查时间线控件。
  • 如有需要,移动字幕边距或选择不同的证明帧。

用户批准点

在以下情况前需征得用户同意:

  • 裁剪掉可见的画布。
  • 移除光标。
  • 大幅加速素材。
  • 模糊或遮盖产品细节。
  • 用重新创建的 UI 替换真实素材。

交接格式

报告:

  • 使用的产品片段。
  • 裁剪策略。
  • 修剪点。
  • 重定时比例。
  • 关键证明帧。
  • 任何因设计原因而保持不完美的 UI。

相关技能