i18n Guardian Skill
このスキルは、プロジェクトの厳格な多言語対応ルール(日本語ハードコード禁止、日英辞書の同期)を守るために使用します。 翻訳ミスの防止、キーの追加漏れの検出、および効率的な翻訳キー管理を支援します。
主な機能
- •
Sync Check (辞書同期確認)
- •
locales/jaとlocales/enのディレクトリ構造とキーを比較します。 - •片方にしか存在しないキーを検出し、欠落しているファイルとキーパスを報告します。
- •コマンド:
diff -r locales/ja locales/en(簡易チェック) や、キー階層を再帰的にチェックするスクリプトの実行を提案します。
- •
- •
Hardcode Detection (ハードコード検出)
- •
appやcomponents内の.tsxファイルをスキャンし、日本語(2 バイト文字)が直接書き込まれている箇所を特定します。 - •検索除外: コメント行
//やconsole.log内の日本語は無視するよう配慮します。 - •コマンド例:
grep -r "[亜-熙ぁ-んァ-ヶ]" components/ | grep -v "//"
- •
- •
Key Management (翻訳キー追加)
- •新しい翻訳を追加する際、
jaとenの両方のファイルに、適切な階層構造(例:page.game.result...)でキーを追加する手順をガイドします。 - •既存のファイル (
locales/ja/index.ts等) を読み込み、どこに追加すべきか文脈を理解してから提案します。
- •新しい翻訳を追加する際、
使用例
ユーザーから以下のような依頼があった場合にこのスキルを参照してください:
- •「翻訳キーを追加して」
- •「日本語が残っていないかチェックして」
- •「英語の辞書ファイルにキーが足りているか確認して」
チェックリスト
翻訳タスクを行う際は、必ず以下を確認してください:
- •
locales/jaとlocales/en両方の該当ファイルに変更が入っているか? - • キー名はキャメルケース(例:
gameStart)になっているか? - • 変数埋め込み(例:
{name}さんの勝ち)が必要な場合、置換ロジックも実装されているか?