这是什么
lyric-writing-skills 是一套专为 AI 助手（Claude Code 和 OpenAI Codex）设计的歌词创作专业技能集，包含 17 个独立的 skill 文件，提炼自 29 本横跨四种语言的书籍——英语写作手册、中文音律与作词法、粤语实践、韩语音系学，以及 Sondheim 带评注的歌词集。这些技能把专业词人多年积累的判断标准，转变成可执行的检查清单和决策路由，让 AI 生成的歌词从“押韵但平庸”提升到“有选择、有意图”的专业水准。
该仓库由作者 jtydhr88 维护，遵循 MIT 协议，目前获得 115 Stars、16 Forks，且没有未解决的 Issues。它同属一个更大的音乐创作系列，还包括作曲编排库（music-composition-skills），两者可独立使用或通过规格表协同工作。
适合谁
- 独立音乐人：需要快速产出高质量歌词，尤其是母语为中文、粤语或韩语的创作者。
- 词曲作者：希望借助 AI 帮助构思创意，但拒绝接受“平庸的平均值”输出。
- 短视频创作者：为抖音/B站等平台制作配乐或原创歌曲，需要符合热梗旋律的歌词。
- 歌词编辑或评论者：希望有一套客观、可复用的标准来评审歌词。
- AI 工具爱好者：想尝试将 Claude Code 或 Codex 应用于创意写作的实践者。
能做什么
这套技能通过一个核心流程（lw-workflow）将歌词创作拆解为多个环节，每个 skill 负责一个专业维度：
- 意图门（lw-song-intent）：动笔前强制回答五个问题，明确这首歌只表达一件事、对谁说、在什么时刻、用哪个贯穿物件。
- 结构层（lw-structure）：定义每个段落的功能，确保副歌、主歌、桥段的职责清晰。
- 语言层：针对普通话（lw-mandarin）、粤语（lw-cantonese）、英语（lw-english）、日语（lw-japanese）、韩语（lw-korean）分别处理声调、音节、重音等硬约束。
- 押韵与意象（lw-rhyme, lw-imagery）：把押韵当成结构工具而非装饰，并构建由具体名词组成的意象体系。
- 倒字检测（lw-tone-check）：客观计算汉字声调与旋律是否冲突，防止“唱出来变成另一个词”。
- AI味诊断（lw-ai-tell-audit）：在交付前运行，找出 AI 生成的典型“模板化”痕迹。
- 风格层：中国风（lw-chinese-style）、说唱（lw-rap）、音乐剧（lw-musical-theatre）等专门类型。
所有输出都附有一份“LYR-SPEC”歌词规格表，记录歌词的唯一主张、听众、时刻、贯穿物件、每行音节数、重音位置、押韵方案、故意不对称和语言层检查结果。这份规格表既是创作的依据，也是最终评审的凭证。
使用前准备
- 安装 Claude Code 或 OpenAI Codex（支持 CLI 或桌面应用）。
- 熟悉对应工具的插件或技能加载机制。
- 建议先浏览 README_ZH.md（中文版文档）了解整体设计。
- 如果计划同时写配乐，可另外安装姊妹库 music-composition-skills。
安装方法
Claude Code（推荐：插件市场）
/plugin marketplace add jtydhr88/lyric-writing-skills
/plugin install lyric-writing@lyric-writing-skills安装后通过 /lyric-writing: 调用，例如 /lyric-writing:lw-workflow。
Claude Code（个人全项目）
git clone https://github.com/jtydhr88/lyric-writing-skills.git
cp -r lyric-writing-skills/plugins/lyric-writing/skills/* ~/.claude/skills/Claude Code（单个项目）
mkdir -p .claude/skills
cp -r lyric-writing-skills/plugins/lyric-writing/skills/* .claude/skills/Codex
codex plugin marketplace add jtydhr88/lyric-writing-skills
# 然后：Plugins → 选择 Lyric Writing Skills → Install也可以将相同文件复制到 ~/.agents/skills/（个人）或 .agents/skills/（项目）。
验证：当 agent 检测到相关上下文时，技能会自动加载。使用 /skills 列出已加载技能。
使用示例
以下是一些已在端到端跑通的典型场景，直接向 AI 发送指令即可：
- “为这段旋律写歌词，这里是小节数和每行音节数” → 调用 lw-workflow（音乐优先路线）→ lw-song-intent → lw-structure → lw-mandarin。
- “这版草稿读着还行但感觉套路化，我说不出为什么” → lw-ai-tell-audit 会列出八种 AI 典型痕迹，再进入对应技能修正。
- “给这段粤语旋律填词” → lw-cantonese 先按音高类计算，再选字；写作顺序与普通话相反。
- “把这段主歌改成rap” → lw-rap（韵密度、多音节押韵、普通话转移表）。
- “检查这行按我的词唱出来还是不是原词” → lw-tone-check 检查每段高峰、每句首字和大跳落点。
更复杂的组合：例如“写一首指定歌手的国语流行歌，女声，带歌词”——会同时用到歌词库和作曲库，产出 LYR-SPEC 和 ARR-SPEC 两份规格表。
风险与注意事项
- 本库不包含任何音乐作品、编排或歌词成品——它只提供判断标准和工作流；是否使用、值不值得，由你自己评估。
- 技能文件本身以中文编写（因为多数原始资料为中文原著或译本），但无论你用哪种语言提问，agent 都会用相应语言回复。
- 完整的专业工作流处理一首歌可能耗时 20 分钟以上，这是用时间换取质量的设计。
- 粤语和普通话的声调约束不可互相替代，必须使用对应语言层。
- 当与作曲库结合时，两者通过规格表交换字段（段落ID、小节数、拍号、调性等），务必遵循通信协议，否则可能产生不一致。