Skip to content

mxyhi/ok-skills / bopomofo-rescue

bopomofo-rescue

Verified

Detect and recover text that was accidentally typed with the Taiwanese Bopomofo / Zhuyin (注音) keyboard while the input method (IME) was stuck in English/ASCII mode — what Taiwanese users call 注音亂碼 or 注音文 — producing meaningless-looking letter+digit sequences such as "su3cl3a8", "cl3", "g4", "2k7", "vu,4", or such garbled runs embedded in an otherwise normal request (e.g. "help me fix su3cl3a8", "看看這個 PR qk4ru.6", "幫我改 su3cl3a8xk7"). Use this skill whenever a user message contains short ASCII tokens that look like keyboard gibberish, do not form real English words, and cannot be understood normally — especially tokens with digits interspersed among letters (tone keys 3/4/6/7 or vowel keys 8/9/0), which are a strong sign of Mandarin phonetic keystrokes typed in the wrong input mode. Run scripts/decode_bopomofo.py to deterministically map the keystrokes back to 注音 symbols with a confidence score, then interpret the intended Traditional Chinese in context and continue the user's original request without making them retype. Do NOT trigger on genuine technical strings — code, file paths, URLs, git hashes, CLI flags, package names, version numbers — the script's exclusion rules and confidence tiers already filter these out. Especially valuable for Taiwanese developers who forget to switch input methods when prompting AI coding agents.

FileKindSize
LICENSEother1.1 KB
SKILL.mdskill md8.6 KB
references/exclusion-rules.mdmarkdown2.3 KB
references/keyboard-layout.mdmarkdown2.6 KB

references/keyboard-layout.md

View on GitHub
# 大千式(標準)注音鍵盤對照表

這是台灣預設的標準注音鍵盤配置(大千式)。`scripts/decode_bopomofo.py` 的
`KEY_TO_BOPOMOFO` 就是這張表。**程式為準;這份文件供人工核對與腳本不可用時參考。**

## 完整對照

```
數字列  1ㄅ  2ㄉ  3ˇ  4ˋ  5ㄓ  6ˊ  7˙  8ㄚ  9ㄞ  0ㄢ  -ㄦ
上  排  Qㄆ  Wㄊ  Eㄍ  Rㄐ  Tㄔ  Yㄗ  Uㄧ  Iㄛ  Oㄟ  Pㄣ
中  排  Aㄇ  Sㄋ  Dㄎ  Fㄑ  Gㄕ  Hㄘ  Jㄨ  Kㄜ  Lㄠ  ;ㄤ
下  排  Zㄈ  Xㄌ  Cㄏ  Vㄒ  Bㄖ  Nㄙ  Mㄩ  ,ㄝ  .ㄡ  /ㄥ
```

## 聲調

| 聲調 | 符號 | 按鍵 |
|------|------|------|
| 一聲(陰平) | (無) | 空白鍵 |
| 二聲(陽平) | ˊ | `6` |
| 三聲(上聲) | ˇ | `3` |
| 四聲(去聲) | ˋ | `4` |
| 輕聲 | ˙ | `7` |

> 注意:26 個英文字母**全部**都對應到注音符號,所以「只看字元集」無法區分英文
> 與誤打注音。真正的判別靠「能不能完整切成合法國語音節」(見下)。

## 音節結構

一個合法國語音節 = **〔聲母〕**+**〔韻母(含介音)〕**+**〔聲調〕**,其中:

- **聲母(21)**:ㄅㄆㄇㄈ ㄉㄊㄋㄌ ㄍㄎㄏ ㄐㄑㄒ ㄓㄔㄕㄖ ㄗㄘㄙ
- **介音(3)**:ㄧ ㄨ ㄩ
- **韻尾**:ㄚㄛㄜㄝ ㄞㄟㄠㄡ ㄢㄣㄤㄥ ㄦ
- **聲調**:ˊ ˇ ˋ ˙(一聲無符號)

### 合法韻母清單(介音 + 韻尾的固定組合)

用固定清單而非「介音 + 韻尾隨意相配」,可避免 ㄩㄤ 這種不存在的組合被誤判。

```
單韻母      ㄚ ㄛ ㄜ ㄝ ㄞ ㄟ ㄠ ㄡ ㄢ ㄣ ㄤ ㄥ ㄦ
介音成韻    ㄧ ㄨ ㄩ
ㄧ 系       ㄧㄚ ㄧㄛ ㄧㄝ ㄧㄞ ㄧㄠ ㄧㄡ ㄧㄢ ㄧㄣ ㄧㄤ ㄧㄥ
ㄨ 系       ㄨㄚ ㄨㄛ ㄨㄞ ㄨㄟ ㄨㄢ ㄨㄣ ㄨㄤ ㄨㄥ
ㄩ 系       ㄩㄝ ㄩㄢ ㄩㄣ ㄩㄥ
```

**空韻聲母**(可只有聲母、無韻母):ㄓ ㄔ ㄕ ㄖ ㄗ ㄘ ㄙ
(例:是 = ㄕˋ、日 = ㄖˋ、字 = ㄗˋ)

## 驗證用例(按鍵 → 注音 → 中文)

| 按鍵 | 注音 | 中文 |
|------|------|------|
| `su3` | ㄋㄧˇ | 你 |
| `cl3` | ㄏㄠˇ | 好 |
| `a8` | ㄇㄚ | 媽/嗎/麻(視聲調與上下文) |
| `su3cl3a8` | ㄋㄧˇㄏㄠˇㄇㄚ | 你好嗎 |
| `g4` | ㄕˋ | 是 |
| `2k7` | ㄉㄜ˙ | 的 |
| `dj94` | ㄎㄨㄞˋ | 快 |
| `vu,4` | ㄒㄧㄝˋ | 謝 |
| `ji3` | ㄨㄛˇ | 我 |

> ⚠️ 常見錯誤示範:坊間有些說明把 `g4dk4` 說成「今天」、`dj94` 說成「是的」,
> 這些**都是錯的**(`g4`=是、`dk4`=課;`dj94`=快)。這正是為什麼按鍵→注音
> 一定要交給腳本,不能靠記憶或心算。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall