Communitygithub.com

freudianflips/breakout-launch-videos

用於 launch-film 的工具手冊(背景、圖板、Blender 玻璃與 3D 鏡頭、著色器圖層)。建構承載啟動影片的世界,融入品牌元素。

breakout-launch-videos 是什麼?

此技能提供了一套完整的工具與工作流程,用於產出高品質的產品啟動影片背景與視覺元素。其核心文件位於 `skills/launch-film/SKILL.md`,而此技能則深入說明了如何建構一個具體的「世界」,而非僅使用純白或漸層背景。技能涵蓋多種圖層產生方式:使用 Higgfield 的 Seedance 生成背景圖板(需注意成本)、透過 Blender 腳本(`blender_glass_object.py`)渲染帶有 Alpha 通道的玻璃材質 3D 物件、以及利用 WebGL 片段著色器(shader)來添加霧氣、光束等氛圍效果。技能強調確保 UI 在所有動態背景上依然清晰可讀,並提供了詳細的圖層順序規則(背景 → 漸層遮罩 → 氛圍 → 玻璃 UI → 文字與游標),以及將背景色調整合至品牌色彩指南的調色方法。支援平台為 HyperFrames 這類的互動式影片框架。

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

在你喜歡的 AI 中提問

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

說明文件

啟動世界

這是 launch-film 下的工具手冊。請從 skills/launch-film/SKILL.md 開始:那裡包含了核心、掛鉤加主體範本以及經驗教訓。當此頁面與之衝突時,以 launch-film 為準。

大多數啟動影片會將 UI 浮放在白色或標準漸層上。當產品存在於某個場景中時,這部影片才會被記住:一個屬於品牌的地方、材質或圖案(例如紙藝工作室、數據構成的夜之城、工作檯、天文台)。世界是非必要的;帶有柔和光暈的品牌地面是一個強大的預設選項。當你建構一個世界時,每個背景決策都應服務於它,並保持產品清晰可讀。

找到你的世界

  1. 查看 brand/brand.json 和 brand/screens/:網站的圖像、插圖、紋理以及它用來描述自己的詞語。
  2. 用一句話命名 1 個地方或材質,並說明它對產品代表什麼意義(例如:霧氣散去 = 不確定性消除,成長 = 管線成長,玻璃 = 透明度)。如果它毫無意義,就跳過它。
  3. 在任何影片工作之前,先展示 3 張靜止畫面。

新圖板 (Higgsfield,你的帳號)

在每次影片工作前,說明費用點數成本並等待同意;以 480p 或 720p 和 5 秒進行草稿,僅在方向獲得批准後才以 1080p 渲染最終版本。使用來自已批准靜止畫面的開始或結束圖像來執行 Seedance 2.5,可使圖板保持在已批准的構圖中。提示應描述可見的事物,而非情緒:攝影機的移動(起點與終點)、1 個光源、什麼東西在漂移以及速度多快,然後是簡短的排除項(「無人、無文字、無剪輯」)。以時間戳記命名儲存圖板,並在 README 中加入一行記錄提示詞、模型和任務 ID。

3D (Blender)

以無頭模式執行 Blender:blender -b --factory-startup -noaudio --python-exit-code 1 -P script.py -- args:沒有 --python-exit-code 1,Python 錯誤仍然會回傳 0,導致建構繼續執行。在 Apple Silicon 筆電上,Cycles 渲染一個 720 像素的玻璃畫面約需 6 到 10 秒(1080p:每幀 7 到 12 秒,15 秒的鏡頭約需 1 小時)。

