Delta Harmonica Tablature Generation Skill — Development skill for Claude Code

三角洲口琴谱生成器

把歌曲简谱转成《三角洲行动》「守夜人口琴」的键盘琴谱，并渲染成图片或网页。

输入一张简谱（截图 / 文本都行），输出一份琴谱：键盘字母装在方框里、歌词逐字对齐在方框下方， **升调红底、降调绿底**，长按与半长按直接标在框内，自带图例。

两种输出，按扩展名自动选：`.png` 出图（需要 Pillow），`.html` 出网页（**零依赖**，字体交给浏览器）。

依赖什么

只有两样东西，而且可以分开用：

1. scripts/render_score.py —— 纯 Python 命令行工具，没有任何 AI 相关依赖。 给一个乐谱文本文件就出结果，不用 agent 也能跑。
   • 出 PNG：需要 Pillow + 系统中文字体。
   • 出 HTML：标准库即可，不需要 Pillow，也不需要系统装中文字体。
2. SKILL.md —— 说明文档，讲「简谱怎么读对、键位怎么映射、交付前查什么」，遵循通用的 Agent Skill 格式（YAML frontmatter + Markdown 正文）。WorkBuddy、Claude Code、Cursor、豆包等 支持该格式的工具都能直接加载，但它不是 WorkBuddy 专有的。不加载它、光跑脚本也能出图， 只是少了读谱规则和自检清单。


上图由 `examples/晴天.txt` 一跑生成，可以自己复现： `python scripts/render_score.py examples/晴天.txt -o out.png` 同款网页版在 [`examples/demo-晴天.html`](examples/demo-晴天.html)。

为什么需要它

《三角洲行动》S11 赛季的「守夜人口琴」不是按 do-re-mi 弹的，而是一排键盘键 + 三个鼠标修饰键。 网上的简谱全是数字，得先翻译成键位才能弹。这个 skill 干的就是这件事，顺便把歌词对齐排好版 —— 不然你只能对着两行数字来回数格子。

安装

**方式一：当 skill 用** —— 把整个目录放进你的 agent 的 skills 目录（各家路径不同）：

# WorkBuddy
xcopy /E /I delta-harmonica-score "%USERPROFILE%\.workbuddy\skills\delta-harmonica-score"

# Claude Code
cp -r delta-harmonica-score ~/.claude/skills/

# 豆包：在「技能·连接器·伙伴」里点 + →「上传技能」，选整个目录打包的 zip
#       导入后会落在 workspace/.user_skills/delta-harmonica-score/

# Cursor / 其它支持 SKILL.md 的工具：放进它约定的 skills 目录即可

**方式二：只当命令行工具用** —— 不需要 agent，也不需要放特定目录，clone 下来就能跑：

pip install pillow
python scripts/render_score.py examples/晴天.txt -o out.png

# 不想装 Pillow 就出网页版，一条命令够用：
python scripts/render_score.py examples/晴天.txt -o out.html

字体不用管，PNG 会自动在系统里找（Windows 用宋体 + 微软雅黑，macOS 用 Songti / PingFang， Linux 扫 Noto CJK / 文泉驿等），找不到会降级，不会报错中断；实在没有中文字体的机器请直接出 HTML。

用法

在支持 SKILL.md 的 agent 里直接说「把这张简谱转成三角洲口琴谱」并附上简谱图片，它会读图、转写、出图。 或者手写乐谱文件后自己跑脚本（这条路径不依赖任何 agent）：

python scripts/render_score.py 歌曲.txt -o 歌曲-口琴谱.png --scale 2
python scripts/render_score.py 歌曲.txt -o 歌曲-口琴谱.html --scale 2

参数：

参数	说明
-o	输出路径。.png 出图，.html