Communitygithub.com

freudianflips/breakout-launch-videos

製作或變更品牌專屬的產品上市影片。一部影片由鉤子(剪接前的故事)與主體(品牌名稱、主打文字、產品特寫、標誌鎖定畫面)組成,使用 HyperFrames 根據 brand/brand.json 和 film/film.json 建構。

breakout-launch-videos 是什麼?

這個技能提供一個完整的模板化工作流程,用於建立產品上市影片。它將影片結構定義為「鉤子」(hook,剪接前的故事部分)加上「主體」(body,品牌、產品與標誌的標準段落)。所有品牌元素(顏色、字型、標誌)都來自 brand/brand.json 檔案,確保品牌一致性。使用者可以透過在 film/hooks/ 目錄下建立新的鉤子資料夾和 JSON 檔案來新增鉤子,或透過修改 film/film.json 或主體 HTML 範本來變更主體。該技能支援多個平台(如 Claude Code 等 AI 代理工具),並包含用於建置、渲染、混合音訊、檢查同步和音量、以及管理素材版權的腳本。其設計強調嚴謹的品質檢查,例如使用強制對齊確保語音與文字同步,以及確保音量符合 -14 LUFS 的廣播標準。

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

在你喜歡的 AI 中提問

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

說明文件

上市影片

此處的每一部上市影片都是一個鉤子加上主體。鉤子是剪接前的故事(4 到 18 秒,任何想法皆可)。在音樂的鼓點落下時,畫面切換到您的品牌,主體點出產品名稱、逐拍展示產品特寫、將功能收束成一個理念,最後在近乎無聲的狀態下結束於您的標誌。主體是所有鉤子共用的單一範本,因此新鉤子只需一個資料夾和一個 JSON 檔案,而主體的任何變更會影響所有影片。

工作專案位於 film/。film/film.json 是主體(腳本行與拍點),film/hooks/<name>/hook.json 是各個鉤子,brand/brand.json 是您的品牌。

從這裡開始

  1. 品牌。 閱讀 brand/brand.json。如果該檔案遺失、仍為範例品牌,或 "reviewed": false,請先執行 launch-brand 技能(它會將網站轉換為品牌工具包和預覽表)。影片中的每一種顏色、字型和標誌都來自該檔案,絕不依賴記憶。
  2. 品牌核心。 閱讀 references/brand-core.md:每個品牌角色如何對應到影片,以及當品牌資訊不足時的預設值。
  3. 故事。 新影片從 launch-story(簡報、故事主軸、腳本、拍點表)開始。在既有主體上新增鉤子可以直接跳到下方的「製作新鉤子」。
  4. 經驗教訓。 在製作第一個畫面之前,先瀏覽 references/lessons.md。每一行都曾耗費一輪的修正。

核心原則(請務必遵守)

  • 格式: 16:9、1920x1080、30 fps,包含主體約 30 到 60 秒。畫面由 HyperFrames 無聲渲染,音效由技能工具鏈建置並混合,主音軌整合音量 -14 LUFS,峰值 -1 dBTP。
  • 視覺風格: 來自 brand/brand.json。陳述場景使用品牌 ground 背景,標題使用 ink 字色並有 1 或 2 個關鍵字以 highlight 色標示,深色英雄卡片使用 dark 背景,accent 色用於背景以及每個鏡頭中最重要的單一元素,不得用於長串文字。顯示字型來自 fonts.display。使用您網站上顯示的標誌。
  • 文法: 採用 Apple 和 Lovable 的上市影片文法。全畫面英雄文字隨著語音強勢切入(第一個字以 2.4 倍大小搭配模糊效果彈出,其餘文字以 1.3 倍大小依序進入),背景以硬切方式轉換,一個物體轉變為下一個物體(俯衝、收縮、變形),真實產品 UI 特寫,節奏明快但保有喘息空間,結尾平靜收束。
  • 配音: 整部影片使用單一敘述者。每一行新台詞都使用該敘述者的聲音錄製。文字會根據強制對齊結果,精準落在敘述者的語詞上。
  • 音樂: 單一曲目,放置時確保無論鉤子長短,其重拍(鼓點)都落在剪接點上,並在其小節網格上循環至結束,最後在標誌下方淡出。音效來自單一素材庫:合成鍛造音或您生成的工具包。
  • 素材: 自行生成或使用自有素材。禁止使用虛構人物、任何名人或相似者、真實電影或演員,以及第三方品牌(除非是為了提及整合功能)。提示詞需要與素材一同保存作為來源證明(docs/rights.md)。
  • 文字: 使用產品本身的用語。訊息文字來自您的即時網站(brand.json copy);產品擁有者的文案需逐字使用。每個數字必須真實且可證明。

