feat: unify and enhance skills md

Author: josix

.claude/skills/check-terminology/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: check-terminology
+description: Checks terminology consistency against project glossary and identifies zh_CN terms that need conversion to zh_TW. Use to verify term usage.
+argument-hint: <term-or-po-file>
+---
+
+# check-terminology
+
+Check terminology against project glossary and zh_CN/zh_TW mappings.
+
+## Terminology Sources
+
+1. **Primary:** `glossary.po` - Official Python glossary translations
+2. **Secondary:** `focused_terminology_dictionary.csv` - 118 key terms
+3. **Tertiary:** `.scripts/google_translate/utils.py` - zh_CN to zh_TW mappings
+
+## Check Process
+
+### For a Single Term
+1. Search in `../translate-po/references/terminology.md`
+2. Check if it's in `references/keep-in-english.md`
+3. If found, use the standard translation
+4. If not found, check `glossary.po` in project root
+
+### For a PO File
+1. Extract all translated terms from msgstr
+2. Cross-reference against glossary
+3. Identify forbidden zh_CN terms
+4. Report inconsistencies
+
+## Error Categories
+
+### Category 1: Forbidden Terms (Must Fix)
+zh_CN terms that must be converted to zh_TW.
+
+Example violations:
+- `函數` -> should be `函式`
+- `返回` -> should be `回傳`
+- `對象` -> should be `物件`
+
+### Category 2: Inconsistent Terms (Should Review)
+Same English term translated differently across files.
+
+### Category 3: Missing from Glossary (Informational)
+New terms not yet in the glossary.
+
+## Context Decision Log
+
+When a reviewer decides a translation depends on nearby context (above/below),
+record the decision here for future reference. Keep entries short and specific.
+
+Format:
+- **Term/pattern:** ...
+- **Decision:** ...
+- **Context cue:** ...
+- **Example:** `source` -> `translation`
+
+Example:
+- **Term/pattern:** 類型 / 型別
+- **Decision:** 用語依上下文；Python 型別物件用「型別」，一般分類用「類型」
+- **Context cue:** 出現 `int/str/dict/type` 或 "type object"
+- **Example:** "two types of packages" -> "兩種類型的套件"
+
+Decision Log:
+- **Term/pattern:** 類型 / 型別
+- **Decision:** 用語依上下文；Python 型別物件用「型別」，一般分類用「類型」
+- **Context cue:** 出現 `int/str/dict/type` 或 "type object"
+- **Example:** "two types of packages" -> "兩種類型的套件"
+
+## Quick Lookup
+
+1. Check `../translate-po/references/terminology.md` first (authoritative, 186 terms)
+2. If term should stay in English, see `references/keep-in-english.md`
+
+## References
+
+- `../translate-po/references/terminology.md` - Complete term translations (186 terms)
+- `references/keep-in-english.md` - Terms that stay in English

.claude/skills/check-terminology/references/keep-in-english.md

@@ -0,0 +1,73 @@
+# Terms to Keep in English
+
+These terms should NOT be translated. They remain in English in all translations.
+
+## Python Keywords
+
+All Python keywords stay in English:
+```
+def, class, if, else, elif, for, while, try, except, finally,
+with, as, pass, break, continue, raise, assert, yield, from,
+global, nonlocal, del, in, is, not, and, or, return, import,
+async, await, lambda, True, False, None
+```
+
+## Built-in Type Names (in code context)
+
+When referring to actual Python types in code:
+```
+int, float, str, bytes, bool, complex
+list, tuple, dict, set, frozenset
+iterator, generator, iterable
+range, slice, type, object
+```
+
+Note: In prose, these may be translated (e.g., "a list" -> "一個串列")
+
+## Standard Library Modules
+
+Module names stay in English:
+```
+os, sys, re, json, pickle, collections, itertools, functools,
+datetime, logging, unittest, typing, asyncio, pathlib, etc.
+```
+
+## Exception Class Names
+
+All exception names stay in English:
+```
+Exception, ValueError, TypeError, AttributeError, KeyError,
+IndexError, ImportError, RuntimeError, NameError, StopIteration,
+FileNotFoundError, PermissionError, ConnectionError, TimeoutError,
+NotImplementedError, MemoryError, RecursionError, ZeroDivisionError,
+OverflowError, UnboundLocalError, AssertionError, SyntaxError,
+IndentationError, TabError, UnicodeError, UnicodeDecodeError,
+UnicodeEncodeError, UnicodeTranslateError
+```
+
+## Special Method Names
+
+All dunder methods stay in English:
+```
+__init__, __str__, __repr__, __len__, __getitem__, __setitem__,
+__delitem__, __contains__, __iter__, __next__, __enter__, __exit__,
+__call__, __new__, __del__, __eq__, __hash__, __bool__, etc.
+```
+
+## Technical Terms (Context Dependent)
+
+These may stay in English in technical contexts:
+- `runtime` (執行時期 in prose)
+- `mock`, `patch` (testing terms)
+- `pickle` (serialization)
+- `GIL` (Global Interpreter Lock)
+- `API` (Application Programming Interface)
+- `URL`, `HTTP`, `HTML`, `JSON`, `XML`
+- `CPU`, `RAM`, `I/O`
+
+## Brand/Project Names
+
+- Python, CPython, PyPy, Jython
+- Sphinx, reStructuredText (reST)
+- GitHub, GitLab
+- NumPy, pandas, Django, Flask