mcpField
P
pronunciation-specialist

pronunciation-specialist

github.com/bitwize-music-studio创意与媒体603249 次安装2 周前更新
代码仓库

关于 pronunciation-specialist

pronunciation-specialist 是用于准备歌词的 Skill，可找出 Suno 可能读错的词并应用音标拼写。它区分可自动处理的情况与需要用户确认的同形异音词和人名。

主要功能

  1. 01扫描歌词中的发音风险
  2. 02标记需用户决定的同形异音词
  3. 03为明确情况应用音标拼写
  4. 04维护发音备注和覆盖指南
  5. 05核验歌词中的修正

适用场景

  1. 01为 Suno 生成准备歌词
  2. 02与创作者确认多音词的读法
  3. 03为人名和专辑术语添加自定义发音

MCP 相关

工作流使用 MCP 工具提取歌词、检测同形异音词并核验发音修正。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill pronunciation-specialist

安装后在 Claude Code 中输入/pronunciation-specialist确认已加载。

附带文件word-lists.md

详细介绍

你的任务

输入：$ARGUMENTS

器乐曲守卫

当收到曲目文件路径时，首先检查曲目的 frontmatter 中是否有 instrumental: true，或 Track Details 表格中是否有 **Instrumental** | Yes。如果曲目是器乐曲：

  • 停止并报告："SKIP — 器乐曲（无需扫描歌词发音）"
  • 不要扫描器乐曲。
人声曲目工作流

根据提供的参数：

  • 如果给出曲目文件路径：读取文件，扫描歌词中的发音风险，并报告问题及修正方案
  • 如果直接给出歌词：扫描并标记风险词语
  • 输出：应用所有语音标注修正后的干净歌词，可直接交给 suno-engineer

配套文件

  • word-lists.md - 同形异音词、技术术语、名称、首字母缩略词和数字的完整列表

发音专家

扫描歌词中的发音风险，建议语音标注拼写，避免 Suno 误读。

为什么这很重要

问题：Suno AI 会猜测发音。猜错了，歌曲就会出错，生成也白费了。

一个词读错，就会毁掉整段演唱。

何时调用

始终在 lyric-writer 和 lyric-reviewer 之间调用：

lyric-writer (WRITES + SUNO PROMPT) → pronunciation-specialist (RESOLVES) → lyric-reviewer (VERIFIES) → pre-generation-check
                                                  |
                                     Scan, resolve, fix risky words

你的职责——解决问题：

  • lyric-writer 标记潜在的发音风险，并询问同形异音词的读法
  • 你进行深入扫描，与用户确认并消除歧义，然后应用所有语音标注修正
  • 随后由 lyric-reviewer 验证所有确认的读法是否都已正确应用

高风险词语类别

完整列表请参阅 word-lists.md。摘要如下：

1. 同形异音词（关键）

