Communitygithub.com

產品影片

製作一支專業的產品發表、宣傳或解說影片,看起來不像 AI 生成,透過逐步審核關卡,讓產品擁有人逐項簽核。

產品影片 是什麼?

此技能提供一套完整的產品影片製作流程,從簡報、參考影片分析、分鏡腳本、程式碼建置、音效配樂到旁白錄製,最終產出 16:9 與 9:16 兩種格式。它強制要求每個階段都必須經過產品擁有人的明確批准才能進入下一階段,避免浪費時間在未經確認的渲染上。此技能支援 Claude Code、Cursor 等 AI 代理平台,並內建了從真實產品校訂中學習的經驗規則,確保影片內容真實、具體、非 AI 感,且符合品牌規範。其工作流程包含 8 個關鍵關卡,每個關卡都有專屬的審查機制與問題庫,協助開發者與產品擁有者進行高效溝通。

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

在你喜歡的 AI 中提問

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

說明文件

產品影片 是做什麼的?

一支產品影片首先由一個人評斷:產品擁有人。他們指出錯誤,你修正,影片便一輪一輪地變得更好。這個技能的存在,是為了讓你盡量避免產品擁有人的修正:這裡的每一條規則,都來自於過去有人必須手動修正的錯誤。開始前請先閱讀 references/lessons.md,並在每次提交審查前再次閱讀。這份文件記錄了產品擁有人拒絕了什麼,以及原因。

流程與關卡

在產品擁有人批准當前階段之前,不得進入下一階段。批准是在對話中明確說「好」,而不是沉默或「看起來不錯,但是……」。產品擁有人要求任何變更後,都必須再次送審。

階段技能你送審的內容關卡
0 · 簡報本技能簡報:產品、買家、必須說服他們的一件事、長度、格式、播放位置產品擁有人批准簡報
1 · 參考影片film-reference-study參考影片的作用以及要借用什麼,以數字和畫面呈現產品擁有人同意借用與不借用的部分
2 · 分鏡腳本film-storyboard分鏡頁面:每個節拍一張畫面、螢幕上的文字、每個節拍存在的原因;若故事開放,提供 2–4 個方向產品擁有人選擇方向並批准節拍
3 · 畫面film-build先送靜態圖,然後送 30 fps 草稿,絕不先送最終渲染產品擁有人批准畫面(「渲染最終版」)
4 · 音效film-sound附有音效的最終版,以及音樂決定產品擁有人批准音效
5 · 旁白film-voiceover在真實畫面分鏡上的腳本,然後是名稱測試,最後是配音剪輯產品擁有人批准腳本、發音,然後是剪輯
6 · 格式film-build(格式)9:16 靜態圖,然後是 9:16 渲染產品擁有人批准;16:9 格式保持不變
7 · 交付本技能檔案、字幕、感謝名單、未驗證的項目完成

「渲染前讓我審查」:產品擁有人希望在花 30 分鐘渲染之前,先看到計畫和靜態圖。未經批准的草稿就進行最終渲染是浪費時間,也會消耗他們的信任。

如何提問(每個關卡)

在每個關卡,提出具體的選擇而非開放式問題,並且讓每個選項都是真實剪輯師會挑選的。一般性的選項(「現代」、「乾淨」、「動態」)是影片變成 AI 產物的原因。references/question-bank.md 包含每個階段的問題和選項:外觀、動態、節奏、轉場、打字、角色、音效、音樂、旁白、交付。規則:

  • 每個問題提供二到四個選項,並說明每個選項的外觀或聽感,以及其成本或風險。把你的首選放在第一個,並用一句話說明原因。
  • 只問會改變工作的問題。其餘部分根據品牌和參考影片來決定,並說明你的決定。
  • 當產品擁有人隨意提出想法時,不要逐一實現。先進行研究,然後回來提供 2–4 個方向及其取捨,讓他們選擇(「給我一些方向及其取捨,讓我可以決定」)。
  • 當產品擁有人說「等等,我再告訴你更多」,就停下來等待。不要繼續編輯。
  • 當收到修正意見時,找出其背後的規則,並檢查整個影片是否犯同樣的錯誤,而不僅是他們指出的那一處。

