Claude Codeでstrings.xmlを翻訳 — 未訳とplurals崩れをlintで止める

## Android 文字列の翻訳規約
 
- 基準言語は `app/src/main/res/values/strings.xml`(英語)。翻訳先は `values-ja`
- `translatable="false"` の文字列は訳さない。`values-ja` にも書かない
- `%1$s` `%2$d` などの書式指定子は、位置番号と型を変えない。語順に合わせた並べ替えは可
- `plurals` は日本語では `other` だけを書く(`one` は書かない)
- 文中の `'` は `\'` と書くか、文字列全体を二重引用符で囲む
- 基準側に無いキーを `values-ja` に足さない。基準側で消えたキーは訳側からも消す
- 編集後は `python3 scripts/check_strings.py app/src/main/res` を実行し、0件になるまで直す

#!/usr/bin/env python3
"""strings.xml の基準言語と翻訳先を突き合わせる。使い方: check_strings.py <res ディレクトリ> [基準 values] """
import re, sys
import xml.etree.ElementTree as ET
from pathlib import Path
 
# 数による語形変化を持たない言語は other だけを使う(Android の plurals)
PLURAL_QUANTITIES = {"ja": {"other"}, "zh": {"other"}, "ko": {"other"}, "en": {"one", "other"}}
SPEC = re.compile(r"%(?:(\d+)\$)?[-#+ 0,(]*\d*(?:\.\d+)?([a-zA-Z%])")
 
def specs(text):
    """書式指定子を [(位置, 変換)] で返す。%% は除く。位置指定なしは 0。"""
    return sorted((int(p or 0), c) for p, c in SPEC.findall(text or "") if c != "%")
 
def load(path):
    root = ET.parse(path).getroot()
    strings, plurals = {}, {}
    for el in root:
        name = el.get("name")
        text = "".join(el.itertext())
        if el.tag == "string":
            strings[name] = (text, el.get("translatable") != "false")
        elif el.tag == "plurals":
            plurals[name] = {i.get("quantity"): "".join(i.itertext()) for i in el}
    return strings, plurals
 
def main(res, base_dir="values"):
    res = Path(res)
    base_s, base_p = load(res / base_dir / "strings.xml")
    errors = []
    for loc_dir in sorted(res.glob("values-*")):
        f = loc_dir / "strings.xml"
        if not f.exists() or not re.fullmatch(r"values-[a-z]{2,3}(-r[A-Z]{2})?", loc_dir.name):
            continue
        lang = loc_dir.name.split("-")[1]
        s, p = load(f)
        err = lambda key, msg: errors.append(f"{loc_dir.name}: {key}: {msg}")
        for k, (txt, tr) in base_s.items():
            if tr and k not in s:
                err(k, "MissingTranslation 基準にあるが未翻訳")
            if not tr and k in s:
                err(k, 'translatable="false" の文字列が訳側にある')
            if tr and k in s and specs(txt) != specs(s[k][0]):
                err(k, f"書式指定子が一致しない 基準={specs(txt)} 訳={specs(s[k][0])}")
        for k, (txt, _) in s.items():
            if k not in base_s:
                err(k, "ExtraTranslation 基準に無い")
            if re.search(r"(?<!\\)'", txt) and not txt.strip().startswith('"'):
                err(k, "アポストロフィがエスケープされていない")
        for k, items in base_p.items():
            if k not in p:
                err(k, "MissingTranslation plurals が未翻訳")
                continue
            want = PLURAL_QUANTITIES.get(lang)
            if want and set(p[k]) != want:
                err(k, f"quantity が {sorted(want)} と一致しない 実際={sorted(p[k])}")
            base_spec = specs(items.get("other", ""))
            for q, t in p[k].items():
                if specs(t) != base_spec:
                    err(k, f'quantity="{q}" の書式指定子が基準の other と違う')
        for k in p:
            if k not in base_p:
                err(k, "ExtraTranslation 基準に無い plurals")
    for e in errors:
        print(e)
    print(f"{len(errors)} 件")
    return 1 if errors else 0
 
if __name__ == "__main__":
    sys.exit(main(*sys.argv[1:3]))

values-ja: app_name: translatable="false" の文字列が訳側にある
values-ja: save: MissingTranslation 基準にあるが未翻訳
values-ja: sync_done: 書式指定子が一致しない 基準=[(1, 's'), (2, 's')] 訳=[(1, 's'), (2, 'd')]
values-ja: old_banner: ExtraTranslation 基準に無い
values-ja: note_count: quantity が ['other'] と一致しない 実際=['one', 'other']
5 件

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-strings.sh"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "sh -c 'python3 \"$CLAUDE_PROJECT_DIR/scripts/check_strings.py\" \"$CLAUDE_PROJECT_DIR/app/src/main/res\" >&2 || exit 2'"
          }
        ]
      }
    ]
  }
}

#!/bin/sh
# PostToolUse で標準入力に来る JSON に strings.xml が含まれるときだけ検査する
grep -q 'strings\.xml' || exit 0
python3 "$CLAUDE_PROJECT_DIR/scripts/check_strings.py" \
  "$CLAUDE_PROJECT_DIR/app/src/main/res" >&2 || exit 2

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <issue id="MissingTranslation" severity="fatal" />
    <issue id="StringFormatCount" severity="error" />
    <issue id="UnusedQuantity" severity="error" />
</lint>

<resources xmlns:tools="http://schemas.android.com/tools" tools:locale="en">