開放項目

其他所有事項都是每部影片的選擇:鉤子的故事、視覺風格、長度、自有音效,以及是否提及產品名稱。選擇最能服務創意的方案,並在完整製作前先展示視覺風格。僅在被要求時才變更主體,且應在範本或 film.json 中進行修改,絕不單獨修改單一鉤子。

製作新鉤子

  1. 創意與文案。 使用產品擁有者的措辭撰寫創意。逐字保留他們的台詞。
  2. 先展示視覺風格。 在進行任何付費影像工作前,先建立 3 到 5 個關鍵影格或一個分鏡頁面。影格的評估速度很快;視覺風格錯誤就進行完整建置會浪費一天的時間。
  3. 畫面。 僅文字(免費:"video": null 加上 ground)、自有素材或生成素材(references/generation.md)。說明每個影像工作的成本並等待批准。檢查生成的人物臉部是否與任何名人相似。
  4. 鉤子資料夾。 film/hooks/<name>/ 包含畫面、語音台詞和 hook.json(架構在 references/hooks.md)。長度超過約 4 秒的鉤子需自備音樂背景,否則在鼓點落下前會以無聲播放。
  5. 建置、渲染、混合。 從 film/ 目錄執行:./render.sh <name>(建置、從 index-<name>.html 進行 HyperFrames 渲染、音訊)。主音軌會輸出到 film/renders/。
  6. 檢查(如下),然後展示影片並附上問題清單,並在筆記中記錄審查結果。

變更主體

主體的拍點、其欄位以及繪製它們的程式碼位於 references/body.md。對於任何變更:

  1. 修改 film/film.json(台詞、拍點、文字、焦點矩形)或範本 film/templates/body.html,絕不修改已產生的 film/compositions/*.html。
  2. 新增或變更台詞:使用敘述者的聲音錄製,重新執行語音前置作業以重新對齊每個字詞(skills/launch-voice/scripts/prep_lines.py),並確保提示點跟隨文字。
  3. 快照變更的秒數並在渲染前進行檢視(references/hyperframes-notes.md)。
  4. ./render.sh 會重建、渲染並混合所有鉤子(每部影片需時幾分鐘)。

在他人觀看前的檢查

  • 文字: 使用 Whisper 準確朗讀每一行(whisper-cli -m models/ggml-small.en.bin 或更大模型;基礎模型會聽錯產品名稱)。
  • 音量: 整合音量 -14.0 LUFS,真實峰值 -1.0 dBTP 或以下(ffmpeg -af ebur128=peak=true)。skills/launch-review/scripts/review.py 會測量兩者。
  • 同步: 每個英雄文字和關鍵時刻與其口語時間的誤差在 0.1 秒內。
  • 畫面: 每個新拍點的縮圖索引表(review.py 會產生 filmstrip.jpg 和 contact.jpg),然後進行 launch-review 的視覺檢查清單。
  • 版權: docs/rights.md。
  • 品味屬於產品擁有者: 通過檢查清單並不代表影片很好。應詢問哪些地方感覺不對,而非自行猜測,並且每輪只變更一個變數。

違規會耗費一輪修正的規則

  • 切勿使用 Whisper 猜測文字的時間點。請使用 skills/launch-voice/scripts/force_align.py;Whisper 可能會讓關鍵字延遲 0.3 秒,觀眾會感覺「節奏不準」。
  • 即使新台詞聽起來清晰,只要不是用敘述者的聲音錄製,就算迴歸。請使用相同的聲音和設定重新錄製,或從敘述者自己的台詞中克隆。
  • 在 UI 動畫已表達訊息的畫面上,不要疊加文字卡。避免超過幾秒的單調延伸:拉近鏡頭、添加顏色、更換背景。
  • 使用繪圖或向量圖形代替實拍素材看起來廉價,而看起來不真實的擬真人物則更糟。當寫實風格失敗時,寧可選擇風格化(3D 動畫)而非降低品質的寫實。
  • 為每個鉤子進行建置和渲染(index-<hook>.html),以便同時處理兩個鉤子時不會覆蓋對方的渲染結果。

檔案存放位置

項目位置
您的品牌工具包(顏色、字型、標誌、文案、螢幕截圖、預覽)brand/(brand.json、preview.png)
主體:台詞與拍點film/film.json
鉤子film/hooks/<name>/hook.json
範本、建置、音訊、批次渲染film/templates/body.html、film/build.py、film/audio.py、film/render.sh
語音錄音與對齊文字film/vo/body/(line-<id>.wav、lines.json)
音樂錄音film/score/
渲染輸出film/renders/
網站轉品牌工具包tools/brand-from-url.mjs、技能 launch-brand
工具手冊(故事、語音、配樂、音效、混音、審查、世界、動態)skills/launch-*/
設定、成本、版權docs/setup.md、docs/costs.md、docs/rights.md

