copy_tuner_client 2.1.2 → 2.2.1

data/skills/copy-tuner-to-locales-cleanup/SKILL.md

@@ -64,9 +64,10 @@ bin/rails runner '
 > NOTE: ここで `export` を実行できるのは gem がまだ入っているから。完了判定は gem 撤去より**前**に行う。
 
 > 補助目印: migrate は prefix を移すたびにオリジナル（`0000_original_*.yml`）から該当サブツリーを削除するので、
-> 全移行完了時点で `0000_original_*.yml` はほぼ空（残るのは非表現値の隔離 `0005_rails_non_blurb.yml` 等のみ）に
-> なっているはず。`local_first_key?` のマッチ判定が主の関門で、ファイルが空かどうかは副次的な目視確認。
-> 食い違うとき（regexp は全マッチなのにオリジナルに blurb 化できるキーが残っている等）は削除漏れを疑う。
+> **全移行を経た場合**は `0000_original_*.yml` がほぼ空になっているはず（非表現値も `migrate_prefix.rb` が
+> 移行分側の `--out` へ再適用済みで、オリジナル側に隔離ファイルとして残ることはない）。`local_first_key?`
+> のマッチ判定が主の関門で、ファイルが空かどうかは副次的な目視確認。食い違うとき（regexp は全マッチなのに
+> オリジナルに blurb 化できるキーが残っている等）は削除漏れを疑う。
 
 ### 2. 最終不正キーチェック
 
@@ -129,8 +130,7 @@ copyray コメント注入も消える。あわせて `config/environments/*.rb`
 
 - copy_tuner 専用の deploy ワークフローファイル（main push で翻訳をデプロイする専用ファイル）… 丸ごと削除。
 - AI エージェント用ワークフローの `mcp__copy-tuner__*` allowedTools 許可 … 削除。
-- CI の「翻訳を export するステップ」… migrate-prefix の初回で削除済みのはず。**まだ残っていれば**ここで削除する
-  （`git grep copy_tuner .github/` で確認）。
+- CI の「翻訳を export するステップ」… ここで削除する（`git grep copy_tuner .github/` で確認）。
 
 ### 6. deploy / 起動スクリプトを撤去
 

data/skills/copy-tuner-to-locales-migrate-prefix/SKILL.md

@@ -2,24 +2,33 @@
 name: copy-tuner-to-locales-migrate-prefix
 description: >-
   copy_tuner（CopyTuner / copy_tuner_client）で集中管理している i18n データを、prefix（正規表現）単位で
-  Rails 標準の config/locales（YAML）管理へ段階移行するスキル。gem の local_first_key_regexp を使い、
-  1 回につき 1 prefix をローカルへ寄せて regexp に積み上げる。全 prefix 完了後の gem 撤去は
-  copy-tuner-to-locales-cleanup スキルで行う。
+  Rails 標準の config/locales（YAML）管理へ移すスキル。gem の local_first_key_regexp を使うので、
+  gem を残したまま特定 prefix だけをローカル管理にできる（部分ローカル化）。1 回の実行で 1 prefix。
+  全 prefix を移して gem ごと撤去したい場合は繰り返し、完了後 copy-tuner-to-locales-cleanup スキルへ進む。
+  対象 prefix はスキル引数で指定でき、未指定なら export を俯瞰して選定する。
 disable-model-invocation: true
 ---
 
-# copy_tuner → config/locales 段階移行スキル（prefix 単位）
+# copy_tuner → config/locales prefix 単位ローカル化スキル
 
-copy_tuner（`copy_tuner_client` gem）で集中管理している i18n データを、**prefix（正規表現）単位で**少しずつ
-Rails 標準の `config/locales` 配下の YAML 管理へ移していくためのワークフロー。**1 回の実行で 1 prefix だけ**
-移行し、これを繰り返す。全 prefix の移行が完了したら `copy-tuner-to-locales-cleanup` スキルで gem・CI・
-deploy・docs・MCP をまとめて撤去する。
+copy_tuner（`copy_tuner_client` gem）で集中管理している i18n データを、**prefix（正規表現）単位で**
+Rails 標準の `config/locales` 配下の YAML 管理へ移すためのワークフロー。**1 回の実行で 1 prefix だけ**扱う。
+
+使い方は 2 つある:
+
+- **部分ローカル化** — 特定 prefix だけを恒久的に `config/locales` 管理にする。**gem は残したまま**で、
+  CopyTuner 管理と locales 管理の二層が**定常状態**になる。
+- **全移行** — 上記を全 prefix ぶん繰り返す。全 prefix の移行が完了したら
+  `copy-tuner-to-locales-cleanup` スキルで gem・CI・deploy・docs・MCP をまとめて撤去する。
+
+**どちらの用途でもこのスキルがやること（手順 0〜10）は同一**で、差は「何回回すか」と「最後に cleanup へ
+進むか」だけ。
 
 このスキルは**特定のリポジトリに依存しない**。project_id・ファイルパス・CI 構成はプロジェクトごとに異なるので、
 固有値を覚えるのではなく**毎サイクル、自分が編集する箇所（initializer の regexp・config/locales）を探索して
 見つけ直す**（手順 2）。種別ごとの典型例は `references/example-touchpoints.md` を参照。
 
