Communitygithub.com

产品宣传片

将您产品的真实界面转化为34秒的发布视频,分为五个章节(问题、承诺、产品运作、成果、行动号召),带有大光标、动态摄像机、字幕和音效,支持宽屏、方形和竖屏。当用户需要为其产品、应用或网站制作发布视频、产品推广片、演示视频、预告片或动态图形时使用。

产品宣传片 是什么?

Product Film 是一款专为 AI 辅助开发环境(如 Claude Code、Cursor 或 Codex)设计的技能,可自动从产品的真实屏幕录制和生成专业级发布视频。它采用结构化的五幕叙事格式(问题、承诺、产品运作、成果、行动号召),时长34秒(可根据需要延长至约40秒),输出三种宽高比(16:9、1:1、9:16)的MP4文件。该技能与 Puppeteer-core 配合使用,通过脚本捕获产品的真实用户界面截图和品牌元素,然后基于捕获的素材构建生成视频。其关键特点包括:通过光标动画与用户界面交互保持视觉同步、动态摄像机缩放和平移、可定制的颜色和排版、以及自动生成字幕和音效(包括技能内置的 Nu-Disco 曲目或用户提供的音乐)。技能严格遵循最佳实践:仅使用真实界面截图而非模拟图,引用需有来源支持,确保节奏留有呼吸空间(无超过1.8秒的死帧),并且光标在按下按钮时必须静止在目标上。它包含内置的质量检查流程(通过 `critique.md` 进行评分,评分低于8分不发布),支持迭代修订,并生成完整的交付物(视频、海报、字幕文本和补充文档)。该技能由 Omnigami 开发的演示示例“Lamplit”作为参考,并适用于任何需要制作产品推广视频的应用或网站。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/product-film

在你喜欢的 AI 中提问

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

文档

产品宣传片 是做什么的?

显式用户指令优先于本工作流。仅在授权产品和示例数据上工作。 请勿索取密码、API密钥、支付数据、政府身份标识、健康记录或其他敏感数据。 在将缺失的本地依赖项安装到工作项目之前,先解释清楚。网络访问仅限于 授权产品及其许可资产,以及声明的 npm 依赖项;尊重访问控制。 一次仅处理一个任务并等待其完成。将发布、发送和部署工作保留在此任务之外。

如果多个技能可执行此任务: 当请求未明确指定本技能,且您的代理还拥有其他制作同类型内容(其他发布宣传片、镜头、幻灯片或模型)的 Omnigami 技能时,请逐一列出它们,并在开始前询问用户想要哪一个。如果用户已指定本技能,或者它是唯一安装的技能,则直接进行。

对于日语、韩语或中文产品页面,保留该语言的文案,并将宣传片的 lang 设置为页面的 <html lang>;捆绑的 Noto 字体族和短语换行功能可处理文本处理。

制作一部推广单一产品的发布宣传片:以超大字体呈现问题,一行 承诺,在产品真实界面上展示四个验证步骤,展示成果, 以及一个持续到最后一帧的行动号召。从 reference/ 中的成品宣传片开始 (Lamplit,一款为 Omnigami 示例创建的虚构开发者工具;故事见 reference/STORY.md)。保留其工具箱(字体、光标、页面摄像机、颜色字段、 字幕列、绘图、音乐);将其文字、屏幕和步骤替换为用户的内容。

在构建前阅读 style.md,在评判前阅读 critique.md。

开始或恢复

  • 检查 Node 20+、ffmpeg 以及本地 Chrome 系列浏览器 (scripts/chrome.mjs 可找到它;CHROME_PATH 可覆盖)。解释任何缺失项。
  • 使用用户提供的内容:产品 URL、要展示或避免的内容、 行动号召(注册、安装、一个 URL)。在提问前先阅读网站。对于网站无法回答的内容,仅提问一次。如果用户希望不问问题或无人值守运行,则根据网站自行决定。
  • 如果 product-film/ 已存在且包含 film/STORY.md,则此为修订: 处理该宣传片。对于另一部宣传片,使用新文件夹并复用 PRODUCT.md 中的品牌说明。

