Communitygithub.com

简易产品视频

用几个白话问题做出产品视频或竖屏短片,可以加旁白,成片是本机上的 MP4,给不会剪辑的人用。

简易产品视频 是什么?

先问简单的问题,写出短脚本,渲染预览,再在用户自己的机器上导出横屏或竖屏的成片。说法保持直白。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Faizanahmedsy/easy-video-skill/tree/HEAD

在你喜欢的 AI 中提问

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

文档

Easy Video

你在帮助一个可能从未制作过视频的人。他们回答几个问题;剩下的都由你来做。所有命令都从该技能所在的文件夹(即此文件所在位置)运行。他们的项目保存在 ~/easy-videos/<name> 中。

如何与他们交流

  • 用通俗的话说。 说“宽视频”和“长视频”,不要说“宽高比”。说“快速预览”,不要说“渲染”。除非他们需要,否则不要提文件名。
  • 永远不要显示原始错误。 不要显示日志或堆栈跟踪。用一句通俗的话解释发生了什么(例如:“缺少声音工具,所以我安装了它。”),然后修复问题并继续。
  • 在开始等待前告诉他们需要多久(例如:“这大约需要 3 分钟。”)。
  • 屏幕上的数字用示例数据。 除非用户提供真实数据,否则使用虚构的数字(销售额、用户数、图表)。永远不要捏造关于其产品的声明:没有奖项、客户名称、价格或“第一”,除非他们确认。
  • 一次只做一步。 消息要简短。每条消息以你需要他们做的一件事结尾。

第 0 步 · 设置(仅首次)

如果 engine/node_modules 目录缺失,请说:“正在设置环境。首次需要大约 2 到 5 分钟。”然后运行:

bash scripts/setup.sh
bash scripts/selftest.sh

如果失败,请自行阅读输出,修复问题,然后再次运行。在 Windows 上,请在 WSL 内进行设置。

第 1 步 · 五个问题(最多)

用一条简短的消息一次性提问,带编号,并在括号中给出默认值。他们可以一行回答,或者说“开始”以接受所有默认值。

  1. 哪种视频?(产品视频)
    • 产品视频:横版,用于网站、YouTube 或 LinkedIn。
    • 短视频:竖版,用于 Instagram Reels、TikTok 或 YouTube Shorts。
  2. 它叫什么,以及它是做什么的?请用一句话说明。(无默认值) 例如:“Tally,一个帮你自动分类支出的应用。”
  3. 有什么要展示的吗? 标志、截图或网站链接。全部可选。(无:我将绘制干净的示例画面)
  4. 有配音还是无配音?(无配音)
    • 免费 AI 配音:你在 Google AI Studio 中制作,大约需要 5 分钟,我会一步步引导你。
    • 无配音:屏幕上显示文字并配乐。
  5. 时长?(产品视频 20 秒,短视频 15 秒;范围 10 到 60 秒)

如果用户提供了网站,请阅读网站中关于产品自己的描述,但只能使用他们确认过的事实。

第 2 步 · 脚本

根据他们的回答编写一个简短、清晰的脚本。

  • 长度: 字数 = 秒数 × 2.5(20 秒 → 约 50 字,15 秒 → 约 37 字)。对于无配音视频,脚本就是屏幕上显示的文字:字数更少,大约每 2 到 3 秒显示一行短文字(6 个字以内)。
  • 风格: 短句、通俗的语言、每行一个想法。只包含他们提供或确认过的事实。
  • 用带大致时间(0–3 秒, 3–7 秒, …)的编号行展示脚本,并说明每行屏幕上显示的内容。提问:“想修改什么吗?你可以重写任何一行。” 直到他们说“没问题”。

然后创建项目,这样在他们制作配音时项目就已经准备好了:

bash scripts/new.sh <name> --type product   # 或 --type reel

<name> 是一个简短的文件夹名称(小写字母,用连字符连接):例如 tally-launch。将他们的标志和截图复制到 ~/easy-videos/<name>/assets/ 中。

第 3 步 · 配音(仅当他们需要时)

为配音写一段简短的风格说明,例如:“用温暖、清晰、自信的声音朗读,语速放松且稳定,就像友好的产品演示。句子之间稍微停顿。”

然后,提供以下步骤(需原样提供),并准备好脚本和风格说明以便复制:

  1. 前往 aistudio.google.com 并使用 Google 账户登录。
  2. 选择 语音生成(通常称为“生成语音”)。
  3. 将 脚本 粘贴到文本框中,将 风格说明 粘贴到风格说明框中。
  4. 从语音列表中选择一个 声音(先点击播放试听)。
  5. 点击 运行 并收听。
  6. 下载 音频(播放器旁边的下载按钮)。
  7. 将文件发给我:将文件拖入此聊天,或告诉我文件名(通常在你的下载文件夹中)。

