Communitygithub.com

影片旁白

在产品影片画面定稿后,基于真实帧故事板编写、审核、测试并录制旁白,提供多方向选择、闭眼连贯性检查、产品名称发音测试、逐段TTS录制(Fish Audio)、短语在时间线上的放置、混音与合成。这是 product-film 流程的第五阶段。适用于需要为发布/推广影片添加解说,或负责人认为旁白听起来像AI、与画面不匹配、或产品名称发音错误的情况。

影片旁白 是什么?

该技能为 AI 代理提供了一套完整的自动化工作流,用于在产品影片画面批准后为其制作专业旁白。它适用于 Claude Code 或 Cursor 等平台,用于生成、审核、测试并最终将旁白语音与影片时间线精确同步。该技能分为三个严格的门控阶段:第一,编写方向稿和脚本,强调理解每个镜头目的,提供多种旁白方向(如用户提示、日常烦恼、工作原理、答疑),并通过真实帧故事板进行闭眼连贯性检查;第二,测试产品名称发音,通过不同拼写(如连字符、双辅音)生成多个短音频样本,由负责人选择正确发音;第三,录制旁白(使用 Fish Audio TTS API)、按短语精确放置以确保关键词与对应画面同步、混音(遵循 -14 LUFS 响度标准)并最终合成输出。其核心价值在于确保旁白与画面完美配合,去除 AI 感,处理生僻词汇发音,并通过清晰的可视化时间线表落实每一句台词与画面的对应关系。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-voiceover

在你喜欢的 AI 中提问

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

文档

影片旁白 是做什么的?

声音必须在画面批准之后添加,并适配画面。除非负责人要求,否则画面绝不为了适配声音而移动。在动笔之前,请阅读 references/writing.md(其中包含每个被拒绝的模式及其前后对比),并对每版草稿应用文案优化和人性化润色技能。

第一道关卡 · 方向与脚本(暂不录制)

  1. 理解每个镜头。 针对 storyboard.json 中的每个节拍,用一句话写出该镜头的作用。如果写不出来,请问负责人。只描述镜头看起来显示的内容(例如墙上的小物件上的宠物)曾遭拒绝。
  2. 方向。 当画面角度开放时,写出 2–4 个完整的方向,每个方向给观众的内容不同,例如: 观众可以用的小窍门 · 日常烦恼 · 工作原理 · 答疑解惑(关键安全、成本、平台)。对每个方向,提供:完整脚本、其优势、其风险。把你选中的方向放在最前面。
  3. 在故事板上放置真实的画面帧:为每个节拍渲染一帧静止画面(node scripts/render.mjs --at …),在 storyboard.json 中根据每个方向设置 vo,构建 review/storyboard.html(使用 film-storyboard 的脚本)。页面打开时每个方向作为一个段落显示:即闭眼可读的版本。
  4. 自我检查,使用 references/writing.md 中的五项测试(闭眼测试、画面测试、陌生人测试、废话扫描、声明核实)。
  5. 发送故事板;询问负责人选择哪个方向以及需要修改的内容。从 product-film/references/question-bank.md 中询问旁白相关问题(声音、目标受众、语气、旁白量)。迭代直到获得明确的肯定答复。将批准的脚本写入 VO-SCRIPT.md,每行标注时间范围以及“每项声明的来源”。提交更改。

第二道关卡 · 发音(在全片录制之前)

  1. 询问产品名称(以及任何其他不常见词汇)的发音方式,用负责人自己的话描述(例如:“WIZ-get,硬 g”)。
  2. 测试不同拼写,每个一个短片段(包含产品名称的短句):普通拼写、带连字符拼写、双辅音拼写(例如“Nimbet”、“Nim-bet”、“Nimbbet”)。一个片段中包含多种拼写会导致结果简短且混淆。按拼写命名每个文件。发送给负责人,由负责人选择。
  3. 将胜出的拼写记录到 vo.json › voice.note、VO-SCRIPT.md 中,并记录到供未来影片使用的记忆中。切勿将正确的拼写发送给发音引擎(如果它发音错误):需发送重新拼写的版本。

第三道关卡 · 录制、放置、混音

  1. 先注意额度: 检查 TTS 余额。Fish Audio:每次调用最多约 500 字节,按字节计费。按节拍分段录制(audio/vo/l1.wav、l2.wav…),不要一次调用录制整个脚本。
  2. 声音: 使用负责人从样品中选择的声音(对于一部节奏舒缓的产品影片,Fish 的“Ethan”曾被批准)。通过每句短语的 tempo ≤ 1.1–1.15 来调整语速;切勿加速整个片段。
  3. 切分为短语: python3 scripts/vo.py --scan 列出每段录音中的语音片段;在 vo.json 中编写短语,包含 take、from、to、text。
  4. 放置每个短语的 at(节拍 = 视频秒数 × 2),使其关键词与对应的画面或屏幕文字对齐。使用 node tools/probe.mjs cuts 和 "window.UNWARP(<故事时间>)" 获取视频时间。运行 python3 scripts/vo.py 直到报告 overlaps: none;短语之间保持 ≥ 0.25 秒的间隔。
  5. 混音和合成: 运行 python3 scripts/sfx_samples.py && python3 scripts/mix.py(-14 LUFS,≤ -1 dBTP;人声 0,音效约 -10,背景音乐按负责人选择),然后运行 node scripts/render.mjs --mux [--fmt 9x16]。
  6. 发送配音后的剪辑,同时附上脚本和一张表格,标明每句台词落在时间轴的哪个位置。说明你无法听到音频;询问负责人关于发音、语速、音量以及任何台词是否落在错误画面上。迭代。提交 vo.json 和 VO-SCRIPT.md。

当画面之后发生更改时

重新测量、重新放置短语(at)、重新混音、重新合成。对于 9:16 格式,如果时间码共享,相同的 audio/mix.wav 文件仍然有效。

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

相关技能