skills/launch-world/scripts/blender_glass_object.py -- <out_dir> <frames> [samples] [core_hex] [ring_hex] 將一個玻璃英雄物件(一個帶有發光核心和環的倒角立方體)渲染為 RGBA PNG。將你的 accent 色彩作為核心傳入,將你的 ground 或 surface 色彩作為環傳入。

  • 使用 film_transparent 和 film_transparent_glass 渲染為 RGBA PNG,以便玻璃可以合成在任何圖板之上。
  • 色彩:使用標準視角,不套用 Look,並將品牌發光強度設為 1.0,且將十六進制轉換為線性色彩空間;這樣顏色會準確呈現。AgX 會使淺色的品牌色彩變灰(測試中,接近白色的顏色渲染後變暗約 18%),並壓暗深色。純玻璃圖層(無品牌表面)可以使用 AgX 來獲得更好的高光過渡。
  • 玻璃:傳輸率 1,粗糙度 0.04,IOR 1.47,加上一層淺塗層。透明玻璃的 Alpha 通道是 Cycles 的工作(EEVEE 的光線追蹤玻璃會在透明薄膜上渲染為不透明)。當粗糙度高於 0.1 時,玻璃會變成不透明的灰色卡片,因此永遠不要渲染磨砂玻璃:取而代之的是,在 HTML 中使用 backdrop-filter 對一個追蹤板塊投影角點(world_to_camera_view 逐幀)的四邊形應用模糊效果。在直通 Alpha 的 PNG 或 WebM 中,光澤會大幅變暗;為強烈的邊緣光提供它們自己的 plus-lighter 圖層。
  • Blender 5.x API:F-曲線存在於動作插槽的 channelbag 中(bpy_extras.anim_utils.action_get_channelbag_for_slot),並且應在設定 file_format 之前設定 image_settings.media_type。腳本遵循這兩點。
  • 燈光:柔和的白色主光,由你的 accent 色彩調色的邊緣光,以及一個冷色補光;邊緣光能凸顯玻璃邊緣。
  • 匹配剪輯:以影片的 FPS 逐幀設定關鍵影格;僅渲染場景所需的確切幀數。
  • 將序列編碼為影片(ffmpeg -framerate 30 -i hero_%04d.png -c:v prores_ks -profile:v 4444 hero.mov,或使用帶 Alpha 的 VP9),並在 HyperFrames 中將其放置為 <video> 剪輯。這是確保可搜尋的安全路徑。
  • Blender 用於英雄物件和透過 3D 場景的攝影機飛行,並且它必須透過 CSS 無法偽造的視差、厚度或遮擋來證明其渲染時間是值得的。平面 UI 和所有文字仍應留在 HTML 中。

生成的 3D 鏡頭 (Higgsfield)

通往 3D 玻璃的第二條路徑:使用 Seedance 和一個 6 區塊的提示詞(格式行、設計世界、運動規則、時間編碼鏡頭、音景、音樂)。要求提供無文字的鏡頭,並在 HyperFrames 中設定每個單字;生成的文字會被替換。首先使用一個作為影片參考傳遞的灰盒 Blender 預覽動畫來佈置攝影機,將關鍵影格或第一幀和最後一幀傳遞給模型,並將你的品牌影格作為最後一幀傳遞。Marketing Studio 預設上限為 720p,因此它們僅作為情緒草稿,絕非成品。在提示詞中以文字和十六進制命名你的品牌顏色。

著色器圖層

如果 WebGL 片段著色器是從搜尋時間渲染、具有固定的 Canvas 大小且無渲染循環,則它可以在 HyperFrames 中執行(請參閱 HyperFrames 動畫技能的 Three.js 和 WebGL 適配器)。實用的品牌中立著色器包括:漂移的霧氣或薄霧(fbm 噪聲,從地面顏色到透明)用於世界通道;玻璃折射帶(UV 被法線貼圖偏移)用於玻璃擦拭效果;柔和的體積光射線;以及以你的 accent 色彩緩慢的域扭曲顏色場。

圖層順序與可讀性

  1. 圖板(影片),可選擇模糊 6 到 16 像素,作為 UI 位於前方時的一種鏡頭選擇(焦點切換:開場時清晰,產品後方柔化)。
  2. 文字媒介遮罩:一個使用你的 dark 色彩、方向約 45% 到 62% 的漸層,絕不能是覆蓋整個畫面的平面色調。
  3. 氛圍:一個著色器或圖板的交叉淡入。
  4. 玻璃 UI(磨砂外殼,一個透明度約 0.92 的 ground 窗格),一個帶有 dark 色調的柔和陰影。
  5. 文字與游標。

淺色文字應置於圖板中帶有遮罩的深色區域上方,深色文字則置於淺色天空或地面上方。切勿將淺色文字放在淺色區域上方。

調色

將圖板向你的品牌色調進行調色:地面的溫暖感、陰影或高光中的 accent 色調,不要使用預設的青橙色。如果圖板偏暖或偏冷,在放置前使用 ffmpeg(eq,colorbalance)進行校正,並在圖板旁記錄校正參數。

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

相關技能