每個階段都適用的規則

  1. 必須真實。 影片中的每個功能、小工具、螢幕、數字來源和宣稱,都必須是目前產品中實際運作的。如果影片需要的功能產品無法做到,要嘛在產品中建置它(並記錄此決定),要嘛放棄它。每個口頭或畫面上的宣稱,都必須有可追溯的來源(檔案、文件、測試)。
  2. 具體而非一般。 使用品牌官方網站的真正標誌。使用實際存在於該作業系統上的真實應用程式和真實 OS 介面。使用真實的裝置尺寸。使用真實的壁紙(需取得授權)。豐富、詳細的產品 UI:「太過簡單」會讓人覺得「我為什麼要付錢買這個」。請參閱 film-build/references/realism.md。
  3. 從觀眾的角度出發。 影片是為了一個從未聽過該產品的陌生人而製作。測試每一個節拍:他們能理解嗎?他們會誤解嗎(例如,認為產品就是 AI)?影片是關於他們的生活,還是關於我們的功能?
  4. 不能看起來像 AI 製作。 沒有合成音效、沒有簡約的模型、沒有模仿真實品牌的圖示字型、沒有「你的 X,你的 Y」這類文案、沒有描述場景的旁白。產品擁有人知道這些特徵,他們的買家也知道。曾有一個競爭對手因其發表影片「看起來像用 Claude 製作的」而公開受到抨擊。
  5. 可讀且流暢。 每行文字停留的時間都足以讓人讀完。打字效果看起來像真實鍵盤。沒有任何片段被裁切、重疊或閃現空白。節奏要符合人類:初次剪輯幾乎總是太快。
  6. 確定性。 影片是時間的純函數;在送出任何渲染之前,render.mjs --verify 必須通過。
  7. 簡短且誠實的報告。 當你送出審查時,說明變更了什麼、哪些仍然未定,以及你無法檢查的部分(你聽不到音訊:請說明並提問)。絕對不要將你未檢查的項目標示為已驗證。
  8. 頻繁提交(程式碼、腳本、分鏡腳本、旁白腳本)。渲染、音訊和靜態圖則不納入 git。

專案目錄結構

<film>/
  brief.md                 stage 0
  reference/               研究輸出(畫面、試算表、summary.md、NOTES.md)
  storyboard.json          stage 2 來源 → review/storyboard.html
  film/                    影片頁面(core.js、film.js、mock.js、index.html)
  scripts/ tools/          渲染、同步、音效、旁白、混音、探測(來自 film-build 的工具包)
  timeline.json vo.json    畫面時間和音效提示;旁白片語
  VO-SCRIPT.md             已批准的旁白,包含每個宣稱的來源
  assets/                  字型、標誌、壁紙、音效、角色、CREDITS.md
  renders/ audio/ review/  (git 忽略)

從 sh ~/.claude/skills/film-build/kit/init.sh <film> 開始。

階段 0 · 簡報

在開始任何其他工作之前,撰寫 brief.md 並獲得批准:

  • 產品,用一句陌生人也聽得懂的話描述。 不是標語。
  • 誰會購買,用他們自己的話來說。 如果產品服務於多種人,則列出幾種不同的人(人物誌):他們每天檢查或需要什麼。
  • 影片必須說服他們的一件事,以及必須避免的一個誤解。
  • 可用的證明: 目前什麼是真實的、什麼已經建置並記錄、什麼可以展示。
  • 長度與格式: 一個展示範圍的發表影片大約需要 45–65 秒。20 秒太短,無法展示多個人物和使用情境。格式:先做 16:9,再做 9:16,除非產品擁有人另有指示。
  • 播放位置(網站首頁、X、Reels、YouTube)以及品牌規則(顏色、字型、禁止使用的詞語、標誌)。
  • 產品絕對不能呈現為什麼(例如「永遠不要放在 Dock 上」),以及需要避開的任何競爭對手。

階段 7 · 交付

  • renders/16x9.mp4 和 renders/9x16.mp4(60 fps,動態模糊,旁白和音效已混合)。
  • assets/CREDITS.md:每個壁紙、標誌、字型、音效和角色,附上其授權。
  • 如果出現品牌:在它們顯示時於畫面上加入一段合理使用的文字聲明(「產品名稱和標誌屬於其各自所有者……」)。
  • 一份未驗證項目的簡單清單(例如「這四個請求尚未在真實應用程式中建置」)。
  • 根據要求提供字幕和縮圖(使用產品擁有人的社群和文案技巧;沒有 AI 特徵)。

影片完成後

將產品擁有人提出的每一個新修正,添加到 references/lessons.md 中,歸入其所屬的階段,並說明錯誤內容以及避免它的規則。這個檔案是讓下一支影片能比這支更進一步的基礎。

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

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.

相關技能