Communitygithub.com

freudianflips/breakout-launch-videos

為發佈影片創作節拍同步的音樂配樂,根據品牌調性與影片章節結構進行譜曲。

breakout-launch-videos 是什麼?

此技能為 AI 代理人的 Launch Film 工具組(launch-film)中的音樂配樂子系統,專門用於製作與影片剪輯緊密同步的「發佈配樂」。它將配樂的段落(樂節)對應到影片的敘事章節(幕次):前奏對應鉤子段落,鋪陳對應產品展示,重點節拍落在剪輯點與結果呈現,尾奏則融入品牌標誌展示。技能支援多種工具來源,包括免費的合成背景音樂、Higgsfield Sonilo 雲端服務、本地執行的 ACE-Step 1.5 模型,以及授權曲庫。工作流程從故事板節拍表出發,建立小節計劃、生成多個錄音版本、分析其節奏與能量分佈以選擇最佳版本,並找到音樂中「重點節拍」的精準時間點,讓其能與關鍵剪輯點對齊。最終產出的配樂檔案與中繼資料(score.meta.json)會傳遞給後續的動態設計(launch-motion)、音效設計(launch-sound)與混音(launch-mix)環節。此技能支援 Claude Code、Cursor 等以檔案系統為基礎的 AI 代理人平台,透過 Python 指令碼與 JSON 設定檔執行。

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

在你喜歡的 AI 中提問

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

說明文件

發佈配樂

收錄於 launch-film 工具手冊。請從 skills/launch-film/SKILL.md 開始:它包含核心架構、鉤子加主體的模板以及相關課程。當本頁內容與之相異時,以 launch-film 為準。

發佈配樂並非單純鋪在影片底下的背景音樂。其段落(樂節)即是影片的章節(幕次):前奏襯托鉤子段落,鋪陳襯托產品展示,重點節拍落在剪輯點與結果呈現,間奏對應定位說明,品牌標誌展示時則趨近無聲。音樂與剪輯共享一個小節網格,因此剪輯點能夠準確落在強拍上。

選擇你的品牌聲音

在生成任何內容之前,先寫一段文字:音樂類型、速度、最重要的三或四種樂器、用平實語言描述情緒。這些應源自品牌,而非習慣:一個沉穩、高階的產品適合溫暖的現代浩室或帶有柔和鼓擊的毛氈鋼琴;一個開發者工具則適合緊湊的電子音樂配上乾燥的鼓聲;消費者應用可以承載更多色彩。對 B2B 發佈影片效果良好的例子:速度約 120 BPM 的有機深浩室音樂、渾厚的貝斯、一段模糊的前奏在剪輯點展開成乾淨的四拍地板鼓。聽起來像模板音樂的例子:商業電子樂、平靜的鋼琴獨奏、管弦樂漸強。整部影片應保持調性穩定,使聲音調色盤(launch-sound)能與之協調。

工具

來源使用時機成本(2026-09)
合成背景音樂(scripts/scratch_bed.py)初剪、時間測試、免費示範。一種基於網格的合成背景音樂,其重點節拍落在計劃指定的位置。免費
Higgsfield Sonilo(scripts/hf_score.py)使用自有帳戶的預設正式配樂。每次 30 秒錄音約 1.9 點數
ACE-Step 1.5(scripts/ace_score.py)本地端且免費,完全控制小節數與調性;首次執行需下載數 GB 的模型檔案。免費、本地端
授權曲庫曲目當曲庫中的曲目符合小節計劃時使用。按授權計費
  • Sonilo: python3 skills/launch-score/scripts/hf_score.py film/score/score.json film/score/sonilo --takes 3 會將章節對應寫入提示詞中,生成錄音版本,透過起音點自相關(librosa 的 beat tempo 會近似到粗略的速度區間:一個 120 BPM 的錄音可能被讀取為 117.5)來測量速度,當差異在 4% 以內時將其拉伸至計劃的 BPM,並搜尋能讓響度曲線最符合各章節的偏移量。在 2026-09 月的測試中,Sonilo 無論提示詞要求什麼,都會以 120 BPM 生成;拉伸至 122 BPM 僅為 1.7%,且人耳無法察覺。
  • ACE-Step: 可安裝在任何位置並設定 ACE_STEP_ROOT,然後執行 $ACE_STEP_ROOT/.venv/bin/python skills/launch-score/scripts/ace_score.py film/score/score.json film/score/ace。設定 ACE_DRY_RUN=1 可印出計劃及各章節時間而不實際生成。若某個章節失敗,可僅使用 ACE-Step 的重新繪製任務(task_type: "repaint"、repainting_start、repainting_end)重新生成該範圍,無需生成全新歌曲。

程序

  1. 小節計劃。 根據故事板的節拍表,將每個章節對應到影片 BPM 的小節數(120 BPM 時,一小節 = 2.0 秒)。撰寫 film/score/score.json(格式請見 ace_score.py 的標頭:caption、bpm、key、sections 包含 tag、note、bars)。保留 2 小節的尾奏,讓品牌標誌有收尾空間。
  2. 說明文字。 一段文字:音樂類型、最重要的三或四種樂器、用平實語言描述情緒、「乾淨現代混音、無人聲」。將各章節的意圖寫入該章節的 note 中,而非說明文字。
  3. 生成 2 到 4 個錄音版本。
  4. 選擇。 對每個錄音版本執行 launch-review 的分析(速度、節拍網格、各章節能量)。偏好能量在計劃指定位置上升、且速度保持不超過 1 BPM 波動的版本。影片創作者有權決定作為完整影片一部分的音樂,而非獨立的音樂曲目。
  5. 找到重點節拍。 重點節拍是前奏之後第一個乾淨的鼓點:找出錄音檔案中響度最陡峭上升至某個強拍的點(或對於間奏剪輯點,則是最陡峭下降至間奏的點),並記錄其在檔案中的時間。對於影片模板,將其寫入 film/film.json 中的 music.drop,並附上 music.bpm;film/audio.py 會將檔案放置好,使重點節拍無論鉤子長度如何都能落在剪輯點上,並在小節網格上重複循環以填滿主體段落。
  6. 交接 將選定的錄音版本與 score.meta.json(各章節時間,單位為秒)傳遞給 launch-motion、launch-sound 和 launch-mix。

規則

  • 旁白出現時僅能用純器樂。
  • 將說明文字、種子碼、模型與小節計劃記錄在 score.meta.json 中:配樂必須可重現。
  • 絕不能因為某一曲目存在就直接使用。它必須符合小節計劃,否則應重新生成。
  • 品牌標誌落在近乎無聲的段落:最後一個章節結束時是混音的淡出或一個 2 秒的淡入。
  • 如果鉤子段落的長度超過約 4 秒,它需要自己的背景音樂(將前奏小節在網格上循環,或使用一個相匹配的錄音版本),否則應在重點節拍播放前保持靜音。

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

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

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

相關技能