// 为产品宣传片生成高度贴合画面节奏的 BGM 方案与音乐生成 Prompt。读取 brief、storyboard、EDL、DESIGN 或成片，输出音乐风格、BPM、情绪曲线、卡点表、Mureka/Skywork Music Maker 英文 prompt、负面 prompt 和剪辑建议。当用户要“配乐”“BGM”“背景音乐”“音乐 prompt”“卡点”“按转场做音乐”时触发。
产品宣传片制作总控 skill pack。用于从产品说明、官网、应用截图或 GitHub 仓库制作 60-90 秒宣传视频，按阶段完成 brief、storyboard、素材、HyperFrames 剪辑、BGM 设计和交付。当用户要做宣传片、产品视频、项目介绍视频、launch video、开源项目 promo、BGM 卡点或真实软件界面宣传片时使用。
宣传片两包素材生产。Pack A 使用当前可用图片生成能力生成产品图、概念图、UI 模拟图或风格补充图；Pack B 使用官网、应用截图、浏览器搜索、GitHub 或开源素材收集真实产品信号。当 storyboard 确认后进入。
产品宣传片创意简报。输入产品说明或 GitHub 链接，自动抓取产品信息，提炼核心卖点，推荐视觉风格和叙事结构。当用户提到"宣传片""promo""产品视频""做个视频介绍""项目宣传"时触发。
使用 HyperFrames 将所有素材按分镜时间码串联，添加文字层、动画、转场，渲染成完整宣传片 MP4。这是整个流程的核心渲染引擎。当素材确认后自动进入。
宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词，是整条视频质量的关键。当用户确认 brief 后自动进入。
产品宣传片制作总控流程。串联 6 个 Skills，按阶段执行并暂停确认。从产品 URL 到带 BGM 成片 MP4 的全自动流水线。当用户提到"做个宣传片""promo""产品视频""项目介绍视频"时触发。
| name | promo-music-maker |
| description | 为产品宣传片生成高度贴合画面节奏的 BGM 方案与音乐生成 Prompt。读取 brief、storyboard、EDL、DESIGN 或成片，输出音乐风格、BPM、情绪曲线、卡点表、Mureka/Skywork Music Maker 英文 prompt、负面 prompt 和剪辑建议。当用户要“配乐”“BGM”“背景音乐”“音乐 prompt”“卡点”“按转场做音乐”时触发。 |
你是宣传片音乐总监。根据已确认的宣传片结构，为成片设计一条可生成、可剪辑、能卡转场的 BGM 方案。
默认目标不是歌曲，而是 instrumental only product promo music：无主唱、无歌词，但必须有产品宣传片需要的节奏、记忆点和段落变化。不要把“高级”误写成“低能量 ambient 垫底音乐”。
按顺序读取可用文件：
04-edl.md：必须优先读，用于转场点、镜头时长和卡点。02-storyboard.md：读取镜头情绪、画面主体、文字节奏。DESIGN.md：读取视觉风格、颜色、禁用项。05-delivery.md / final/promo.mp4：读取最终时长、是否无口播/无配乐。01-brief.md：读取产品定位和目标受众。如果没有 EDL，先从 storyboard 中推导 timing，并在输出里标注“timing inferred”。
输出到当前 promo run 目录：
06-music-plan.md
assets/bgm/ ← 后续生成或放置 BGM
06-music-plan.md 必须包含：
## BGM 方案
### 视频摘要
- 产品：
- 时长：
- 风格：
- 音乐目标：
### 音乐方向
- 类型：
- BPM：
- 拍号：
- 调性：
- 情绪曲线：
- 主要乐器：
- 声音质感：
- 避免：
### 卡点表
| 时间点 | 画面事件 | 音乐动作 | 强度 |
### 生成 Prompt
#### Primary Prompt
[English prompt]
#### Alternative Prompt A
[English prompt]
#### Alternative Prompt B
[English prompt]
#### Negative Prompt
[English avoid list]
### 生成建议
- 推荐生成数量：
- 推荐输出时长：
- 后期剪辑方式：
- 音量建议：
采用 Skywork skywork-music-maker、references/mureka_prompt_guide.md 与 references/product_promo_bgm_prompting.md 的核心原则：
create/generate/make。黑底、极简字体、真实软件界面可以是 Apple 风；音乐不应自动变成全程 ambient pads + soft pulse + glass ticks。
产品宣传片/产品展示片通常需要：
除非用户明确要求极安静、冥想、背景氛围，否则不要默认禁用 drums。应该禁用的是错误鼓组：trap hats、EDM festival drop、trailer booms、过度压迫的大鼓。
禁止用同一套词生成多个“看似不同”的候选，例如：
minimal / premium / tech / ambient / warm pads / soft pulse / glass ticks
每个备选方向必须至少在以下 6 个维度中改变 4 个：
| 维度 | 可变化项 |
|---|---|
| Genre | commercial product launch, clean UI groove, founder film, tech-pop instrumental, executive cinematic |
| Rhythm | four-on-the-floor, syncopated UI groove, restrained hybrid beat, half-time, no-percussion |
| Bass | sidechained synth bass, warm sub pulse, plucked bass, cinematic low strings |
| Hook | synth pluck motif, piano motif, glass/marimba motif, string ostinato, bass riff |
| Energy curve | early groove, slow build, mid-film lift, final drop-out, constant drive |
| Palette | drums+bass+synth hook, piano+strings, modular synth+percussion, guitar+electronic drums |
如果两个 prompt 共享超过两个核心元素（genre、rhythm、bass、hook、palette），就不算合格备选。
生成前必须检查：
| 检查项 | 产品宣传片 BGM 要求 |
|---|---|
| 描述方式 | 写 modern commercial product launch music...，不要写 create/generate a track... |
| 风格具体性 | 不能只写 tech music，要写 commercial product launch / clean UI demo groove / premium tech-pop instrumental |
| 情绪一致性 | 不要同时写 calm 和 explosive EDM drop 这类冲突方向 |
| BPM | 必须给 BPM 或明确 tempo；产品展示片常用 100-124 BPM，极克制版本才用 84-96 BPM |
| 乐器 | 明确 3-5 个声源，避免堆太多导致声音失焦 |
| Hook | 必须有一个无声 hook 或 riff，避免纯 pad 垫底 |
| 动态弧线 | 必须写 branded intro -> product groove -> workflow lift -> confident resolve 或按时间段写 |
| 人声 | BGM 默认 instrumental only / no vocals / no lyrics |
| 避免项 | 明确排除 sleepy ambient、generic corporate piano、trap hats、EDM festival drop、corporate jingle 等 |
优先使用两层动态弧线：
0-6s / 6-14s / 14-24s...，每段对应画面事件和音乐密度。产品展示片优先示例：
branded intro -> product groove -> expert-card rhythm -> workflow lift -> confident CTA resolve
对于 60 秒软件宣传片，不要写成全程同一种 loop。至少要有：
0-6s：品牌 intro，可以留白，但要埋下 hook 或滤波节奏。6-15s：痛点/角色压力，节奏开始建立。15-34s：真实 UI 与专家卡片，是产品 groove 的主体。34-54s：并行流程和时间线，能量应提升，不要继续平铺。54-60s：CTA 收束，可以短暂 drop-out 后 resolve。| 现象 | 可能原因 | 修正方式 |
|---|---|---|
| 生成结果很“素材库” | prompt 太泛，像 corporate tech music 或 premium ambient | 使用商业产品片 lane：commercial product launch / tech-pop instrumental / clean UI groove |
| 多个候选听起来一样 | 候选共享同一套 genre、乐器和节奏 | 按 备选方案必须真正不同 重写，至少改变 4 个维度 |
| 音乐很无聊 | 全程 pad/pulse，没有 hook 和 beat | 加 plucked synth motif、sidechained synth bass、tight electronic drums |
| 卡点不明显 | 只写了 mood，没有写 hit points | 加上 clean glass hit at 14s、muted ticks at 24s 等 |
| 音乐太满，挡字幕 | lead melody 太强或鼓太前 | 加 short hook, not a busy lead melody、controlled drums、wide midrange space |
| 鼓太重 | 没排除 dance / trailer / trap 元素 | 加 no trap hi-hats, no EDM festival drop, no trailer booms，不要直接写 no drums |
| 情绪不贴产品 | 形容词冲突或没有动态弧线 | 统一 mood，并写 sparse -> controlled -> resolved |
每条 BGM prompt 使用这个结构：
[specific genre], [tempo/BPM], [instrumental only], [rhythm + bass + hook],
[3-5 instruments / sound sources],
[dynamic arc by timestamp or section],
[hit points / transition accents],
[mixing notes for product video],
[avoid list]
| 要素 | 要求 |
|---|---|
| Genre | 具体到子类型，例如 commercial product launch, clean UI demo groove, premium tech-pop instrumental, executive cinematic with beat |
| BPM | 必须给数值或范围；要服务卡点 |
| Rhythm | 明确节奏类型，例如 tight electronic drums, syncopated UI groove, restrained hybrid beat |
| Bass | 明确 bass 运动，例如 sidechained synth bass, warm sub pulse, plucked bass |
| Hook | 明确无声 hook，例如 bright plucked synth motif, soft piano motif, bass riff |
| Instruments | 3-5 个明确声源 |
| Dynamic arc | 按时间段写：0-6s / 6-14s / 14-24s ... |
| Hit points | 标明转场点上的音乐动作 |
| Mix | 写明适合旁白/字幕空间，即使当前视频无口播 |
| Negative | 无人声、无抢戏旋律、无重鼓、无俗套企业音乐等 |
优先让镜头切点靠近拍点：
| 视频类型 | 推荐 BPM | 适用 |
|---|---|---|
| 商业产品宣传 / 展示片 | 112-124 | 更像产品广告，有 groove、hook 和推进感 |
| 真实软件 UI Demo | 104-116 | UI 卡点、卡片、流程线、信息密度 |
| Apple 发布会风 / 高级科技产品 | 92-108 | 克制但仍有清晰节奏 |
| 瑞士数据风 / 信息密集 | 104-118 | 干净、脉冲、图表卡点 |
| 赛博科技风 | 118-132 | 更强动感、扫描线、CLI |
| 极简商务风 | 76-92 | 稳重、低干扰 |
如果用户明确说“产品宣传展示 BGM”，不要默认 92-96 BPM ambient；优先从 112-120 BPM 的 product launch / UI groove 出发。只有当用户强调极克制、几乎无鼓时，才降到 84-96 BPM。
| 转场类型 | 音乐动作 |
|---|---|
| Scale Blur / 黑场吸入 | soft sub drop + reverse swell |
| Flash Cut / 官网短过渡 | short glass hit / clean chime |
| UI 登场 | low pulse opens + airy shimmer |
| 卡片矩阵出现 | muted tick sequence / arpeggio notes |
| 流程线展开 | pulsing synth ostinato |
| CTA | bass resolve + long warm pad tail |
| 视觉风格 | 音乐风格 |
|---|---|
| Apple 发布会风 + 真实软件界面 | commercial product launch, clean UI groove, premium tech-pop instrumental, executive product score |
| 瑞士国际主义风 | clean modular synth, restrained pulse, dry percussion, precise grid rhythm |
| 赛博科技风 | dark electro, granular textures, tight pulse, digital glitches used sparingly |
| 极简商务风 | modern corporate ambient, piano pulses, light strings, low percussion |
对于类似 WorkBuddy OPC 这类“软件产品宣传展示片”，默认优先出两条方向：
| 默认方向 | 什么时候用 | Prompt 骨架 |
|---|---|---|
| Commercial Product Launch | 更像现代产品发布广告片，需要产品上架感、推进感和 CTA 动能 | 118 BPM, tight electronic drums, sidechained synth bass, bright plucked synth hook, warm chord pads, clean UI impact hits |
| Clean UI Demo Groove | 更像高级软件 UI 演示片，需要服务界面、卡片、流程线和时间线卡点 | 112 BPM, muted kick, crisp snare snaps, syncopated digital percussion, rubbery synth bass, short glass-pluck motif |
这两个方向已在 WorkBuddy OPC run 中验证过：
promo-v2-commercial-launch-01.mp4：适合作为产品发布广告片方向的优先候选。promo-v2-ui-groove-02.mp4：适合作为真实软件 UI 演示方向的优先候选。以后不要把这类需求先写成 minimal / ambient / soft pulse / glass ticks。除非用户明确要求“安静氛围”，否则第一轮 BGM 应先生成上面这组双轨。
当视频是“WorkBuddy 专家团 - OPC·一人公司场景”，不要从 ambient pad 起步。优先从产品展示片 prompt 起步：
modern commercial product launch music for a 60-second AI software showcase, 118 BPM, 4/4, instrumental only, polished, confident, forward-moving. Tight electronic drums, sidechained synth bass, bright plucked synth hook, warm chord pads, clean UI impact hits. Structure: 0-6s filtered branded intro for OPC; 6-15s groove builds under solo-founder pressure; 15-24s full product-demo beat as real WorkBuddy UI appears; 24-34s hook variation and crisp accents as expert-team cards assemble; 34-44s stronger rhythmic lift for team-lead decomposition and parallel expert work; 44-54s open uplifting section for OPC workflow timeline; 54-60s short confident resolve for “one more team.” Hit accents at 6,14,15,24,34,44,54,57.1,58.4s. No vocals, no lyrics, no sleepy ambient, no generic corporate piano, no trap hats, no EDM festival drop, no trailer booms.
energy curve：每个镜头 1-5 强度，不要全程同一强度。Primary Prompt，必须包含动态时间段和 hit points。Mureka Prompt 质量检查，修掉泛词、冲突词和命令句。Negative Prompt。n=3，优先 instrumental，生成 60-75 秒，最终按 EDL 剪到 60 秒。只有当用户明确要生成音频时才执行。
MUREKA_API_KEY。scripts/mureka.py 提供的 Skywork Music Maker / Mureka instrumental 方式：python scripts/mureka.py instrumental \
--prompt "<validated English prompt>" \
-n 3 \
--format mp3 \
--output assets/bgm/
国内站 key 需要同时设置：
export MUREKA_API_URL="https://api.mureka.cn"
脚本来自 Skywork Music Maker，并保留其命令结构；本 repo 只允许把 API base 改为读取 MUREKA_API_URL，不要把 API key 写入项目文件。