技能介绍

要解决的问题

直接手写 LilyPond 的 .ly 源码，在终端里处理钢琴谱、踏板、琶音和力度记号时很容易踩坑：\relative 链式八度在把柱式和弦改成流动琶音时会悄悄漂移；( ) 与 ~ 分别代表连音线和延音线，用错了记谱语义就变了；\sustainOn、\ped 这类踏板写法和 \set PianoStaff.connectArpeggios 等跨谱表选项也散落在官方文档各处，临时翻文档很打断节奏。另一个常见需求是验证改动：改完谱子要在本地同时产出 PDF 和 MIDI，并确认渲染结果没有排版或八度错误。

技能如何工作

这个 skill 提炼自 LilyPond v2.24 官方 Notation Reference，按场景把参考内容拆进了 references/ 分册，在对话中按需加载：

音高与八度：pitches.md，重写左手或改琶音前必读，避免八度漂移
节拍与连音：rhythm-beams.md，音值、连音群（beaming）与延音线（tie）
表情与演奏法：expressive.md，连音线（slur）、琶音（arpeggio）、颤音与呼吸
力度记号：dynamics.md，\p \mf \f 与渐强渐弱的 \ ... \!
钢琴谱：piano.md，PianoStaff、跨谱表、延音踏板、跨谱表琶音
MIDI 与 layout：midi-score.md，score 结构、\layout/\midi、MIDI 乐器与音量

使用时通常按这个顺序推进：先读 .ly 源码，识别 PianoStaff/Staff/Voice 的声部结构和 \relative 还是 \fixed 的八度模式；再针对本次改动点查阅对应分册；改的时候遵循官方示例语法，琶音尽量用 \fixed 或显式八度（如 c' c''）；然后执行 lilypond --pdf file.ly 渲染并同时生成 MIDI；出错先查 midi-score.md 末尾的常见错误清单；最后用图像查看核对 PDF 视觉细节，或用 timidity/fluidsynth 试听 MIDI。

适用边界与注意点

适合在终端环境里对已有 .ly 文件做迭代：改连音线、加踏板、调整力度、把和弦改成琶音、修正八度、渲染验证等。它不替代 LilyPond 本体，渲染依赖本地安装的 LilyPond 可执行文件；文件首行的 \version "2.24.4" 需要与本地 lilypond --version 匹配，版本不一致会直接影响解析结果。SKILL.md 聚焦记谱法层面的操作，涉及更复杂的排版自定义、跨谱表大谱表结构或 MIDI 音色库细节时，仍需要回到官方文档。