营销视频
该视频是一个HTML页面,其中每个像素都是时间的纯函数 seek(t),逐帧渲染带有运动模糊和精确到毫秒级的音轨。所有与品牌相关的内容均来自用户输入,不做任何假设。使用用户的母语进行沟通。以下 SKILL_DIR 指包含此文件的目录。
0. 首次运行:依赖检查
bash SKILL_DIR/scripts/check_deps.sh
该脚本会列出当前机器缺失的工具(node 18+, ffmpeg, python3, numpy),并给出对应系统的安装命令。如果缺少任何依赖,请用通俗的语言向用户说明每个工具的用途,显示安装命令,并征求用户意见是否安装。仅在用户同意后执行安装,然后重新运行检查。需要用户密码或打开自带安装程序(Homebrew、sudo)的命令,应提示用户在自有终端中运行;将命令提供给用户并等待其完成。在此期间可以同时进行用户需求收集:在步骤2之前,其他操作不依赖于工具。
1. 需求收集:首先询问所有信息
将 references/intake.md 中的问题一次性发送给用户。在构建任何内容之前,必须收集以下信息:
- 主题:视频的内容、目标受众、发布平台;
- 灵感视频:最重要的输入;
- 设计系统,或明确允许使用中性默认值;
- UI截图(当视频展示产品时)。
每个输入最终必须成为本地文件:要求用户提供下载,或当工具允许时自行获取。其他所有内容都有明确的默认值。如果某个必需项在提醒一次后仍未提供,则不启动依赖它的任何内容;对于灵感视频,可以提供引擎自身的风格(一个连续变形的形状),并在用户接受后继续。
创建项目,然后将答案记录在 brief.md 中:
bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug> # 模板、脚本、本地 Playwright
cd ~/marketing-videos/<slug> # 后续所有命令在此目录下运行
2. 分析灵感视频并确认理解
python3 inspect_inspiration.py <video> # 接触表、剪辑分析、镜头时长、音乐节奏
查看两个接触表,然后写一段不超过十行的风格解读:连续变形或剪辑切换、每节拍的事件及状态保持时长、摄像机运动、缓动效果、调色板、字体、声音。展示给用户并询问保留哪些内容。用户提供的书面指导(规则、禁止项、结构)优先于你的解读。如果用户提供了音乐,立即测量其节奏(python3 inspect_inspiration.py track.mp3),并在节拍网格之前将 CONFIG.bpm 设置为该节奏。
3. 节拍网格上的状态列表,然后等待批准
一个表格,每拍一行:时间、屏幕上的状态、运动方式、光标行为、摄像机。 references/craft.md 规定了规则。在用户批准之前不要构建任何内容。 在此处迭代只需一分钟;在构建后迭代则需一小时。
4. 构建
编辑 scene.html:配置 CONFIG(节奏、节拍数、循环或结尾卡片、令牌、字体),然后替换示例场景。首先阅读 references/craft.md:它包含了引擎、运动规则和注意事项。
- 字体:将品牌字体文件放入
fonts/目录(将Google字体下载为woff2格式)并在fonts.json中列出;CONFIG.font首先引用其中一个字体家族。python3 build.py会将字体内联到代码中。 - Logo:直接粘贴品牌的SVG。切勿用字体重打字标。
- 截图仅仅是用于简化的HTML重现的参考,绝不能作为图片粘贴。
- 真实视频素材:使用
python3 frames.py --src clip.mp4 --name <who> --sheet选择一个干净的窗口,然后将其裁切到帧的宽高比进行提取。素材以静音播放,除非其声音在步骤5中混入。
5. 验证,然后添加声音
python3 build.py && node preview.mjs # 每种格式的接触表,每个节拍一帧,控制台输出和字体错误
node checks.mjs # 检查按钮点击是否在按钮内,指针是否在文本上
两者默认输出 1440×1440 和 1080×1920 格式;可通过 1920x1080 参数传递其他尺寸。检查每个接触表,修复所有偏离网格、拥挤、在手机尺寸下难以阅读或应在完成状态但仍在过渡中的内容。checks.mjs 必须在每种格式下通过;在 window.CHECKS 中声明每个新的点击和每个需要保护的文本。
python3 audio.py 根据场景节奏合成背景音乐,并将每个 window.CUES 声音按其测量的峰值定位。--music track.mp3 --offset <s> 使用用户的音轨;--voice clip.mp4:at:start:dur 将拍摄人物的语音混合,并降低其下的音乐音量。
6. 渲染并交付
node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav
每个交付的版本使用新的文件名,并在交付时将其源文件复制到 versions/v<N>/ 目录。切勿在渲染完成前覆盖已交付的文件。将MP4复制到用户指定的位置,并报告更改内容、通过的检查以及为用户做出的任何判断决定。
7. 迭代
遵循 craft.md#iterating 的规则:仅更改指定的部分,拉伸时间而非重新编排舞蹈,每次更改后重新运行 preview.mjs 和 checks.mjs。
要求
项目文件夹应自包含。脚本需要 node 18+、ffmpeg 和带有 numpy 的 python3(步骤0会检查并安装缺失的依赖);setup.sh 会在每个项目中添加 Playwright 的 Chromium。如果项目位于有自身规则仓库中,则遵循其规则,并将渲染结果、视频素材、帧文件和 node_modules 排除在版本控制之外。