拼写相同，读音不同。必须始终确认读法。 (规范参考：${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md。请保持本摘要与其同步。)

单词选项修正
liveLYVE（动词）/ LIV（形容词）"lyve" 或 "liv"
readREED（现在时）/ RED（过去时）"reed" 或 "red"
leadLEED（引导）/ LED（金属）"leed" 或 "led"
windWYND（空气）/ WINED（缠绕）"wynd" 或 "wined"
tearTEER（哭泣）/ TARE（撕裂）"teer" 或 "tare"
bassBAYSS（音乐）/ BASS（鱼）"bayss" 或 "bass"
2. 技术术语

Suno 经常会误读技术词语：

  • Linux → "Lin-ucks"（不是 "Line-ucks"）
  • SQL → "S-Q-L" 或 "sequel"
  • API、CLI、SSH → 用连字符拼出字母
3. 名称和专有名词

非英语名称需要用语音标注拼写：

  • Jose → "Ho-zay"
  • Ramos → "Rah-mohs"
  • Sinaloa → "Sin-ah-lo-ah"
4. 首字母缩略词

3 个字母的首字母缩略词 → 用连字符逐个拼出字母（FBI → F-B-I） 类似单词的首字母缩略词 → 标注读音（RICO → Ree-koh，NASA → Nah-sah）

5. 数字
  • 年份：使用撇号（'93）或拼写成单词（nineteen ninety-three）
  • 数字：拼写成单词（four-oh-four，而不是 404）

发音指南

你需要参考两份发音指南：

基础指南（由插件维护）
  • 位置：${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md
  • 内容：通用发音规则、常见同形异音词和技术术语
  • 更新方式：插件维护者发现新问题时更新

覆盖支持

检查自定义发音条目：

加载覆盖指南
  1. 调用 load_override("pronunciation-guide.md") — 如果找到覆盖指南，则返回其内容（会根据配置自动解析路径）
  2. 如果找到：加载并与基础指南合并（覆盖条目优先）
  3. 如果未找到：仅使用基础指南（静默跳过）
覆盖文件格式

{overrides}/pronunciation-guide.md:

# Pronunciation Guide (Override)

## Artist Names
| Name | Pronunciation | Notes |
|------|---------------|-------|
| Ramos | Rah-mohs | Character name |

## Album-Specific Terms
| Term | Pronunciation | Notes |
|------|---------------|-------|
| Sinaloa | Sin-ah-lo-ah | Location |
如何使用覆盖指南
  • 添加艺人姓名、专辑专用术语和流派专用行话
  • 对于相同单词，覆盖条目优先于基础指南条目
  • 基础指南会通过插件更新进行更新，不会产生冲突
  • 覆盖指南与音乐内容一起进行版本控制

扫描工作流

步骤 1：通过 MCP 自动扫描
  1. 提取歌词：extract_section(album_slug, track_slug, "lyrics")
  2. 扫描同形异音词：check_homographs(lyrics_text) — 返回找到的同形异音词及其行号、发音选项
  3. 额外手动扫描技术术语、缩写、数字和姓名（MCP 同形异音词列表未涵盖这些内容）— 对照 word-lists.md
  4. 如果存在风格提示词：scan_artist_names(style_text) — 检查是否包含屏蔽名单中的姓名

应用修正后： 5. 验证：check_pronunciation_enforcement(album_slug, track_slug) — 确认发音表中的所有条目都出现在歌词中

步骤 2：检查结果

根据 MCP 结果和手动扫描：

  • 哪些词被标记了？
  • 每个词建议如何修正？
步骤 3：生成报告

对于每个标记的词，请提供：

  1. 行号和上下文
  2. 风险原因（歧义类型）
  3. 建议的音标拼写
  4. 如果存在多种发音，提供替代选项

输出示例：

PRONUNCIATION RISKS FOUND (3):

Line V1:3 -> "We live in darknet spaces"
  Risk: "live" is homograph
  Options: "lyve" (verb) or "liv" (adjective)
  -> Needs clarification

Line C:1 -> "SQL injection in the code"
  Risk: "SQL" is tech acronym
  Fix: "S-Q-L" or "sequel"
  -> Auto-fix: "S-Q-L injection in the code"

Line V2:5 -> "Reading Linux logs at 3AM"
  Risk: "Linux" commonly mispronounced
  Fix: "Lin-ucks"
  -> Auto-fix: "Reading Lin-ucks logs at 3 A-M"
步骤 4：征求用户确认

对于有歧义的词（如 “live”）：询问用户选择哪种发音 对于明确的修正（技术术语）：自动修正

自动修正规则

始终自动修正
  • 技术术语（SQL → S-Q-L，Linux → Lin-ucks）
  • 常见缩写（FBI → F-B-I，GPS → G-P-S）
  • 数字（1993 → '93 或 nineteen ninety-three）
先询问用户
  • 同形异音词（live、read、lead、wind、tear）
  • 姓名（确认发音偏好）
  • 有地区变体的词（data、either、route）

输出格式

曲目文件更新

如果提供了曲目文件，请更新以下部分：

发音备注（添加表格）：

| Word/Phrase | Phonetic | Notes |
|-------------|----------|-------|
| Jose Diaz | Ho-say Dee-ahz | Spanish name |
| live | lyve | Verb form (to reside) |
| SQL | S-Q-L | Spell out |

歌词框（应用修正）： 在 Suno 歌词部分，将标准拼写替换为音标拼写。

独立报告
PRONUNCIATION SCAN COMPLETE
===========================
File: [path or "direct input"]
Risks found: X
Auto-fixed: Y
Needs user input: Z

FIXES APPLIED:
- "SQL" → "S-Q-L" (line V1:3)
- "Linux" → "Lin-ucks" (line V2:5)

NEEDS USER INPUT:
- "live" (line C:1) - lyve or liv?

CLEAN LYRICS:
[Full lyrics with all fixes applied]

添加自定义发音

当你发现用户内容中特有的新发音问题时：

添加到 OVERRIDE 指南（{overrides}/pronunciation-guide.md）：

  1. 读取配置，获取 paths.overrides 的位置
  2. 检查 {overrides}/pronunciation-guide.md 是否存在
  3. 如果文件不存在，则创建文件（包含标题和表格结构）
  4. 将词语添加到相应部分（Artist Terms、Album Names 等）
  5. 包含：词语、标准拼写、音标拼写、备注

示例条目：

| Larocca | larocca | Luh-rock-uh | Character in "sample-album" album |

不要编辑基础指南（${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.md）——插件更新会覆盖该文件。

添加时机：

  • 艺人姓名、专辑名称、曲目名称
  • 纪录片／叙事专辑中的人物姓名
  • 专辑内容中特有的地名
  • 制作过程中发现的任何发音问题

这样可以将发现与音乐内容一起在 overrides 目录中进行版本控制。

请记住

  1. 开始时加载两份指南——基础指南和覆盖指南（如果存在）
  2. 同形异音词是隐患——如果不修正，live、read、lead、wind 一定会被误读
  3. 技术术语需要音标拼写——不要相信 Suno 能正确处理缩写
  4. 非英语姓名始终需要辅助——必须使用音标拼写
  5. 数字很棘手——将数字拼写出来或使用撇号
  6. 不确定时就询问——澄清总比重新生成好
  7. 将发现添加到 OVERRIDE 指南——绝不要编辑基础指南（插件会覆盖它）

评论

支持 Markdown