-## なぜ prefix 単位で段階移行するのか
+## なぜ prefix 単位で切るのか
 
 一発で全 i18n をローカル化すると、移行漏れ（ローカル YAML に書き忘れたキー）が**一斉に未訳化**して事故になる。
 prefix 単位なら、移した範囲だけが影響を受け、移行漏れはその範囲の未訳として小さく顕在化する。安全な prefix から
@@ -38,11 +47,21 @@ prefix 単位なら、移した範囲だけが影響を受け、移行漏れは
 - マッチしないキーは従来どおり CopyTuner キャッシュ優先 → 無ければローカル、という動作のまま。
 - regexp は**単一**（配列非対応）。複数 prefix は `Regexp.union` で 1 本に積み上げる。
 
-gem を残したまま regexp に prefix を足していくだけなので、移行途中でも CopyTuner と config/locales が安全に
-共存する。
+gem を残したまま regexp に prefix を足していくだけなので、CopyTuner と config/locales は安全に共存する。
+部分ローカル化ならこの共存が定常状態、全移行なら移行途中の状態としてそのまま成り立つ。
 
 ## ワークフロー（1 サイクル = 1 prefix）
 
+### 0. 対象 prefix の受け取り（引数）
+
+スキル引数で対象 prefix を渡せる（例: `devise` / `activerecord.attributes` / `views.users`）。
+
+- **引数あり** … それを今回の対象とし、**手順 4 の選定はスキップ**する。ただし**手順 3 の全件 export は
+  実行する**（手順 6 の `--export` 入力として必須なので省けない）。
+- 引数の prefix が export に**存在しなければ**、その旨をユーザーに報告して中断する（手順 6 のスクリプトも
+  同じ条件で異常終了するが、手順 3 の時点で気づけるほうが早い）。
+- **引数なし** … 従来どおり手順 4 の基準で 1 つ選び、**選定結果をユーザーに提示してから**手順 5 へ進む。
+
 ### 1. gem 前提確認
 
 `local_first_key_regexp` が使えるバージョンの `copy_tuner_client` が入っているか確認する。
@@ -65,14 +84,13 @@ grep 結果はセッションをまたいで残らない（複数セッション
 git grep -nI 'local_first_key_regexp' -- ':!vendor' ':!tmp' ':!node_modules'
 ls config/locales
 
-# 初回だけ触る（手順 9・10 用）: CI の export ステップと i18n 方針ドキュメント
-git grep -nI -e 'copy_tuner:export' -e 'CopyTuner' -- '.github/' 'doc/' 'CLAUDE.md'
+# 手順 9 用: i18n 方針ドキュメント
+git grep -nI 'CopyTuner' -- 'doc/' 'CLAUDE.md'
 ```
 
 - 手順 6・7 で毎回触る **initializer の `local_first_key_regexp`** の位置と、**`config/locales/`** の採番慣習
   （例: `00_`・`10_`）を確認する。
-- 手順 9（CI の export ステップ削除）・手順 10（方針ドキュメントの中間状態更新）で**初回だけ**触る箇所も
-  ここで場所だけ押さえる。
+- 手順 9（i18n 方針ドキュメントの更新）で触る箇所も、ここで場所だけ押さえる。
 
 #### 2-1. （初回のみ）既存 locales を `0000_original_` プレフィックスへリネーム
 
@@ -101,8 +119,12 @@ cleanup は自前で touchpoint を grep し直す。**このスキルでそれ
 
 ### 3. 残 prefix の把握
 
-全件を export して俯瞰し、移行済み（現在の `local_first_key_regexp` がマッチする）prefix と未移行 prefix を
-一覧化する。export は一時ファイルへ書く（`tmp/` 等の捨て場）。
+全件を export して俯瞰し、ローカル化済み（現在の `local_first_key_regexp` がマッチする）prefix と
+copy_tuner 管理のまま残っている prefix を一覧化する。export は一時ファイルへ書く（`tmp/` 等の捨て場）。
+
+対象 prefix が引数で指定されている場合、この一覧化は**対象 prefix が export に存在することの確認と規模把握**の
+ためになる（選定は不要）。いずれの場合も `rake copy_tuner:export` の**実行自体は必須**で、出力は手順 6 の
+`--export` 入力になる。
 
 ```bash
 bundle exec rake copy_tuner:export[tmp/copy_tuner_all.yml]
@@ -114,7 +136,10 @@ bundle exec rake copy_tuner:export[tmp/copy_tuner_all.yml]
 
 ### 4. 対象 prefix の選定
 