设置第一个宣传片:

mkdir product-film && cd product-film
cp -R "$SKILL_DIR/reference" reference && cp -R "$SKILL_DIR/scripts" scripts && cp -R "$SKILL_DIR/music" music
mkdir film && tar -C "$SKILL_DIR/reference" --exclude='./assets/screens' --exclude='./assets/brand' --exclude='./plans' -cf - . | tar -C film -xf -
npm init -y >/dev/null && npm i -D 'puppeteer-core@^24'

film/ 是去除屏幕截图、品牌和计划的参考模板。 puppeteer-core@^24 运行在 Node 20 上;更新的主要版本可能需要更新的 Node。

SKILL_DIR 是本文件的文件夹。reference/ 保持不变,用于对比。

了解产品,然后编写故事

  1. node scripts/capture.mjs <url> capture:查看每个屏幕截图并读取 capture/brand.json。找出产品的功能、其自己的用语、品牌颜色和标志、 它声称的内容及每个声称的来源,以及其真实用户界面的可访问位置(页面本身、 实时演示、沙箱)。
  2. 按照 reference/STORY.md 的格式编写 film/STORY.md。它是一个完整的故事,而不是功能介绍:
    • 观众及其目标: 产品面向的对象,以及他们使用产品完成的一个主要任务, 使用网站自己的术语表述;
    • 问题 用户面临的障碍,由网站本身指出(钩子): 旧方式及其带来的代价,每一行都要被划掉;
    • 转折点: 用钩子自己的术语给出答案(用尽可能少的词表达问题的对立面), 在节拍内提及产品名称;
    • 三或四个步骤 在真实产品上朝着目标前进,每个步骤包含: 字幕(观众执行或学到的内容,几个词)、真实屏幕和要捕获的状态、 操作,以及屏幕上回答字幕的结果;
    • 成果: 目标达成;行动号召: 一个操作;
    • 120 BPM 网格上的时间点,以及每个声称及其来源。数字仅来自您引用的来源。 像陌生人一样阅读它:如果某个步骤的结果不符合其字幕,或者某个步骤没有朝着目标前进, 则进行修改。
  3. 用几行字向用户展示故事(五个幕、两个操作), 并请求一次审核,除非用户要求无人值守运行。切勿将沉默视为批准。

捕获真实屏幕

  1. 按照 reference/plans/lamplit.json 的格式编写 film/plans/app.json (格式位于 scripts/screens.mjs 顶部):
    • 故事中展示的每个状态,作为 click、type、drag(长按,用于应用自身的按下状态)和 capture 步骤;
    • 每个屏幕完整,比例为3,以便摄像机可以靠近移动;
    • 带 type 的输入字段,附带其面板的 around(每输入一个字母捕获一次);
    • rects:摄像机、颜色字段或光标使用的每个元素,按名称。 一套捕获服务于每种形状:每种形状自行框定内容。 使用 click 步骤关闭 cookie 横幅。对于宣传片自行绘制的内容,使用 hide。
  2. 运行:
    node scripts/screens.mjs film/plans/app.json film/assets/screens
    
  3. 查看每个捕获。修复计划直到每个状态正确。如果用户界面需要登录,则使用公共演示、用户提供的屏幕截图,或用户明确授权的已登录本地浏览器。切勿索要凭据。切勿捕获客户数据,也切勿绘制想象的界面。

构建宣传片

