Communitygithub.com

freudianflips/breakout-launch-videos

工具手册,位于 launch-film 下(根据剪辑配乐,使用 Higgsfield Sonilo、本地 ACE-Step 或免费的临时音床)。为发布影片配乐,音乐段落对应影片的幕次。每段录制测量速度和段落能量,拉伸至影片的 BPM 并偏移,使其高潮落在剪辑点上。在故事板节拍表完成后使用,适用于“音乐”、“配乐”、“原声”、“背景音轨”、“高潮点”、“节拍网格”。

breakout-launch-videos 是什么?

该技能是一个专业工具,用于为发布影片创建高度结构化的配乐(Launch Score)。它超越了简单的背景音乐,将音乐的每个部分(如引子、铺垫、高潮、过渡段)与影片的特定“幕次”(如钩子、演示、剪辑点等)精确对齐,共同基于一个共享的节拍网格(例如,2秒对应120BPM的一小节)。这使得剪辑点总能落在音乐强拍上,实现音画同步。它支持多种音乐生成后端:Higgsfield Sonilo(云端付费,自动匹配速度和能量)、ACE-Step(本地免费,提供完整控制,如小节和调性)、以及使用免费的合成临时音床或授权曲库。开发者首先基于故事板节拍表创建节拍计划(BPM、调性、段落),然后生成多个片段并分析其速度和能量曲线,最终选择最佳片段,并精确找到其“高潮点”以对齐到影片的关键剪辑。该技能在 Anthropic 的 Claude Code 等 AI 编程工具中通过命令行界面运行。

兼容平台✓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 为准。

发布配乐并非简单地铺在影片下方的音轨。它的段落对应影片的各个幕次:引子对应钩子,铺垫对应演示,高潮对准剪辑点和结局,过渡段对准定位语行,而标志出现时几乎静音。音乐和剪辑共享一个以小为单位的网格,因此剪辑点总能落在强拍上。

选择你品牌的声音

在生成任何内容之前,先写一段话:流派、速度、最重要的3或4种乐器,用直白的话语描述情绪。这些应来自品牌,而非习惯:一个平静、高端的产品适合温暖的现代浩室音乐或带有柔和底鼓的毛毡钢琴;一个开发者工具适合紧凑的电子乐和干瘪的底鼓;一个消费类应用可以承载更多色彩。一个对B2B发布效果良好的例子是:120BPM左右的有机深浩室音乐,圆润的贝斯,一个模糊的引子,在剪辑点上展开为清晰的四拍底鼓。听起来像模板音乐的例子有:企业电子乐、平静的钢琴独奏、管弦乐渐强。在整个影片中保持调性稳定,以便声音调色板(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 的节拍速度检测会量化为粗略区间:一个120 BPM的片段可能被识别为117.5)测量速度,在4%的偏差范围内拉伸至计划的BPM,并搜索其响度曲线最匹配各幕次的偏移量。在2026年9月的测试中,无论提示词要求什么,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下1小节 = 2.0秒)。编写 film/score/score.json(格式见 ace_score.py 的文件头:caption, bpm, key, sections 以及 tag, note, bars)。保留2小节的尾声,以便标志有收尾。
  2. 描述文字。 一段话:流派、最重要的3或4种乐器、用直白的话语描述情绪、“清晰现代的混音,无演唱”。将段落意图放在每个段落的 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.

相关技能