Claude Code Actionで翻訳の差分だけ同期 — 変更キーのみ訳して検査

locales/
  ja.json      # 原文(人が編集する)
  en.json      # Claudeが同期する
  ko.json      # Claudeが同期する
scripts/
  lib.mjs
  changed-keys.mjs
  gate.mjs
.github/workflows/sync-translations.yml

import { execFileSync } from 'node:child_process';
import fs from 'node:fs';
 
export const flatten = (obj, prefix = '') =>
  Object.entries(obj).flatMap(([k, v]) =>
    typeof v === 'object' && v !== null
      ? flatten(v, `${prefix}${k}.`)
      : [[`${prefix}${k}`, String(v)]]);
 
export const atRef = (ref, file) => {
  try {
    return new Map(flatten(JSON.parse(
      execFileSync('git', ['show', `${ref}:${file}`], { encoding: 'utf8' }))));
  } catch { return new Map(); } // そのref時点でファイルが無い
};
 
export const now = (file) =>
  fs.existsSync(file)
    ? new Map(flatten(JSON.parse(fs.readFileSync(file, 'utf8'))))
    : new Map();
 
// {name} / {{name}} / %s / %d をプレースホルダとして取り出す
export const tokens = (s) =>
  (s.match(/\{\{?\s*[\w.]+\s*\}?\}|%[sd]/g) ?? []).sort().join(' ');

// 使い方: node scripts/changed-keys.mjs <baseRef>
import fs from 'node:fs';
import { atRef, now } from './lib.mjs';
 
const base = atRef(process.argv[2], 'locales/ja.json');
const head = now('locales/ja.json');
 
const changed = {};
for (const [k, v] of head) if (base.get(k) !== v) changed[k] = v;
const removed = [...base.keys()].filter((k) => !head.has(k));
 
fs.mkdirSync('.i18n', { recursive: true });
fs.writeFileSync('.i18n/changed.json',
  JSON.stringify({ changed, removed }, null, 2));
console.log(`翻訳対象 ${Object.keys(changed).length} キー / 削除 ${removed.length} キー`);

// 使い方: node scripts/gate.mjs <baseRef> <対象言語>... (終了コード 1 = 不合格)
import { atRef, now, tokens } from './lib.mjs';
 
const [ref, ...langs] = process.argv.slice(2);
const ja = now('locales/ja.json');
const jaBase = atRef(ref, 'locales/ja.json');
const changed = new Set([...ja.keys()].filter((k) => jaBase.get(k) !== ja.get(k)));
let failed = false;
const ng = (lng, msg) => { console.log(`[${lng}] ${msg}`); failed = true; };
 
for (const lng of langs) {
  const file = `locales/${lng}.json`;
  const head = now(file);
  const before = atRef(ref, file);
 
  for (const k of changed) {
    if (!head.has(k) || head.get(k).trim() === '') { ng(lng, `未翻訳: ${k}`); continue; }
    if (before.has(k) && before.get(k) === head.get(k)) { ng(lng, `未更新: ${k}`); continue; }
    if (tokens(ja.get(k)) !== tokens(head.get(k)))
      ng(lng, `プレースホルダ不一致: ${k}  原文={${tokens(ja.get(k))}} 訳={${tokens(head.get(k))}}`);
  }
  for (const [k, v] of before) {
    if (!ja.has(k)) { if (head.has(k)) ng(lng, `削除漏れ: ${k}`); continue; }
    if (!changed.has(k) && head.get(k) !== v) ng(lng, `対象外のキーが変更: ${k}`);
  }
  for (const k of head.keys())
    if (!ja.has(k) && !before.has(k)) ng(lng, `余剰: ${k}`);
}
if (!failed) console.log('OK: 変更キーだけが更新され、プレースホルダも一致しています');
process.exit(failed ? 1 : 0);

翻訳対象 2 キー / 削除 1 キー
[en] 未更新: cart.total
[en] 未翻訳: cart.coupon
[en] 削除漏れ: legacy
exit=1

[en] プレースホルダ不一致: cart.coupon  原文={code} 訳={codigo}
[en] 対象外のキーが変更: greeting
[en] 削除漏れ: legacy
exit=1

OK: 変更キーだけが更新され、プレースホルダも一致しています
exit=0

name: Sync translations
on:
  pull_request:
    paths:
      - "locales/ja.json"
 
concurrency:
  group: i18n-sync-${{ github.event.pull_request.number }}
  cancel-in-progress: true
 
jobs:
  translate:
    # 公開リポジトリのforkからのPRにはシークレットが渡らないので同一リポジトリに限る
    if: github.event.pull_request.head.repo.full_name == github.repository
    runs-on: ubuntu-latest
    timeout-minutes: 10
    permissions:
      contents: write
      pull-requests: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          ref: ${{ github.event.pull_request.head.ref }}
          fetch-depth: 0
 
      - id: base
        env:
          BASE_REF: ${{ github.base_ref }}
        run: |
          echo "sha=$(git merge-base "origin/$BASE_REF" HEAD)" >> "$GITHUB_OUTPUT"
 
      - run: node scripts/changed-keys.mjs ${{ steps.base.outputs.sha }}
 
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            .i18n/changed.json を読み、locales/en.json と locales/ko.json を
            編集してください。
            - changed のキーだけ、日本語の値を訳して該当キーに書く
            - removed のキーは両ファイルから削除する
            - それ以外のキーには触れない
            - 終わったら node scripts/gate.mjs ${{ steps.base.outputs.sha }} en ko
              を実行し、OK になるまで直す
          claude_args: |
            --max-turns 8
            --allowedTools "Read,Edit,Bash(node scripts/gate.mjs:*)"
 
      - name: ゲート
        run: node scripts/gate.mjs ${{ steps.base.outputs.sha }} en ko
 
      - name: 変更範囲の確認
        run: |
          extra=$(git status --porcelain | grep -v -E ' locales/(en|ko)\.json$' || true)
          if [ -n "$extra" ]; then echo "$extra"; exit 1; fi
 
      - name: コミット
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add locales/en.json locales/ko.json
          git diff --cached --quiet && exit 0
          git commit -m "update: ja.json の変更キーを翻訳"
          git push

## 翻訳ルール(locales/)
 
- 原文は locales/ja.json。en.json と ko.json は同じキー構造で書く
- `{name}` `{{amount}}` `%s` はそのまま残す。中身を訳さない・消さない
- 語順は文に合わせて動かしてよい
- 用語: 「カート」= cart / 「クーポン」= coupon / 「保存」= Save
- UIのボタンは命令形(Save, Apply)、通知文は現在形
- 訳せない固有名詞は原文のまま残し、理由を報告する
- gate.mjs の出力が OK になるまで終了しない