Promo Bgm Skill — Development skill for Claude Code

promo-bgm

给产品宣传片、演示视频、更新短片配一支背景音乐。**纯代码合成** —— 没有采样、没有第三方素材、 没有版权风险，长度精确到毫秒，改一个参数就能重出一版。

https://github.com/user-attachments/assets/7ebb8d2e-dd40-46b4-a84f-e7872b96a2db

`bright-climb` 预设的 30 秒成品，有声音 —— 画面上标的段落名和鼓档位， 就是这份 spec 里写的那几行。

一支曲子在这里是一份 JSON，不是一个音频文件：

{
  "duration": 30,
  "key": "C",
  "lead": "pluck",
  "sections": [
    { "name": "open",   "bars": 2, "chords": ["Iadd9"],            "density": 0, "kit": 0, "gain": 0.62 },
    { "name": "payoff", "bars": 2, "chords": ["Iadd9", "IVadd9"],  "density": 2, "kit": 3, "gain": 1.0, "top": true },
    { "name": "out",    "bars": 1, "chords": ["Iadd9"],            "density": 0, "kit": 0, "gain": 0.9, "ring": true }
  ]
}

渲染引擎里没有随机数（噪声来自定种子的 LCG），所以**同一份 spec 永远出逐字节相同的音频**。 spec 可以进版本库、可以 diff、可以三个月后原样重出。仓库里因此不放音频 —— 音频是产物，spec 才是源文件。

**如果你是 agent**：要把它装进来 → 读下面的「安装」，克隆到**你自己客户端约定的技能目录** （这个仓库对位置没有要求，别照抄示例路径）；已经装好、要拿它干活 → 读 [`SKILL.md`](SKILL.md)，那是操作手册，本文件只是说明书。

为什么不直接去曲库找一首

找一首要花二十分钟，而且它是为别人的片子写的。片子改了 3 秒，你得回去重新找、重新剪， 剪出来的那一刀多半落在乐句中间。

这里反过来：**片子改了 3 秒，改 spec 里的一个数字，配乐跟着改 3 秒**， 段落边界仍然落在小节线上，重音仍然落在画面转折那一帧上。

代价是音色有限（见下面「做不到什么」）。如果片子需要人声或管弦，去买授权，别用这个硬凑。

安装

没有安装脚本，也没有 `npm install`。这个仓库没有插件协议、没有 MCP server、 没有任何客户端专属的东西 —— **它就是一堆 Markdown 加一个 CLI**， 任何「能读文件 + 能跑 shell」的 agent 都能驱动。所以「装」只有两件事：

1. 把它克隆下来
2. 让 agent 知道 SKILL.md 在哪 —— 那是操作手册，references/ 是它按需展开的细节

**位置随你的客户端**：脚本之间全是相对引用，没有一处硬编码路径，克隆到哪个目录都照样跑。 所以该由你客户端的约定决定，不该由这份 README 替你定。

有技能目录的客户端

Claude Code / Claude Desktop 放进约定目录就会被自动发现，第 2 步免了：

# 自己用
git clone https://github.com/whyubel1eve/promo-bgm-skill.git ~/.claude/skills/promo-bgm

# 跟着某个项目走，团队都能用
git clone https://github.com/whyubel1eve/promo-bgm-skill.git .claude/skills/promo-bgm

目录名要用 `promo-bgm`，和 `SKILL.md` 里的 `name` 对上；仓库名叫 `promo-bgm-skill` 不影响。 自动发现靠的是 `SKILL.md` 顶部那段 YAML frontmatter（`name` / `description`）， 客户端拿它判断什么时候该加载；不支持的客户端会把它当普通 Markdown 读，不影响使用。

其他客户端

克隆到那个客户端约定的位置 —— **你的 agent 知道那是哪，不知道就让它去查自己的文档**， 别照抄别人的路径。