-残 prefix から **1 つ**選ぶ。影響が小さく構造が安定したものから始め、最後に大物（`views`）を回す:
+**引数で prefix が指定されている場合はこの手順をスキップ**し、手順 5 へ進む。
+
+残 prefix から **1 つ**選ぶ。以下の順序は**安全度の目安**で、影響が小さく構造が安定したものから始め、最後に
+大物（`views`）を回す:
 
 1. **gem 由来（最安全・先行）**: `devise` / `good_job` / `ice_cube` / `restrict_dependent_destroy` 等。
    値が安定しアプリ実装に依存しにくい。
@@ -123,8 +148,8 @@ bundle exec rake copy_tuner:export[tmp/copy_tuner_all.yml]
 3. **バリデーションメッセージ**: `activerecord.errors` / `activemodel.errors`。テストで検知しやすい。
 4. **モデル名・カラム名**: `activerecord.models` / `activerecord.attributes` / `activemodel.attributes` /
    `activerecord.enums`。プロジェクトの i18n 方針で「新規キー登録の例外」とされていることが多い
-   （プロジェクトの i18n 方針ドキュメントでそう規定されていることが多い）。**全撤去がゴールなのでこの prefix も最終的に移行対象に含める**。
-   例外規定の撤廃は cleanup で行う。
+   （プロジェクトの i18n 方針ドキュメントでそう規定されていることが多い）。**全 prefix を移行する場合は
+   この prefix も対象に含める**（例外規定の撤廃は cleanup で行う）。
 5. **画面テキスト（最大・最後）**: `views` / `text`。量が多く画面影響が大きいので最後に回し、画面確認の比重を
    上げる。1 回が大きすぎるなら `views.<controller>.` の 2 階層目で更に刻んでよい（regexp を `\Aviews\.users\.`
    のように書ける）。
@@ -197,6 +222,15 @@ prefix 内で `date.formats`（文字列・export 勝ち）と `date.order`（
 > 束ねている。スクリプトが中断した場合は `--out` のファイルだけが残る（オリジナルは無傷）ので、原因を直して
 > 再実行するか `--out` を消してやり直す。
 
+> NOTE: スクリプトは「対象 prefix の削除で実際に内容が変わったファイルだけ」を書き戻す（変更が無ければ
+> `File.write` をスキップする）。とはいえ `--originals-glob` の指定ミス等で意図しないファイルが対象に
+> 入っていないとも限らないため、実行後は必ず `git diff --stat config/locales/` で「対象 prefix を含む
+> はずのファイルだけに差分が出ているか」を確認する。対象 prefix と無関係なはずのファイルに差分が出て
+> いたら `git checkout -- <file>` で復元し、原因（`--originals-glob` や `--prefix` の指定）を見直す。
+
+> NOTE: 書き戻されたファイルでは**コメント・空行が失われる**（YAML 標準ライブラリはこれらを保持しない。
+> 値・エイリアス参照は保たれる）。`git diff` を見て惜しいコメントがあれば手で戻すこと。
+
 ### 7. local_first_key_regexp に prefix を追加
 
 initializer（`config/initializers/copy_tuner.rb` 等）の `CopyTunerClient.configure` ブロックで、
