Communitygithub.com

cubeplexai/auto-demo-video

从场景描述到脚本,经 Playwright 电影级录制与高光提取,自动生成产品演示视频的通用流水线。

auto-demo-video 是什么?

此技能提供了一条从产品场景需求到最终高光演示视频的自动化流水线,名为 `auto-demo-video`。其核心设计理念是**通用性**:它不内嵌任何特定产品的逻辑,而是通过一个 `scenario.yaml` 文件(定义步骤、字幕和提示语)以及可选的外部适配器来接收产品特定的配置。开发者只需在自己的产品仓库中编写场景文件和适配器,然后通过一系列简洁的 CLI 命令(如 `adv plan`、`adv record`、`adv edit`、`adv render`)即可依次完成脚本规划、Playwright 电影级录制、智能剪辑(将原素材编辑到目标时长)和最终渲染。该技能支持所有主流 AI Agent 平台,包括 Claude Code、Cursor 和 Codex。它极大地简化了为 web 产品创建专业、可复现的演示视频的流程,尤其适合需要频繁更新演示内容或进行 A/B 测试的团队。详细的文档和 JSON schema 可在仓库的 `docs/` 和 `schemas/` 目录下找到。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add cubeplexai/auto-demo-video

在你喜欢的 AI 中提问

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

文档

auto-demo-video 是做什么的?

用于实时产品演示的通用流水线。

硬性规则

不要将产品特定的逻辑添加到 auto-demo-video 仓库中(例如工作区名称、品牌提示语、租户选择器、应用的 testid)。 请将这些内容保留在消费产品的应用/营销仓库中,并通过以下方式传递:

  • scenario.yaml(步骤、字幕、提示语)
  • adapter: ./path/to/adapter.mjs + adapterOptions
  • 环境凭证 / storage-state.json

命令

adv plan   --scenario <yaml> [--code-root <dir>]
adv record --script <script.json>
adv edit   --meta <meta.json> [--target-sec 90]
adv render --plan <edit-plan.json>
adv all    --scenario <yaml> --out runs/job

适配器

内置适配器:仅 generic-web。

外部适配器:

adapter: ./demos/adapter.mjs
adapterOptions:
  # 自由格式,供你的适配器使用

结构:export default { loginPath?, isAuthed?, afterLogin?, custom?, composerPlaceholders? }。

工作流程

  1. 在产品仓库中编写场景文件和可选的外部适配器。
  2. adv plan → 审查生成的 script.json。
  3. 设置 BASE_URL 环境变量和凭证(或存储状态)。
  4. adv record → 检查录制的元数据和截图。
  5. adv edit → adv render → 生成 final.mp4。
  6. (可选)在另一个项目中使用 Remotion 进行打包。

文档

  • docs/pipeline.md
  • docs/shotcraft-notes.md
  • schemas/*.json

相关技能