mc-render-compile
The compiler from ARR-SPEC to any generation backend (编译层). One compiler, many backends - the backend differences live in backends.yaml as data, never as separate skills. Covers the compile order, section-tag mapping, turning structured fields into prose style prompts without losing information, lyric chunking, the honors contract that decides which fields are scorable, degradation strategy when a backend cannot execute a field, seeds and best-of-N, and what to hand over so the user can run it in whatever tool hosts the backend. Use when turning a finished ARR-SPEC into Suno / YuE2 / MiniMax / ACE-Step / symbolic output, when choosing a backend, when a generation ignored the spec, or when adding a new backend. 编译、后端、Suno、YuE2、MiniMax、ACE-Step、提示词生成、段落标签、honors。
jtydhr88 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add jtydhr88/music-composition-skills --skill mc-render-compile技能说明
name: mc-render-compile description: The compiler from ARR-SPEC to any generation backend (编译层). One compiler, many backends - the backend differences live in backends.yaml as data, never as separate skills. Covers the compile order, section-tag mapping, turning structured fields into prose style prompts without losing information, lyric chunking, the honors contract that decides which fields are scorable, degradation strategy when a backend cannot execute a field, seeds and best-of-N, and what to hand over so the user can run it in whatever tool hosts the backend. Use when turning a finished ARR-SPEC into Suno / YuE2 / MiniMax / ACE-Step / symbolic output, when choosing a backend, when a generation ignored the spec, or when adding a new backend. 编译、后端、Suno、YuE2、MiniMax、ACE-Step、提示词生成、段落标签、honors。
编译层(Render Compile)
本库只有一个编译器。后端是数据,不是 skill。
ARR-SPEC(唯一 IR)
↓ mc-render-compile ← 只有这一个,管共性
├─→ backends.yaml: yue2 ★ 可直接吃 ABC 乐谱,控制力最强
├─→ backends.yaml: suno 散文 prompt + 段落标签,成品最润
├─→ backends.yaml: minimax-music-3
├─→ backends.yaml: ace-step-1.5
├─→ backends.yaml: stable-audio-3 (无人声)
└─→ backends.yaml: symbolic MIDI/MusicXML,完全确定
加一个新模型 = 在
backends.yaml加一个块,不动任何 skill。 这是编译器前端/后端分离那一套。
按任务读哪几节
| 任务 | 读 |
|---|---|
| 选哪个后端 | §2 能力对照 |
| 编译一份规格 | §3 编译顺序(按顺序做,不要跳) |
| 写 style_prompt | §4 |
| 段落标签对不上 | §5 |
| 后端不理我的规格 | §6 honors 契约 + §7 降级 |
| 要出 ABC/MIDI | mc-symbolic-score |
| 把编译结果交给后端执行 | §8 |
| 加一个新后端 | §9 |
| 生成完了 | mc-ai-tell-audit |
边界
| 不归这里 | 归哪 |
|---|---|
| ARR-SPEC 里的内容怎么想出来 | L1/L2 各 skill |
| ABC / MusicXML / MIDI 怎么生成 | mc-symbolic-score |
| 生成回来像不像 AI | mc-ai-tell-audit |
| 照做率怎么算 | 定义在 mc-ai-tell-audit §3.1;本 skill §6 只管 honors 三档怎么影响计分 |
| 具体某个后端的权重放哪、节点叫什么 | backends.yaml(包内副本)(数据) |
| 风格描述里该写什么风格词 | mc-style-*(L3) |
1. 动笔前必填
| 必填 | 问法 |
|---|---|
| ① 目标后端 | 至少一个。多个就要做 §7 的降级表 |
| ② 这次要验证什么 | 是出成品,还是跑 AB?AB 就必须锁定其他变量 |
| ③ 种子策略 | 固定种子做对照,还是 best-of-N 挑 |
| ④ 哪些字段这个后端做不到 | 查 honors。这决定你别在那些字段上浪费提示词预算 |
2. 后端能力对照
| YuE2 | Suno | MiniMax | ACE-Step | Stable Audio | 符号 | |
|---|---|---|---|---|---|---|
| 输入 | 风格 + 词 + 可选 ABC | 散文 + 段落标签 | 散文 + 词 + 参考 | 标签 + 散文 | 散文 | 乐谱 |
| 调性/和声 | ★ 精确(ABC) | 只能提示 | 提示 | 提示 | — | 精确 |
| 曲式/小节数 | ★ 精确 | 说不动 | 提示 | 提示 | — | 精确 |
| 人声 | 有 | 有 | 有 | 有 | 无 | 无 |
| 可复现 | seed + best-of-8 | 弱 | — | seed | seed | 完全 |
| 音色成品度 | 高 | 最高 | 高 | 中 | 高 | 看音源 |
| 商用 | ★ 权重 CC-BY-NC,不可商用 | 看订阅档 | 待核 | 看许可 | 看许可 | 可 |
选择建议:
| 目的 | 选 |
|---|---|
| 验证规格是否被执行 | YuE2(唯一能"执行"而非"提示"的) |
| 要成品质感 | Suno |
| 要完全可复现的对照基准 | 符号路径 |
| 纯器乐/氛围 | Stable Audio |
| 出街商用 | ★ 先解决许可——YuE2 权重是 CC-BY-NC-4.0,不可商用 |
3. ★ 编译顺序
按顺序做。跳步会产生"提示词里互相矛盾"的问题。
| # | 步骤 | 说明 |
|---|---|---|
| 0 | 过一遍 mc-workflow §3.0 的 20 条自查 | 不过的条目改掉或写明理由再编译——不是准入门槛,是最后一次发现"规格没写完"的机会 |
| 1 | 读 backends.yaml 的 honors | 标出 none 的字段——它们不进提示词,也不计分 |
| 2 | mix_intent.mood 放最前 | 它对其余决定有否决权,必须在提示词靠前的位置 |
| 3 | 编译 style_prompt | §4 |
| 4 | 编译段落标签序列 | §5。★ 数量必须等于 form 段落数(lint #13) |
| 5 | 编译歌词分块 | §5.3 |
| 6 | 符号路径(若后端支持) | → mc-symbolic-score |
| 7 | 编译 exclude / 负面提示 | §4.4 |
| 8 | 定种子与批量 | §7.3 |
| 9 | 写回 render.<backend> | ARR-SPEC 自己记录这次编译的结果 |
★ 第 9 步别漏:render 段是规格的一部分,
没写回去的话,下一轮 AB 就不知道上次到底送了什么进去。
4. style_prompt:把结构化字段压成散文而不丢信息
4.1 信息来源的优先顺序
从下面这些字段抽取,按这个顺序排列(越靠前越容易被模型采纳):
mix_intent.mood(一句话)meta.style_layer对应的风格词(→ L3 skill)meta.tempo、meta.keyarrangement.roster[].instrument+timbregroove.feel+ push_pull 的方向(不写毫秒,写 "bass playing ahead of the beat")vocal.persona+vocal.delivery- 年代/制作质感词
4.2 ★ 三条硬规则
- 禁用无信息形容词:
epic/emotional/beautiful/amazing/masterpiece/perfect(lint #13 软警告)。它们不携带任何可执行信息,只占位置 - 数值要转成可听的描述:
push_pull: bass −12ms→bass playing slightly ahead of the beat(不要写 −12ms) - 每个词都要能指向一个 roster 项或一个 spec 字段。 ★ 自检动作:把 style_prompt 逐词圈一遍,圈不出来源的词删掉
4.3 一个实测样本(City Pop)
1980s Japanese city pop, 112 BPM, D major, Rhodes electric piano,
16th-note muted clean guitar, electric bass playing ahead of the beat,
gated reverb snare, analog saw synth lead riff,
tenor saxophone solo in the bridge and outro,
female vocal with breathy tone mixed back, warm tape saturation
注意它的构造:年代+风格 → 速度调性 → 逐件乐器带演奏法 → 人声 → 制作质感。 没有一个形容词是空的。
4.4 exclude(负面提示)
从"这首歌不是什么"来写,不是从"不要难听"来写。
实测样本:
["EDM drop", "trap hi-hats", "modern sidechain pumping",
"orchestral epic", "fade out ending"]
★ 最后一项 fade out ending 值得注意——
淡出是生成模型的默认结尾,不排除它就一定会得到淡出
(→ mc-arrangement-arch §8 三种结尾)。
5. 段落标签与歌词
5.1 映射表
form[].name → 后端标签:
| ARR-SPEC | Suno / 多数后端 |
|---|---|
| Intro | [Intro] |
| Verse | [Verse] |
| Pre-Chorus | [Pre-Chorus] |
| Chorus | [Chorus] |
| Bridge | [Bridge] |
| Instrumental | [Instrumental] |
| Outro | [Outro] |
★ 两个映射陷阱:
- 大サビ 映射成
[Bridge],不是[Chorus](→mc-form§7)。 映射错了,后端会在内省的位置给你一个高能量副歌 - 落ちサビ(稀薄编制的副歌)仍然映射成
[Chorus], 稀薄的要求写进 style_prompt 或段落注释,不要靠改标签来表达
5.2 数量必须相等
这条规则的完整表述见 §3 步骤 4(数量必须等于 form 段落数,lint #13),§11 必过清单里也有一遍。单独留一节,是因为它是编译时最容易出错的一处:手动改动歌词段落之后,标签序列很容易忘记同步增删,少一个后端就会自己决定那一段是什么,出错时优先查这里。
5.3 歌词分块
- 歌词按段落切开,与标签一一对应
- ★ 段落内的换行会影响断句——它不只是排版,后端会当成乐句边界读
- 与作词库的接口:
LYR-SPEC的段落 id 必须与form[].id一致(→mc-workflow§5.1)
6. ★ honors 契约:本 skill 最重要的一条
每个后端在 backends.yaml 里声明它对 ARR-SPEC 各字段的执行能力:
| 取值 | 含义 | 验收时怎么算 |
|---|---|---|
| exact | 能精确执行 | 计分,不达标就是它没做到 |
| hint | 只能作为提示影响生成 | 计分,但权重打折 |
| none | 根本不接受这个字段 | ★ 排除计分,标注"本后端不支持" |
6.1 为什么 none 必须排除而不是给 0
阅读完整来源 ↗**Suno 从来没被告知精确和弦,拿"和