前言¶

用 Suno 做古风、国风歌曲时，常见卡点不在「有没有歌词」，而在两端对不上：一边是审美和格律，一边是 Custom Mode 里的英文 Style of Music 和带 [Verse]、[Chorus] 标签的 Lyrics。自己手写往往要么词像样、风格框填不准，要么风格词堆满、中文段落结构 Suno 吃不进去。反复试听后再改「加二胡、欢快一点、换男声」，还要自己猜该改哪一段 prompt。

下面介绍 SkillHub 社区 Skill「画音灵匠」（@user_1793b15c/ai-music-prompt）。它把主题收束、古风写词、结构化 spec、Suno 双框组装和「人话微调」串成一条可迭代流程，并附带短语库、风格词表与诊断脚本。Skill 本身不生成音频，生成仍在 Suno 端完成。

这是什么¶

画音灵匠是面向国风/古风场景的 AI 音乐提示词 Skill：把脑中的主题与试听反馈，翻译成 Suno Custom Mode 的两个输入框，并在写词侧叠加四字短语、对仗、意象与高级感技法约束。

• 坐标：@user_1793b15c/ai-music-prompt
• SkillHub 版本：1.0.2（页面标注 v1.0.2；包内 SKILL.md 自述工作流为 v7.x）
• 来源：community（社区发布）
• 分类：design-media；子类含「图片生成」「音频处理」（SkillHub 页面元数据）
• 维护方：SkillHub 发布者 七仔的AI工具箱（user_1793b15c）；包内 README.md 注明 v6 作者 DuMate，v7 为桥梁化升级
• 标签：requires_api_key=false（无需单独配置 API Key）
• 平台数据（SkillHub 抓取）：评分 100000，下载 944 次，安装 0；安全扫描状态为「安全，无风险」

与「只产歌词」的工具相比，它显式区分左半边（写词）与右半边（Suno 翻译层 + 微调指令解释），并强调「生成 → 试听 → 微调」回路。

核心功能¶

以下能力均来自包内 SKILL.md、README.md 与脚本说明，安装后由 Agent 按 SKILL.md 工作流调用。

1. 写词（左半边）¶

• 借助 data/ 下四字短语、古典意象、诗意表达、对仗库，以及 v7.1 的 craft_patterns.json、references/lyric_craft_advanced.md，约束「具象化情感、二元对立、双关、哲理包装、翻案、情景交融」等写法。
• 古风场景可用 scripts/phrase_tools.py 取短语，并用 pypinyin 做押韵、平仄校验（缺库时降级为字符数检查，组装与微调仍可用）。

2. 组装 Suno prompt（右半边）¶

• 用 JSON spec 描述 genre、mood、instruments、tempo、vocal、language、arrangement 等字段。
• scripts/suno_prompt_builder.py 将 spec 与歌词文件输出：
• Style of Music（英文风格串）
• Lyrics（自动把【主歌】等映射为 [Verse]、[Chorus] 等标签）
• 中文描述到 Suno 英文 token 的映射在 data/suno_style_vocab.json；语法与坑见 references/suno_style_guide.md。

3. 微调（听懂指挥）¶

• scripts/finetune.py 解析如「副歌加二胡，再欢快一点，换成男声」类指令，解释改动、更新 spec，并可 --apply 写回文件。
• 指令对照见 references/finetune_command_dict.md。

4. 改歌诊断¶

• scripts/diagnose_song.py 支持交互、按症状关键词或 --list 列出分类，结合 data/symptoms.json 与 references/diagnose_guide.md，把试听后的「怪」落成可执行的改 prompt 建议，并可与 finetune.py 串联。

5. 示例曲目¶

• songs/ 目录含多首示例的 *_lyrics.txt、*_spec.json、*_suno.json 及导入 Suno 的文本，可供对照流程，非运行时依赖。

安装与启用¶

SkillHub 官方安装说明见 skillhub.cn/install/skillhub.md。要点如下。

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装画音灵匠到当前 Agent 的 skills 目录¶

必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不被加载。

skillhub install @user_1793b15c/ai-music-prompt --dir <你的 skills 目录>

常见路径（同官方文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

也可在 SkillHub 页面下载 Zip（v1.0.2）后解压到上述目录之一：

# 页面提供的下载地址示例
curl -fsSL -o ai-music-prompt-1.0.2.zip \
  "https://api.skillhub.cn/api/v1/download?slug=@user_1793b15c/ai-music-prompt"

安装后按所用客户端要求重启或刷新 Agent，使 SKILL.md 被纳入技能列表。

3. Python 依赖（运行脚本时）¶

在 Skill 目录或项目环境中：

pip install pypinyin

官方说明：Python 3.8+；无 pypinyin 时押韵/平仄检查降级，组装与微调不受影响。

典型用法¶

以下步骤复现包内「快速开始」与主工作流，路径以 Skill 根目录为当前工作目录。

写词阶段取短语¶

python scripts/phrase_tools.py --scene 自然景象 --rhyme ang --count 8

Agent 按 SKILL.md 写满【主歌】【副歌】【桥段】后，可进入组装。

组装 Suno 双框¶

先准备 spec.json（字段见上文），以及歌词文件，例如 歌词.txt：

python scripts/suno_prompt_builder.py \
  --spec spec.json --lyrics-file 歌词.txt --title 惊鸿 --out prompt.json

将输出中的 Style of Music 与 Lyrics 分别粘贴到 Suno Custom Mode 两个输入框，在 Suno 端生成试听。

试听后微调¶

python scripts/finetune.py --spec spec.json \
  --command "副歌加二胡，再欢快一点，换成男声" --apply

再执行一次 suno_prompt_builder.py 生成新 prompt，形成迭代。

听感异常时诊断¶

python scripts/diagnose_song.py --interactive
# 或
python scripts/diagnose_song.py --symptom "戏腔很假"

将诊断结果中的 cmd 交给 finetune.py，或按输出的英文片段调整 Style。

向 Agent 的自然语言请求也可直接描述主题，例如「写首伤感的古风女声歌」；SKILL.md 要求在不反复追问的前提下用合理默认补齐并继续。

适用场景与注意¶

适合谁

• 用 Suno 做国风/古风、需要稳定「歌词结构 + 英文风格框」协作的创作者或开发者。
• 希望把试听反馈收成可重复执行的 prompt 改动，而不是每次从零改文案的人。
• 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里编排音乐相关任务的用户。

限制与坑（Skill 自述）

1. Suno 模型与风格词效果会随平台演进变化，Skill 提供的是经验上的通用写法，最终以 Suno 生成为准。
2. 中文歌词在 Suno 中可能出现发音偏差，生僻字、多音字建议先用 phrase_tools.py 检查。
3. finetune.py 依赖关键词识别，非常规说法可能无法命中，需参考 finetune_command_dict.md 中的表述。
4. SkillHub 页面概述字段为空，详细行为以安装包内 SKILL.md 为准；包内文档版本号（v7.x）与 SkillHub 发布版本号（1.0.2）并存，以文件内容为准使用即可。

结尾¶

画音灵匠把国风写词、Suno 工程语法和试听后的微调、诊断收成一套 Agent 可执行的提示词工作流，适合作为「人和 Suno 之间」的翻译层，而不是替代 Suno 本身出歌。

• SkillHub 页面：https://www.skillhub.cn/skills/user_1793b15c/ai-music-prompt
• 官方坐标链接：https://api.skillhub.cn/user_1793b15c/ai-music-prompt