@@ -233,33 +267,31 @@ config.local_first_key_regexp = Regexp.union(
 > `bin/rails runner 'p CopyTunerClient.configuration.local_first_key?("<prefix>.foo")'` が `true`、隣接キー
 > （`reviews.*` 等）が `false` になることを確認しておくとよい。
 
-### 9. （初回のみ）CI の Export ステップを削除
+### 9. i18n 方針ドキュメントを更新
 
-CI で copy_tuner を export しているステップ（テストワークフロー内で `bin/rake copy_tuner:export` を走らせる類）
-は、**テスト起動前にローカルキャッシュを温める保険**にすぎない。
-このステップを削除すると、test 環境は initializer 起動時の `cache.download`（CopyTuner サーバから都度取得）
-だけになり、**本番と同じ挙動**になる。未移行 prefix も引き続きサーバから解決できるので、移行途中に消しても安全。
+i18n 方針ドキュメント（`doc/` 等）が「copy_tuner で管理／config/locales は使わない」のまま残ると、
+他の作業者や AI が「新規キーを copy_tuner と locales のどちらに足すか」を誤判断する。用途に応じて書き分ける
+（テンプレ文は `references/example-touchpoints.md` にある）:
 
-> WARNING: `config.disable_test_translation = true` は**入れない**こと。入れると test で CopyTuner DL が
-> 止まり、未移行 prefix が一斉に未訳化する。Export ステップ（保険）だけを消すのが正しい。
+- **部分ローカル化** … 「移行中」ではなく**恒久的な二層管理**として書く。「以下の prefix は config/locales
+  管理」「それ以外は copy_tuner 管理」「新規キーの追加先はどちら」の 3 点を明記する。
+- **全移行** … 「copy_tuner から config/locales へ段階移行中」＋現在ローカル化済みの prefix を列挙する
+  （最終形への書き換えは cleanup で行う）。
 
-### 10. ドキュメントの中間状態を更新
+いずれも prefix を増やすたびに列挙を更新する。
 
-i18n 方針ドキュメント（`doc/` 等）が「copy_tuner で管理／config/locales は使わない」のまま残ると、移行途中で
-他の作業者や AI が「新規キーを copy_tuner と locales のどちらに足すか」を誤判断する。**移行中であることと、
-現在ローカル化済みの prefix を明記する**。中間状態テンプレ文は `references/example-touchpoints.md` にある。
-prefix を増やすたびに、列挙も更新する。
+### 10. 結果を報告
 
-### 11. 残 prefix を報告
+今回ローカル化した prefix と、現在の `local_first_key_regexp` を報告して 1 サイクル終了。加えて:
 
-移行済み prefix・残 prefix の一覧と、現在の `local_first_key_regexp` を報告して 1 サイクル終了。
-残 prefix があれば次サイクルでこのスキルを再実行する。全 prefix が移行済みになったら
-`copy-tuner-to-locales-cleanup` スキルへ進む。
+- **部分ローカル化** … これで完了。残りの prefix は copy_tuner 管理のままが定常状態なので、次サイクルは不要。
+- **全移行** … copy_tuner 管理のまま残っている prefix の一覧も報告する。残りがあれば次サイクルでこのスキルを
+  再実行する。全 prefix がローカル化済みになったら `copy-tuner-to-locales-cleanup` スキルへ進む。
 
 ## 1 サイクル完了の目安
 
 - 手順 6 のスクリプトが**移行漏れゼロを確認して正常終了**し、`--out`（`0010_` 以降）に対象 prefix が配置され、
   `0000_original_*.yml` から該当サブツリーが削除されている（非表現値は `--out` 側に保持済み）。
 - `local_first_key_regexp` に対象 prefix が `\A` アンカー付きで追加されている（手順 7）。
-- 中間状態ドキュメントの「ローカル化済み prefix」が更新されている（手順 10）。
+- i18n 方針ドキュメントの「config/locales 管理の prefix」が更新されている（手順 9）。
 - （任意）rspec/画面で `translation missing` が出ないことをユーザー判断で確認（手順 8）。

data/skills/copy-tuner-to-locales-migrate-prefix/references/example-touchpoints.md

@@ -61,7 +61,8 @@ end
 
 → オリジナルを `0000_original_` で先頭固定し、移行分は `0010_` 以降に置く。重複キーはロード順の**後勝ちで
 export 側が勝つ**（手作業マージ不要）。prefix を移行するたびにオリジナルから該当サブツリーを削除し、残存＝
-未移行 prefix の進捗マーカーにする（最終的にオリジナルが空＝全移行完了）。
+未移行 prefix の進捗マーカーにする（**全 prefix を移行する場合は最終的にオリジナルが空になる**）。
+部分ローカル化では、対象外 prefix がオリジナルに残り続けるのが**定常状態**であり、空にならなくてよい。
 
 → Rails 標準フォーマットの **配列**（`date.abbr_day_names` 等）・`date.order` の `:year` 等の**シンボル配列**・
 `number.*.precision` 等の**非表現値**は copy_tuner で表現できず export に出てこないため、`date`/`number` を移行
@@ -69,10 +70,10 @@ export 側が勝つ**（手作業マージ不要）。prefix を移行するた
 移行分（`0010_` 以降）の中へ**非表現値ごと取り込む**。別ファイルへの隔離は不要（詳細は
 `references/export-and-split.md`）。
 
-### CI — [migrate]（Export ステップのみ初回で削除） / [cleanup]（残り）
+### CI — [cleanup]
 
 - **CI の翻訳 export ステップ**（テストワークフロー内で `bin/rake copy_tuner:export` を走らせる類）…
-  「翻訳 DL 失敗でテストがコケないように」の保険。**[migrate] の初回で削除**（test が本番同等の
+  「翻訳 DL 失敗でテストがコケないように」の保険。**[cleanup] で削除**（test が本番同等の
   `cache.download` 挙動になる）。`disable_test_translation` は入れない。
 - **copy_tuner 専用の deploy ワークフロー**（main push で翻訳をデプロイする専用ファイル）…
   **[cleanup] で丸ごと削除**。
@@ -88,10 +89,11 @@ export 側が勝つ**（手作業マージ不要）。prefix を移行するた
 
 `config/environments/production.rb` の `config.i18n.fallbacks = true` 等。標準バックエンドでも有効なので確認のみ。
 
-### ドキュメント / スキル / MCP — [migrate]（中間状態更新） / [cleanup]（最終化・撤去）
+### ドキュメント / スキル / MCP — [migrate]（用途別に更新） / [cleanup]（最終化・撤去）
 
 - **i18n 方針ドキュメント**（`CLAUDE.md`・`doc/` 配下等）… 「copy_tuner サーバで i18n データを管理 /
-  config/locales 配下は利用しない / 新規キー登録は基本禁止」等の記述。**[migrate] で中間状態に更新**、
+  config/locales 配下は利用しない / 新規キー登録は基本禁止」等の記述。**[migrate] で更新**（部分ローカル化なら
+  恒久的な二層管理として、全移行なら段階移行中の中間状態として。テンプレは後掲）。全移行の場合のみ
   **[cleanup] で最終化**。上記を参照している他のドキュメント（`CLAUDE.md` 等）も連動。
 - **copy_tuner MCP 操作スキル**（`.claude/skills/` 配下）… **[cleanup] で無効化/削除**。
 - **補助ドキュメント** … 「多言語対応: copy_tuner サーバで i18n データを管理」のような記述を持つコマンド定義等。
@@ -107,10 +109,28 @@ copy_tuner 側のキー数・export YAML の行数はプロジェクト次第だ
 `restrict_dependent_destroy` 等。これらのトップセクションが prefix 移行の基本粒度。`views` が最大になりやすいので
 最後に回す。
 
-## i18n 方針ドキュメント中間状態テンプレ（[migrate] 手順 10 で使う）
+## i18n 方針ドキュメントテンプレ（[migrate] 手順 9 で使う）
 
-移行中はこのような記述に置き換える。`<列挙>` は現在 `local_first_key_regexp` にマッチしている prefix に
-更新する（prefix を増やすたびに更新）。
+用途に応じて 2 版ある。`<列挙>` は現在 `local_first_key_regexp` にマッチしている prefix に更新する
+（prefix を増やすたびに更新）。
+
+### 部分ローカル化版
+
+「移行中」ではなく、この状態が**恒久的に続く二層管理**であることを明記する。
+
+```markdown
+### 国際化（i18n）
+
+- **一部の prefix は config/locales（YAML）管理、それ以外は copy_tuner サーバ管理**
+- config/locales 管理の prefix（`local_first_key_regexp` にマッチ）: `<列挙>`
+- 上記以外の prefix は copy_tuner サーバで管理
+- **新規キーの追加先**: 上記 prefix のキーは config/locales へ。それ以外は copy_tuner へ
+- 複数形化対応は不要（日本語環境）
+```
+
+### 全移行版
+
+「段階移行中」であることと、いずれ cleanup で最終化される中間状態であることを明記する。
 
 ```markdown
 ### 国際化（i18n）
@@ -122,5 +142,6 @@ copy_tuner 側のキー数・export YAML の行数はプロジェクト次第だ
 - 複数形化対応は不要（日本語環境）
 ```
 
-> [cleanup] で全 prefix 完了後、この中間記述は「config/locales 管理。copy_tuner 廃止。新規キーは
-> config/locales へ。複数形化不要」に最終化する（モデル名・カラム名の例外規定も撤廃）。
+> 上記**全移行版にのみ係る注記**: [cleanup] で全 prefix 完了後、この中間記述は「config/locales 管理。
+> copy_tuner 廃止。新規キーは config/locales へ。複数形化不要」に最終化する（モデル名・カラム名の例外規定も
+> 撤廃）。部分ローカル化版は cleanup を経由しないため、この最終化は適用されない。

data/skills/copy-tuner-to-locales-migrate-prefix/scripts/migrate_prefix.rb

@@ -8,6 +8,10 @@
 #   bin/rails runner .claude/skills/copy-tuner-to-locales-migrate-prefix/scripts/migrate_prefix.rb \
 #     -- --prefix date --export tmp/copy_tuner_all.yml --out config/locales/0010_date.yml
 #
+# このスクリプト自身の自己検証（gem メンテナ向け。Rails も bundler も不要）:
+#
+#   ruby skills/copy-tuner-to-locales-migrate-prefix/scripts/migrate_prefix.rb --self-test
+#
 # What it does, in one pass:
 #   (1) Place : extract the target prefix subtree from the 0000_original_*.yml
 #       originals (load-order deep_merge), deep_merge the export subtree on top
@@ -29,6 +33,127 @@
 require 'optparse'
 require 'yaml'
 
+# ---- self-test ----
+# 引数パースより前に分岐する。このスクリプトはトップレベルで即実行する造りなので、`--self-test` の
+# ときは本体へ進ませずテストだけ走らせてトップレベル return で抜ける。
+if ARGV.delete('--self-test')
+  require 'minitest/autorun'
+  require 'tmpdir'
+  require 'fileutils'
+  require 'rbconfig'
+
+  # 本体はトップレベルで exit するため load では検証できない。fixture を tmpdir に作り、i18n だけを
+  # 直接設定する薄いランナー経由でサブプロセス実行する（スクリプトが触るのは I18n.load_path と
+  # Backend::Simple だけなので Rails は不要）。
+  class MigratePrefixSelfTest < Minitest::Test
+    SCRIPT = File.expand_path(__FILE__)
+    # 対象 prefix（date）を持つファイル。これだけが書き戻し対象になるのが期待挙動。
+    WITH_PREFIX = "ja:\n  date:\n    formats:\n      default: \"%Y\"\n"
+    WITHOUT_PREFIX = "ja:\n  greeting: \"hello\"\n"
+    # 片方だけが対象 prefix を持つ 2 ファイル構成。「1 ファイルだけ書き戻る」ことの検証に使う。
+    MIXED_FILES = { '0000_original_a.yml' => WITH_PREFIX, '0000_original_b.yml' => WITHOUT_PREFIX }.freeze
+    EXPORT_JA = "ja:\n  date:\n    formats:\n      default: \"%Y/%m/%d\"\n"
+    EXPORT_JA_EN = "#{EXPORT_JA}en:\n  date:\n    formats:\n      default: \"%m/%d/%Y\"\n".freeze
+    # to_yaml の既定 line_width（80）を確実に超える長さにして折り返しを誘発する。
+    LONG_VALUE = (['word'] * 60).join(' ').freeze
+
+    def test_untouched_file_keeps_bytes
+      # コメント・空行・ダブルクォートが 1 バイトも変わらないことを見る。
+      untouched = <<~YAML
+        ja:
+          # これは greeting のコメント
+          greeting: "hello"
+
+          farewell: "bye"
+      YAML
+      migrate({ '0000_original_a.yml' => WITH_PREFIX, '0000_original_b.yml' => untouched }) do |out, dir|
+        # binread は ASCII-8BIT を返すため、UTF-8 の期待値を b で揃えてバイト列として比較する。
+        assert_equal(untouched.b, read(dir, '0000_original_b.yml'), "無関係なファイルが書き換わった:\n#{out}")
+      end
+    end
+
+    def test_missing_locale_root_is_not_added
+      migrate(MIXED_FILES, locales: %w[ja en], export: EXPORT_JA_EN) do |_out, dir|
+        MIXED_FILES.each_key do |name|
+          refute_includes(read(dir, name), 'en:', "#{name} に元ファイルに無い en ルートが新設された")
+        end
+      end
+    end
+
+    def test_prefix_is_pruned_from_matching_file
+      migrate({ '0000_original_a.yml' => "#{WITH_PREFIX}  greeting: \"hello\"\n" }) do |_out, dir|
+        assert_equal({ 'ja' => { 'greeting' => 'hello' } }, load_yaml(dir, '0000_original_a.yml'))
+        assert_equal(
+          { 'ja' => { 'date' => { 'formats' => { 'default' => '%Y/%m/%d' } } } },
+          load_yaml(dir, '0010_migrated.yml')
+        )
+      end
+    end
+
+    def test_long_value_is_not_wrapped
+      migrate({ '0000_original_a.yml' => "#{WITH_PREFIX}  greeting: \"#{LONG_VALUE}\"\n" }) do |_out, dir|
+        body = read(dir, '0000_original_a.yml')
+        assert_includes(body, "greeting: #{LONG_VALUE}\n", "長い値が折り返された:\n#{body}")
+      end
+    end
+
+    def test_summary_counts_changed_files
+      migrate(MIXED_FILES) do |out, _dir|
+        assert_includes(out, 'オリジナル 2 ファイル中 1 ファイル')
+      end
+    end
+
+    private
+
+    # fixture を tmpdir に配置してサブプロセス実行し、標準出力と locales ディレクトリを yield する。
+    def migrate(files, locales: %w[ja], export: EXPORT_JA)
+      Dir.mktmpdir do |dir|
+        locales_dir = File.join(dir, 'config/locales')
+        FileUtils.mkdir_p(locales_dir)
+        FileUtils.mkdir_p(File.join(dir, 'tmp'))
+        files.each { |name, body| File.write(File.join(locales_dir, name), body) }
+        File.write(File.join(dir, 'tmp/export.yml'), export)
+        write_runner(dir, locales)
+
+        ok, out = spawn_script(dir, locales)
+        assert(ok, "スクリプトが異常終了した:\n#{out}")
+        yield(out, locales_dir)
+      end
+    end
+
+    def write_runner(dir, locales)
+      File.write(File.join(dir, 'runner.rb'), <<~RUBY)
+        require 'i18n'
+        I18n.load_path = Dir['config/locales/*.yml']
+        I18n.available_locales = #{locales.map(&:to_sym).inspect}
+        I18n.default_locale = #{locales.first.to_sym.inspect}
+        load #{SCRIPT.inspect}
+      RUBY
+    end
+
+    def spawn_script(dir, locales)
+      args = [
+        '--prefix', 'date', '--locales', locales.join(','),
+        '--export', 'tmp/export.yml', '--out', 'config/locales/0010_migrated.yml'
+      ]
+      Dir.chdir(dir) do
+        read_io, write_io = IO.pipe
+        pid = spawn(RbConfig.ruby, File.join(dir, 'runner.rb'), '--', *args, out: write_io, err: write_io)
+        write_io.close
+        out = read_io.read
+        _, status = Process.waitpid2(pid)
+        [status.success?, out]
+      end
+    end
+
+    def read(dir, name) = File.binread(File.join(dir, name))
+
+    def load_yaml(dir, name) = YAML.safe_load_file(File.join(dir, name))
+  end
+
+  return
+end
+
 # NOTE: `bin/rails runner` は Kernel#abort が投げる SystemExit を握りつぶし終了コードが 0 になる
 # （実機確認済み）。中断を呼び出し側へ確実に伝えるため、abort ではなく warn + exit(1) を使う。
 def die(message)
@@ -40,12 +165,16 @@ end
 options = {}
 parser =
   OptionParser.new do |opts|
-    opts.banner = 'Usage: bin/rails runner migrate_prefix.rb -- --prefix PREFIX --export PATH --out PATH [--regexp PATTERN] [--originals-glob GLOB]'
+    opts.banner =
+      'Usage: bin/rails runner migrate_prefix.rb -- --prefix PREFIX --export PATH --out PATH ' \
+      '[--regexp PATTERN] [--originals-glob GLOB]'
     opts.on('--prefix PREFIX', 'ドット区切りの対象 prefix（例: date / activerecord.attributes）') { |v| options[:prefix] = v }
     opts.on('--export PATH', '全件 export YAML（手順3で出力）') { |v| options[:export] = v }
     opts.on('--out PATH', '移行分の出力先（例: config/locales/0010_date.yml）') { |v| options[:out] = v }
     opts.on('--regexp PATTERN', 'leaf キー検証用の正規表現（省略時は prefix から \A<prefix>\. を生成）') { |v| options[:regexp] = v }
-    opts.on('--originals-glob GLOB', 'オリジナルファイルの glob（既定: config/locales/0000_original_*.yml）') { |v| options[:originals_glob] = v }
+    opts.on('--originals-glob GLOB', 'オリジナルファイルの glob（既定: config/locales/0000_original_*.yml）') do |v|
+      options[:originals_glob] = v
+    end
     opts.on('--locales LIST', 'カンマ区切りの対象 locale（既定: I18n.available_locales。検証用の上書き）') { |v| options[:locales] = v }
   end
 # `bin/rails runner script -- ...` の `--` 以降だけを渡したいが、runner が剥がさない環境もあるため両対応。
@@ -156,7 +285,12 @@ end
 # locale ルートを持つ raw Hash（`{ "ja" => {...}, "en" => {...} }`）から、対象 prefix を全 locale で刈った
 # 新しい Hash を返す（非破壊）。移行漏れ検証のシミュレーションと実削除の両方で使う。
 def prune_prefix_all_locales(raw, locales, keys)
-  locales.reduce(raw) { |acc, locale| acc.merge(locale => prune_prefix(acc[locale] || {}, keys)) }
+  locales.reduce(raw) do |acc, locale|
+    # 元ファイルに無い locale ルートを新設すると、ja だけのファイルに `en: {}` が追記されてしまう。
+    next acc unless acc.key?(locale)
+
+    acc.merge(locale => prune_prefix(acc[locale], keys))
+  end
 end
 
 # ---- (1) 配置 ----
@@ -186,9 +320,7 @@ LOCALES.each do |locale|
 end
 
 # 全 locale でスキップ＝当該 prefix がどこにも存在しない（prefix の typo）。
-if merged_by_locale.empty?
-  die("prefix '#{PREFIX}' のキーが export にもオリジナルにも見つからない。prefix を確認すること。")
-end
+die("prefix '#{PREFIX}' のキーが export にもオリジナルにも見つからない。prefix を確認すること。") if merged_by_locale.empty?
 
 # ---- (2) 静的ガード（書き出し前にできる検証を先に。中途半端な --out を残さない）----
 # --out が次回起動時に Rails の i18n glob でロードされる場所か（採番ミス・配置ミスの検出）。
@@ -206,7 +338,10 @@ merged_by_locale.each do |locale, merged|
   non_matching = leaf_entries(merged).keys.grep_v(regexp)
   next if non_matching.empty?
 
-  die("locale #{locale}: regexp #{regexp.inspect} にマッチしない leaf キーがある（regexp/prefix 不一致）:\n  #{non_matching.join("\n  ")}")
+  die(
+    "locale #{locale}: regexp #{regexp.inspect} にマッチしない leaf キーがある（regexp/prefix 不一致）:\n  " \
+    "#{non_matching.join("\n  ")}"
+  )
 end
 
 # 書き出し（ここまでの検証を通過してから）。merged_by_locale は { "ja" => {...}, "en" => {...} } 形なので
@@ -217,7 +352,9 @@ puts "配置: #{out_path} （locale #{merged_by_locale.keys.join(',')} / leaf
 
 # YAML ラウンドトリップ（to_yaml → 再読込で各 locale の merged と一致するか）。
 merged_by_locale.each do |locale, merged|
-  die("YAML ラウンドトリップ不一致。書き出し結果が壊れている: #{out_path} (locale #{locale})") unless load_locale_tree(out_path, locale) == merged
+  next if load_locale_tree(out_path, locale) == merged
+
+  die("YAML ラウンドトリップ不一致。書き出し結果が壊れている: #{out_path} (locale #{locale})")
 end
 
 # ---- (3) 移行漏れ検証（削除をメモリ上でシミュレート）----
@@ -270,10 +407,18 @@ unless leaks.empty?
   die('中断。--out の内容・採番・regexp を確認すること。')
 end
 
-original_files.each do |f|
-  raw = YAML.safe_load_file(f, permitted_classes: [Symbol], aliases: true) || {}
-  File.write(f, prune_prefix_all_locales(raw, LOCALES, prefix_keys).to_yaml)
-end
+changed =
+  original_files.count do |f|
+    raw = YAML.safe_load_file(f, permitted_classes: [Symbol], aliases: true) || {}
+    pruned = prune_prefix_all_locales(raw, LOCALES, prefix_keys)
+    # 対象 prefix を含まないファイルを to_yaml で書き戻すと、クォート・アンカー名・折り返し・コメントの
+    # 無関係な整形差分が出る。実質的な変更があるファイルだけ書き戻す。
+    next false if pruned == raw
+
+    # 折り返しだけは line_width で無効化できる（アンカー名・クォートは Psych の仕様で制御できない）。
+    File.write(f, pruned.to_yaml(line_width: -1))
+    true
+  end
 
-puts "削除: prefix '#{PREFIX}' をオリジナル #{original_files.size} ファイルから刈り取った。"
+puts "削除: prefix '#{PREFIX}' をオリジナル #{original_files.size} ファイル中 #{changed} ファイルから刈り取った。"
 puts '完了。手順7（local_first_key_regexp 追加）が未済なら次に実施すること。'

data/skills/copy-tuner-to-t-migrate/scripts/migrate_tt.rb

@@ -86,7 +86,7 @@ RELATIVE_KEY_RE = /\btt\b\s*(?:\(\s*)?['":]\s*\./
 # Rewriter(大文字 ⟦CT: 固定)の除去網をすり抜け画面に残る。I18n.t 化では直らない。
 # 正しい修正は method 名を第一引数・表示テキストを第二引数へ分離すること。
 LABEL_FIRST_ARG_RE = /
-  (?: (?<![\w.])\w+\.label\b | \blabel_tag\b | (?<![\w.])label(?![\w]) )
+  (?: (?<![\w.])\w+\.label\b | \blabel_tag\b | (?<![\w.])label(?!\w) )
   \s*\(?\s*
   tt\b (?=\s*[("':@])
 /x
@@ -110,14 +110,14 @@ def scan_file(path, in_app:)
     next unless line =~ TT_CALL
 
     entry = { file: rel, lineno: idx + 1, code: line.rstrip }
-    yield(classify_line(line, entry, in_app: in_app))
+    yield(classify_line(line, entry, in_app:))
   end
 rescue StandardError
   nil
 end
 
 # ヒット 1 行を分類し、[:safe | :suspicious | :other, entry] を返す。
-def classify_line(line, entry, in_app:)
+def classify_line(line, entry, in_app:) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
   # tt の定義（def/alias）は呼び出しではない。t( へ置換すると Rails の t を壊すので絶対に自動変換しない。
   if line.match?(TT_DEFINITION)
     entry[:reason] = 'tt の定義（def/alias）。自動変換禁止。呼び出しを全て t へ移した後に手動で削除する'
@@ -143,15 +143,16 @@ def classify_line(line, entry, in_app:)
 
   entry[:kind] = :string_manipulation
   entry[:relative_key] = line.match?(RELATIVE_KEY_RE)
-  entry[:hint] = if entry[:relative_key]
-                   'I18n.t へ。相対キー(.foo)は絶対キーへ書き換えが必要'
-                 else
-                   'I18n.t(絶対キー) へ置換を検討'
-                 end
+  entry[:hint] =
+    if entry[:relative_key]
+      'I18n.t へ。相対キー(.foo)は絶対キーへ書き換えが必要'
+    else
+      'I18n.t(絶対キー) へ置換を検討'
+    end
   [:suspicious, entry]
 end
 
-buckets = { safe: safe, suspicious: suspicious, other: other }
+buckets = { safe:, suspicious:, other: }
 Dir.glob(ALL_GLOB).each do |path|
   # vendor / node_modules / tmp 等のノイズを除外
   next if relative(path).start_with?('vendor/', 'node_modules/', 'tmp/', '.git/')
@@ -163,7 +164,7 @@ end
 
 if options[:json]
   require 'json'
-  puts JSON.pretty_generate(safe: safe, suspicious: suspicious, other: other)
+  puts JSON.pretty_generate(safe:, suspicious:, other:)
   exit(0)
 end
 
@@ -172,13 +173,14 @@ def print_section(title, entries)
   entries.each do |e|
     # hint があれば必ず kind も付く（classify_line で対で設定）ので素直に出す。
     # suspicious 内のサブ種別(label_arg / string_manipulation)を可視化する。
-    suffix = if e[:hint]
-               "  # [#{e[:kind]}] #{e[:hint]}"
-             elsif e[:reason]
-               "  # #{e[:reason]}"
-             else
-               ''
-             end
+    suffix =
+      if e[:hint]
+        "  # [#{e[:kind]}] #{e[:hint]}"
+      elsif e[:reason]
+        "  # #{e[:reason]}"
+      else
+        ''
+      end
     puts "#{e[:file]}:#{e[:lineno]}: #{e[:code].strip}#{suffix}"
   end
 end