| name | detect-mistranslation |
| description | 多言語スクリーンショットを比較して翻訳品質をチェックし、問題があれば GitHub Issue を作成する。翻訳追加後の品質チェック、多言語対応の検証、リリース前の翻訳確認で使用する (取り込み元: bannzai/Focus の同名 skill) |
Detect Mistranslation
多言語スクリーンショットを比較して翻訳品質をチェックし、問題があれば GitHub Issue を作成する。
スクリーンショット生成の基盤は MementoMorningSnapshotUITests ターゲット + scripts/snapshot_ui_tests/ (詳細は scripts/snapshot_ui_tests/README.md)。
実行手順
1. ガイドラインの確認
.claude/rules/localization-guidelines.md で翻訳ガイドラインを確認するscripts/snapshot_ui_tests/README.md でスクリプト群の使い方を確認する
2. 多言語スクリーンショットの生成
./scripts/snapshot_ui_tests/generate_snapshot_ui_test_screenshots.sh
- UITest はローカルシミュレータでしか実行できない (リモート simulator では不可。CLAUDE.md「検証方法」のローカル sim フォールバックに該当)
- 対象言語は
MementoMorningSnapshotUITests/Languages.swift が SSOT (現状 ja / en)
- 出力先:
scripts/snapshot_ui_tests/screenshots/{テストクラス名}/{インデックス}/{言語}.png
3. 翻訳品質チェックの実行
./scripts/snapshot_ui_tests/check_translation_quality.sh
./scripts/snapshot_ui_tests/check_translation_quality.sh --dry-run
チェック項目: 文脈に合わない翻訳 / 用語の不統一 / 文字切れ・表示崩れ / 未翻訳 / 機械翻訳の不自然さ
4. 結果の確認と対応
問題が検出された場合:
- スクリプトが GitHub Issue を作成する (Issue へのスクリーンショット添付には Cloudflare R2 の環境変数が必要。
scripts/snapshot_ui_tests/upload_to_r2.sh のコメント参照)
- Issue の内容を確認し、本番の
MementoMorning/Localizable.xcstrings を修正する (App Store スクショのキャッチコピーは AppStoreScreenshots/Localizable.xcstrings が別カタログ)
- 修正後、再度スクリーンショットを生成してチェックする
完了基準: すべての対象言語でスクリーンショットが生成され、上記チェック項目の問題が検出されないこと。日本語訳の欠落は scripts/find_missing_ja_translations.py で別途検出できる
