Communitygithub.com

產品影片腳本大綱

將產品影片的故事拆解為節拍(觀眾看到的、螢幕上的文字、旁白、音效、該節拍存在的原因以及每項主張的證明),並以一頁分鏡腳本附上畫面草稿的方式提交給業主審查;若故事方向尚未確定,則提供 2–4 個方向。這是 product-film 的第二階段,審查格式也延用於後續的旁白錄製。適用於規劃發表/宣傳影片的故事、鏡頭清單或腳本,或是當業主說「給我一個分鏡腳本」、「給我幾個方向」、「我來審查並決定」時使用。

產品影片腳本大綱 是什麼?

此技能旨在協助 AI 助理產生產品宣傳影片的詳細分鏡腳本,專注於建立一個以「節拍」為基礎的結構化故事敘述。它會引導使用者按照嚴謹的品質標準(如具體性、角色識別、實證性與可讀性)逐步起草分鏡,並自動產生可審查的 HTML 頁面。當故事方向尚未確定時,它會主動提供 2 到 4 個創意方向,每個方向都附有核心概念、風險評估與適合的觀眾群,協助業主做出決策。支援的平台包括 Claude Code 等可執行 Python 腳本的工具。其運作方式是先讀取已批准的簡報與專案筆記,接著在 `storyboard.json` 中建立結構化的節拍資料(包含時間、旁白、圖像與宣稱證明),最後執行 Python 腳本將其轉換為包含所有方向旁白與畫面草稿的單頁 HTML 審閱頁面。此技能強烈建議在進入實際製作或錄音前先進行審查,因為在分鏡階段修改文字的代價遠低於後期的渲染或錄音。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

產品影片腳本大綱 是做什麼的?

分鏡腳本階段應該發生大部分的業主修正,因為修改一句話只需要一分鐘,而修改一個已經渲染好的鏡頭則需要一小時。請在開始實際製作之前就送交審查,並且在錄製旁白之前,再次送出包含真實畫面的版本。

好的產品影片故事應具備哪些條件

請用以下標準檢查每一個節拍。每一條標準都來自於被退回的草稿(詳見 product-film/references/lessons.md)。

  1. 觀眾的痛點,要用他們的日常用語來表達。 說出那個習慣或困擾時,要用觀眾自己會說的方式。測試這句旁白:陌生人聽完之後,會覺得我們在賣什麼?「每天都是同樣的數字」這句話讓人聯想到數據分析軟體,所以不合格。
  2. 角色不能讓人誤會。 用實際的工具名稱和 Logo 來展示。檢查每一對相鄰的台詞:「問你已經在付費的 AI。它叫做 Nimbet。」這會讓產品聽起來就是那個 AI。要把產品名稱和它的實際功能綁在一起。
  3. 要具體,不要抽象。 「你的 AI」這種標籤不夠清楚;Claude Desktop 的真實視窗就很明確。一個真實的 Stripe 後台畫面,比一個標著「營收」的方框更好。
  4. 多樣性需要足夠的篇幅。 如果產品的承諾是「你需要的一切」,就要展示 8 種以上不同類型的人(每個人都用全螢幕卡片呈現),接著是一個混合了工作、生活與娛樂(遊戲、寵物、貼紙)的豐富物品牆。少於大約 6 種就會「感覺有限」。這需要 45–65 秒;20 秒太短了。
  5. 只能用真實的內容。 每一個項目、功能和宣稱都必須是產品現在就能做到的。請在 claim 欄位中填寫其證明來源(一個檔案、一份文件、一個測試)。如果故事需要一個產品做不到的功能,請向業主提出:要嘛做出來,要嘛刪掉。
  6. 在寫之前,先理解每個鏡頭的用途。 為每個節拍寫下 why。如果你說不出一個鏡頭的目的,就去問業主。(曾經有一句關於寵物的台詞,被寫在一個實際上是展示使用者自訂小工具的畫面上。)
  7. 每行文字都要讓觀眾看得完。 螢幕文字:每個字約 0.3 秒 + 1 秒基礎時間,最短不能低於 1.5 秒完全顯示。
  8. 以行動呼籲作為結尾。 最後要出現產品名稱和網址,如果影片中有出現任何品牌,再加上合理使用的聲明。

步驟

  1. 閱讀已批准的簡報、reference/NOTES.md、實際產品與網站,以及經驗教訓文件。
  2. 起草節拍到 storyboard.json(格式請參考腳本檔案的開頭):
    { "title": "…", "subtitle": "草稿 1 · 16:9 · 60 秒", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                   "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    在影片尚未完成之前,still 可以是一張快速草圖或參考影片中的某個畫面加上註記;但之後,一定要使用真實的渲染畫面(使用 node scripts/render.mjs --at … 指令產生)。
  3. 方向。 當故事角度尚未確定時,請撰寫 2–4 個方向,這些方向應該在核心概念上有所不同,而非只是文字表達上的差異(例如:「觀眾能立刻使用的技巧」、「日常的煩惱」、「你的 AI 已經知道你什麼」)。針對每個方向提供:一句話的核心概念、風險,以及適合的對象。把你推薦的方向放在第一個。
  4. 建立審閱頁面:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    這個頁面會先以一段段落呈現每個方向的完整旁白(閉著眼睛聽一遍的那種方式),然後才是每個節拍及其對應的畫面草稿。
  5. 送出前自我檢查: 只閱讀旁白段落。閉上眼睛聽起來合理嗎?有沒有任何一句台詞可能被誤解?有沒有「你的 X,你的 Y」這種列舉、三句式或重複的字詞?有沒有任何宣稱缺乏證明?
  6. 審查關卡。 送出審閱頁面(使用 SendUserFile 或顯示渲染結果),並詢問:喜歡哪個方向,以及哪些節拍需要修改。加上來自 product-film/references/question-bank.md 的第二階段問題(關於開場、角色如何呈現、人物簡介格式、角色、UI 真實性等)。等候明確的回覆。確認後提交 storyboard.json。

核准之後

以 storyboard.json 作為唯一的事實來源:影片中的鏡頭時間與旁白的詞語位置都從這裡產生。當業主後續要修改某個節拍時,先在這裡修改,然後重新產生頁面。

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-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

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).

相關技能