lyric-reviewer 是 bitwize-music-studio/claude-ai-music-skills 技能集中的一个歌词质量检查（QC）技能，定位为 lyric-writer 与 suno-engineer 之间的质量关卡。它不写词、不改词，只负责在 Suno 生成前发现问题并提出修复方案。
用途 在生成曲目前审查歌词，提前发现押韵、韵律、发音和结构问题。输入可以是单曲路径（tracks/01-song.md）或专辑路径（artists/[artist]/albums/[genre]/album-name/）。默认执行完整审查，自动应用发音修正，并报告改动与需人工判断的项目；使用 --fix 参数时还会自动修正显式内容标记（仅元数据）。
主要能力：14 项检查清单
- 押韵检查：重复尾词、自押韵、可预测模式。
- 韵律检查：多音节词重音、倒装语序。
- 发音检查：调用 check_homographs(lyrics_text) 自动扫描同形异音词；调用 check_pronunciation_enforcement(album_slug, track_slug) 验证发音表条目是否已应用到歌词。
- 人称/时态检查：代词与时代一致性。
- 结构检查：段落标签、主歌/副歌对比、第二段发展。
- 流畅度检查：生硬押韵、倒装、别扭措辞。
- 纪录片检查（条件性）：仅当存在 RESEARCH.md 时，检查内部状态陈述、捏造引语、推测行为。
- 事实检查（条件性）：仅当存在 RESEARCH.md 时，核对姓名、日期、数字、事件。
- 长度检查：词数与目标时长对比。
- 段落长度检查：按流派上限统计每段行数。
- 押韵方案检查：是否符合流派默认方案，无孤立行或段中随机切换。
- 密度/节奏检查：主歌行数与流派默认值对比，交叉参考 BPM/情绪。
- 主歌-副歌回声检查：比较每段主歌末两行与后续副歌首两行，标记重复短语、共享押韵词、重述钩子或共享标志性意象。
- 艺人名称检查：调用 scan_artist_names(text) 扫描歌词与风格提示词，命中黑名单艺人名会导致 Suno 失败或产生意外结果。
使用方式
- 单曲：读取曲目文件，运行 14 项清单，生成验证报告。
- 专辑：Glob 所有 tracks/ 下的曲目文件，逐首运行（跳过器乐曲目），生成合并专辑报告。
- 器乐保护：若曲目 frontmatter 中 instrumental: true 或 Track Details 表标注 Instrumental | Yes，则跳过歌词审查并报告“SKIP — Instrumental track”。
- 自动修复：发音修正在 Lyrics Box 中始终自动应用（用 Notes 表中的音标拼写替换标准拼写）；--fix 参数下额外自动修正显式内容标记。押韵、韵律、双生主歌、纪录片问题、流畅度/措辞不会自动修复，需人工判断。
同形异音词验证（强制） 当检测到 live、read、lead、wind、tear、bass、bow、close 等同形异音词时：检查 Pronunciation Notes 表是否有对应条目；若有，验证音标拼写是否已应用到 Suno Lyrics Box；若缺失，标记为“Unresolved homograph — needs user decision”，不得猜测发音。流媒体歌词保留标准拼写，音标仅用于 Suno。
输出格式 生成结构化验证报告，包含：专辑名、审查曲目数、日期、执行摘要（总体状态、关键问题数、警告数、通过曲目数）、关键问题（必须修复）、警告（建议修复）、已应用的自动修复、是否可进入 Suno。严重级别分为 Critical（会导致 Suno 问题或法律风险，生成前必须修复）、Warning（质量问题，可谨慎继续）、Info（可选改进）。
质量门槛 标记“Ready for Suno”前需满足：零关键问题、所有发音注释已应用到 Lyrics Box、无未解决同形异音词、词数在流派目标范围内、纪录片类无内部状态陈述与捏造引语、警告已记录。
适用场景与限制 适用于 Suno 生成前的歌词 QC，尤其适合专辑批量审查与纪录片类歌词的事实核查。限制：不负责写词或改词；自动修复仅限 Notes 表已有用户批准音标的发音替换；同形异音词必须由用户决定，不能自动猜测；押韵、韵律、结构等问题只报告不自动修改。相关技能包括 pronunciation-specialist、explicit-checker、researchers-verifier。