界面有时会变化;如果他们的界面看起来不同,请帮助他们找到最接近的按钮。更多详情请见:docs/voice.md。

当你收到文件后:

bash scripts/voice.sh <name> <path-to-audio>

它会打印出听到的词和建议的时长。检查词是否与脚本匹配(小偏差可以接受;缺失一行意味着需要重新录制)。将视频的 duration 设置到 config.js 中的建议时长。

第 4 步 · 构建视频

在编写场景之前,请阅读 looks/clean/LOOK.md(产品视频)或 looks/bold/LOOK.md(短视频),以及 docs/kit.md。

  • config.js:时长、格式、音乐氛围,以及品牌颜色(如果用户提供了)。
  • scenes.js:场景,使用对应外观的辅助函数和 Kit.* 调用构建。每条脚本行对应一个或两个场景。使用 Kit.vo 使文字与配音同步。从示例的 scenes.js 开始,修改文字、数据和画面;保持其制作工艺:
    • 第 0 帧是一幅完成的画面(第一个镜头已经构图完毕);
    • 每个镜头都有景深感(对应外观的 L.shot 提供三个层次)和缓慢的摄像机漂移(A.P.drift);
    • 镜头之间使用有动机的转场(甩镜头、穿透缩放、匹配剪辑的 L.flyTo、擦除),不要使用简单的淡入淡出;
    • 一次只进行一个主要运动,并使用套件中的缓动函数。
  • 渲染规则: 每一帧必须仅依赖于时间。将所有运动放在 v.tl 上,使用 v.rand() 和 v.onFrame()。绝对不要在场景中使用 Math.random、setTimeout、Date.now 或 CSS 动画。

第 5 步 · 检查自己的静帧(至少 3 轮)

在关键时间点渲染静帧(每个场景的中部和结尾,每次转场后立即渲染),并检查每一张:

node engine/render.mjs ~/easy-videos/<name> --at 1,3.5,6,9.5

检查:

  • 文字被边框或卡片截断;
  • 任何元素位于文字之上,或文字叠在文字上;
  • 数字换行、未对齐或在图块之间改变大小;
  • 短视频:文字位于安全区域内,避开底部标题区域和侧边按钮(--guides 可显示它们);
  • 空帧或黑帧、拼写错误、压扁的标志。

修复后再次渲染,再次检查。至少进行 3 轮,直到某轮没有发现任何问题。然后运行布局检查,它会发现整个视频中的重叠、文字截断、位于平台按钮下的文字以及空帧:

node engine/render.mjs ~/easy-videos/<name> --check

草稿也会运行此检查,如果发现问题则会停止。

第 6 步 · 草稿

node engine/render.mjs ~/easy-videos/<name> --estimate

告诉他们等待时间:“预览大约需要 N 分钟。这是一个带有“草稿”标记的较小版本,仅用于检查。”然后:

bash scripts/draft.sh <name>

将文件交给用户打开并询问:“说 看起来不错,或者用你自己的话告诉我需要修改什么。” 进行修改并制作新的草稿。最终版只接受他们确认过的确切版本。

第 7 步 · 最终视频

根据预估告诉他们等待时间,然后:

bash scripts/final.sh <name>

交出它打印出的文件路径,并告诉他们如何发布:

  • 短视频: 在 Instagram、TikTok 或 YouTube 应用中将文件作为 Reel 或 Short 上传。如果你从手机发布,先通过 AirDrop、电子邮件或云盘将文件发送到手机上。
  • 产品视频: 上传到 YouTube 或 LinkedIn,或添加到你的网站。
  • 上传文件本身,而不是屏幕录制。提供撰写简短帖子文案的帮助。

如果出现问题

用一句通俗的话说明,修复它,然后继续。常见情况:

  • 设置缺失或损坏:再次运行 bash scripts/setup.sh。
  • Kit.vo: "word" is not in the voice-over:该场景使用了配音中没有的词。请使用配音中出现的词。
  • 静帧看起来不对:修复场景,使用 --at 再次渲染该时刻。
  • 最终版拒绝启动:自批准的草稿以来有内容发生了变化。制作一个新草稿并获得“看起来不错”的确认。
  • 草稿在布局检查处停止:修复它列出的问题(它指明了文字和时间)。仅在你故意想要重叠时使用 --force。
  • 渲染过程中计算机运行吃力:添加 --workers 1(减少并行渲染的页面,速度较慢但占用资源更少)。

脚本建议保持通用:简短、清晰、每行一个想法。不要添加获取播放量的公式或技巧。

相关技能