delta-harmonica-tablature-generation-skilllisted
Install: claude install-skill SUPER-NIUs/Delta-harmonica-tablature-generation-skill
# 三角洲口琴谱生成 · 三角洲行动守夜人口琴
把简谱转成《三角洲行动》「守夜人口琴」的键盘键位谱,出**一张白底 PNG 图**。
产物是**一张给人照着弹的图** —— 优先级永远是 **清楚 > 好看 > 信息量**,不是考据报告。
## 〇、四条铁律
**1. 读谱只读一遍。** 看不清的细节(八度点、附点、小节线)按最常见的情况处理,交付时提一句。
**禁止**分区放大重读、重复 OCR、"验证识别结果"、为同一行做二次核对。
> 例外:用户给的是**低清图片**时,"读一遍"要读得聪明。用
> `python3 scripts/read_jianpu.py 简谱.png -o 工作目录` 把八度点跑出来,
> **看一眼它生成的 `overlay.png`**(红圈=检测到的点,圈错圈漏一眼可见),再动手转写。
> 这仍然只算一轮,但远比肉眼看糊图可靠。方法细节见 `references/read-jianpu-image.md`。
**2. 不许追查版本。** 同一首歌的 G 调 / D 调、简谱 / 吉他谱 / 弹唱谱来源**必然对不上**。
**选一个用**,交付时一行说明(如"按 D 调版本"),然后继续往下做。
**禁止**为确定"原版是什么调"去比对多个谱源、试唱验证、逐句交叉核对、判定"唯一标准"。
**3. 核对最多一轮。** 转写完扫一眼第六节清单,就可以交付。
不允许出现"我正在进一步验证……"这类反复推进。宁可交一份 95% 准的谱让用户指错,
也不要为了最后几个音无限核对。
**4. 多出来的音符直接丢。** 弹唱谱天然带装饰音,音符数多于歌词数是常态。按歌词取骨干音,
不要为了"用上"多余音符去改歌词,也不要去凑数。
> 这四条是硬性预算。**超预算的核对 = 任务失败**,不是认真。
## 一、范围
**用户给了谱 → 按他给的那张谱做,给多少做多少**,不要自己挑一段出来。
(他会给一张,说明那整张都是他要的。)
**用户没给谱(只给歌名/音频)→ 才启用下面的预算**,目的是防止为了找谱无限搜索:
- **只做一个段落**:默认副歌;判断不出哪段是副歌,就取开头。不要搜整首歌。
- 长度 **8–12 句**,约一副歌即可。
- 检索次数 **≤ 2 次**(找谱 1 次 + 补细节最多 1 次)。搜不到就直接说"需要你提供简谱",不要硬凑。
- 交付时明确告诉用户:**只做了副歌(N 句),要主歌 / 第二段 / 换个段落说一声。**
- **用户给的谱读不清**(糊、排版乱):说明哪一段看不清,请他补一张或给文本版。
不要硬猜,**也不要去找别的谱源交叉验证**。
## 二、核心映射(硬规则,不许自行改动)
**音级 → 键盘**:
| 简谱 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 1̇ |
|---|---|---|---|---|---|---|---|---|
| 按键 | Z | X | C | V | B | N | M | , |
**八度 → 修饰键 + 底色**:
| 简谱记号 | 游戏内操作 | 图上底色 |
|---|---|---|
| 中音(数字无点) | 直接按键 | 白底黑字 |
| 高音(数字上方一点) | 按住鼠标**右**键 | **红底** |
| 低音(数字下方一点) | 按住鼠标**左**键 | **绿底** |
| 升/降号 `#` `b` | 按住鼠标**中**键 | 黄底(用到才出现图例) |