階段技能

它們是附屬於此技能的工具手冊。若它們與本頁面衝突,以本頁面為準。

技能用途
launch-brand從網站提取資訊至 brand/brand.json、標誌、字型、螢幕截圖、預覽表
launch-story簡報、故事主軸、腳本、基於小節網格的拍點表、分鏡、參考研究
launch-voice選角、每行一次錄音、調整台詞長度、強制對齊、草稿配音
launch-score音樂配合幕表、重拍對準剪接點、草稿背景音樂
launch-sound音效素材庫、事件地圖、提示表、生成的音效工具包
launch-mix匯流排、閃避、標誌淡出、-14 LUFS 主音軌、多工混合
launch-review測量渲染或參考影片、視覺檢查清單、問題清單、評分卡
launch-world背景、底版、Blender 玻璃材質、3D 鏡頭、著色器圖層
launch-motion緩動記號、連續性、鏡頭、文字、游標、標誌性動作、HyperFrames 區塊

參考文件

  • references/brand-core.md:品牌角色到影片元素的對應,以及品牌資訊不足時的預設值。
  • references/body.md:film.json、拍點類型、時序、指令、如何修改拍點。
  • references/hooks.md:hook.json、音樂背景規則、鉤子樣式及其製作方式。
  • references/generation.md:Higgsfield 模型、成本以及經證實有效的配方,還有免費的備用方案。
  • references/lessons.md:來自真實上市影片的已核准與已拒絕的模式。
  • references/hyperframes-notes.md:範本所依賴的 HyperFrames 合約。

Individual skills in this repo

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

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (measuring a render and studying a reference film). Review a rendered launch film like a demanding creative director, then drive the v1 to v2 loop. Measures rhythm, static runs, cuts against the beat grid, loudness, true peak and voice pace with a script, then applies an eye checklist for continuity at every cut, legibility, brand, real UI, claims and differentiation. Writes a gap list and a scorecard; nothing ships on numbers alone. Use on every render, and on a reference film to learn from it, for "review the video", "check the film", "what is wrong with this cut", "study this reference".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

freudianflips/breakout-launch-videos

Tool manual under launch-film (backgrounds, plates, Blender glass and 3D shots, shader layers). Build the world a launch film lives in, in your own brand, with generated background plates (cost-gated), Blender for real 3D glass objects and camera moves rendered as alpha layers, WebGL shader layers for atmosphere, and the layer order, depth of field and grade that keep UI legible over living backgrounds. Use when a storyboard needs backgrounds, 3D or atmosphere, for "background", "plate", "3D object", "glass", "Blender", "shader", "atmosphere"; motion of the UI itself is launch-motion.

相關技能