编辑 film/index.html。其部分标记为 KEEP(保留)、ADAPT(调整)和 REPLACE(替换)。

  • 调整文字: DEFAULTS 和 FIELDS,来自 STORY.md,包括步骤字幕(step1 … step4)及其在 STEPS 中的时间。
  • 调整颜色: 背景色(INK、NIGHT、INK2)、文本色以及来自产品的唯一强调色(参考模板为深色优先;浅色产品则使用其纸张和墨水色)。将产品标志放入 film/assets/brand/mark.svg;它在转折点出现,展开为一行文字,并引导组合设计。
  • 调整验证部分: P(每次点击和变化发生的时间)、screenAt(哪个捕获在屏幕上)、proofScene 中的取景(摄像机显示完整的页面矩形,竖屏使用更窄的集合)、floats(单个元素,在深色背景上单独展示)、PATCH(当状态在原地推进时唯一变化的区域:通过比较捕获的差异来测量)、SETTLED(每个步骤的结果在屏幕上稳定下来的时间),以及光标的 cursorSets。应用打开的页面通过切换到达;在原地变化的状态仅在 PATCH 内部变化。
  • 每次点击与光标同步: 使用 clickKeys 编写每个光标集合(其注释显示了 Lamplit 的三个示例)。光标滑入、到达并在目标上静止停留 0.3–0.5 秒,在应用自身的按下状态显示的精确时刻按下(相同的 P 时间驱动两者),在按下期间保持静止,然后离开。字段以相同方式点击;按下结束后开始输入文字,光标移开并在输入期间保持静止。切勿将光标的到达和离开置于点击的两侧:这会导致光标在按下时滑离按钮。删除 APPROVED_CURSOR 和 Lamplit 自己的集合(其已批准的剪切早于该规则)。如果光标未在目标矩形上静止,或在按下前 0.25 秒内移动,宣传片的检查将失败。
  • 调整成果和行动号召: TILES(您的三张真实屏幕截图)以及您的名称、地址、要输入的行和标语。将各幕时间保持在拍线上,并保持提示与各幕同步。
  • 保留 工具箱、摄像机、字段、绘图和 120 BPM 网格,并在观众需要的地方留出空间(style.md 中的“暂停”):每个步骤的字幕在其首次操作之前被阅读;每个结果稳定后,留出大约一秒阅读,然后再进行下一次摄像机或光标移动;页面切换或长距离滑动后,屏幕在点击前保持静止。保持生动:验证部分中没有死帧超过约 1.8 秒。当您的文字较长或较短时,调整保持时间(TU、ST、P),而不是产品自身的运作。当步骤需要超过 34 秒的空间时,每次增加一个小节(2 秒)延长宣传片,最多约 40 秒:同时移动 ST 和 DURATION,保持各幕的比例(style.md 中的“五幕”),并更新 STORY.md 中的时间。歌曲会自动适应新长度(它会在结束前至少 3.5 秒落在最后一根拍线上);使用 --music 时,将 music.sections 的最后一部分拉伸到新的小节数。

在项目根目录编写 PRODUCT.md:URL、产品功能、品牌颜色和标志(附带许可证)、选择的文字、日期。

