Communitygithub.com

影片配音

在產品影片的畫面通過審核後,編寫、審查、測試和錄製配音,以故事板形式呈現,包含方向選擇、閉眼連貫性檢查、產品名稱發音測試、按段落進行 TTS 錄音(Fish Audio)、將台詞放置在影片時間軸上、混音和封裝。屬於 product-film 的第五階段。

影片配音 是什麼?

Film-voiceover 是一個專為 AI 代理設計的技能,用於在產品行銷或宣傳影片的畫面最終定稿後,自動化生成專業配音。此技能的核心在於「畫面先行」:所有配音必須嚴格配合已批准的畫面,除非所有者要求,否則不調整畫面去遷就聲音。技能涵蓋三個閘門:首先是理解每個鏡頭的用途,基於真實畫面框架撰寫多個方向(如提供提示、解釋困擾、展示運作、回答疑問)並讓所有者選擇;其次是處理產品名稱等特殊詞彙的發音,透過測試不同拼寫方式,找到 TTS 引擎正確發音的映射;最後是逐段錄製(使用 Fish Audio)、精確切割成短語並放置到時間軸上,確保關鍵字與畫面或螢幕文字同步,並進行混音和封裝。這個技能特別適合用於啟動或宣傳影片需要旁白,或當所有者反映配音聽起來像 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 · 方向與腳本(尚未錄音)

  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,包含每行時間範圍和「每個主張的來源」。進行提交。

閘門 2 · 發音(在完整錄音之前)

  1. 詢問產品名稱(以及任何其他不常見詞彙)的所有者是如何發音的(例如「WIZ-get,硬 g」)。
  2. 測試不同拼寫,每個一個簡短片段(一個包含該名稱的短句):純名稱、加連字符、雙寫輔音(例如「Nimbet」、「Nim-bet」、「Nimbbet」)。一次錄取多種拼寫會導致片段變短且混淆。每個檔案以其拼寫命名。發送這些片段;由所有者挑選。
  3. 將獲勝的拼寫記錄在 vo.json › voice.note 和 VO-SCRIPT.md 中,並記住以供未來影片使用。如果引擎發音錯誤,切勿將正確拼寫發送給引擎:需一律發送重新拼寫後的版本。

閘門 3 · 錄音、放置、混音

  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(<story t>)" 獲取影片時間。執行 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).

相關技能