审阅、渲染、交付

  1. 针对每种形状进行分镜表和手机检查:
    node scripts/render.mjs film --all --times key --sheet
    node scripts/render.mjs film --all --phone
    
    然后在每个推进、拉回和扩散处,针对宽屏和竖屏,生成 12 帧的条带:node scripts/render.mjs film --size 9:16 --strip <time>。
  2. 使用 critique.md 评分并修复最严重的问题。在交付前,获取新的判断。如果您的代理可以启动一个不包含本次会话记忆的子代理,则仅向其提供 critique.md、STORY.md 和图像,其他内容都不给,并修复它发现的问题。否则重新阅读 critique.md,仅从图像评分。低于 8 分不交付。三轮后,报告剩余的问题。
  3. 检查可重复性、新页面、长名称和宣传片自身的检查: node scripts/render.mjs film --all --check --check-fresh --stress。在所有三种形状通过之前不要渲染。仅在页面首次加载时存在的帧差异通常意味着图像在影片中期首次绘制:在 prepare() 中一次性绘制它。溢出的名称需要在其形状中适应压力测试长度。检查还会发现光标未在目标上静止的按下、光标移动时字段输入、结果在其下一次移动前不足 0.9 秒、字幕在点击前没有阅读时间、验证部分中超过 1.8 秒的死帧,以及长度偏离小节网格的问题。修复时序,而不是检查规则。
  4. 渲染:
    node scripts/render.mjs film --all --video --blur 4 --audio music/song.mp3 --sound --poster <time>
    
    这将生成 out/16x9.mp4、out/1x1.mp4 和 out/9x16.mp4:60 fps,带运动模糊,技能歌曲和效果,约 −14 LUFS。需要几分钟:在前台运行并等待所有三个文件完成后再交付。在无人值守运行中,留在后台的渲染可能会在会话结束时被截断。歌曲(music/song.mp3:120 BPM 的 nu-disco)已适配每种形状:它在拍线上开始,并在接近结束时落下一拍,在此处鼓点停止,其余部分关闭并渐淡(来自 music/song-stems/ 中的分轨)。--from <seconds> 从其另一个不同的 8 小节段落开始(歌曲长约两分钟)。--music 改用合成乐谱;用户自己的歌曲可通过 --audio their.wav 使用。
  5. 运行 node scripts/preview.mjs film 并提供其 localhost 地址。它播放每种形状并允许编辑文字;保存的编辑需要重新渲染才能更新 MP4。
  6. 编写 README.md(文件列表、如何预览、如何更改文字、如何渲染)和 out/CAPTION.md(一个不超过 280 个字符的帖子,使用产品自己的语言,包含其 URL)。交付 MP4 链接、海报、字幕文本、简短的检查摘要以及最能改进宣传片的一个改动。将详细得分放入 out/REVIEW.md。

修订

对于“让结果停留更长时间”或“改为展示导出”之类的请求,编辑当前的故事和宣传片。保留已批准的内容和用户保存的文字。仅重新捕获发生变化的状态,重新运行检查,再次渲染,并更新 STORY.md 和 PRODUCT.md。

硬性规则

  • 仅使用真实屏幕截图,必须捕获;仅使用示例数据;仅使用用户的品牌。
  • 屏幕上的每个声称必须在 STORY.md 中有来源。
  • 留出呼吸空间:每个步骤的字幕在有任何移动之前被阅读,元素在被操作之前被看到,每个结果在摄像机或光标下一次移动前大约停留一秒钟以供阅读。没有超过约 1.8 秒的死帧。当故事无法容纳时,每次增加一个小节(最多约 40 秒)或删除一个步骤;绝不压缩停留时间。
  • 光标在按下时静止在目标上,与应用自身的按下状态同步(clickKeys)。
  • seek(t, values) 仅从其参数进行绘制:不使用时钟、未播种的随机性、计时器或网络。使用 CPU 支持的画布,每帧重置。
  • 宣传片加载的每个文件都位于 film/ 内部。

文件

  • reference/:Lamplit 的发布宣传片、STORY.md、捕获计划(plans/lamplit.json)、捕获的屏幕截图、标志以及带有 OFL 许可证的字体(Instrument Sans、JetBrains Mono)。Lamplit 是一个为 Omnigami 示例创建的虚构公司。
  • style.md:语法和数字。critique.md:审阅标准。
  • music/:技能的歌曲及其分轨。
  • scripts/:screens.mjs(真实屏幕的状态捕获)、capture.mjs(从 URL 提取品牌)、render.mjs(静态帧、条带、检查、MP4)、preview.mjs、music.mjs、song.mjs(适配提供的歌曲)、sfx.mjs(包含音效工具包)和 chrome.mjs。

此技能属于 Omnigami,© 2026 Auberon LLC。您可以使用其制作的作品用于任何目的,包括商业用途,并可为自身使用修改此技能;但不得重新分发或出售该技能。完整条款见 LICENSE.md

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能