i18n & ローカリゼーション
概要
このパブリック取り込みコピーは、https://github.com/sickn33/antigravity-awesome-skills の plugins/antigravity-awesome-skills-claude/skills/i18n-localization を、Omni Skills のネイティブエディトリアル形式にパッケージ化したものです。その出所を隠蔽することはありません。
オペレーターが上流ワークフロー、サポートファイル、リポジトリコンテキストをそのまま維持しつつ、パブリックバリデーターとプライベートエンハンサーが通常の下流フローを続行できるようにする場合に使用します。
この取り込みコピーは、コピーされた上流ファイルをそのまま保持し、metadata.json の external_source ブロックと ORIGIN.md をレビュー用の証明アンカーとして使用します。
i18n & ローカリゼーション > 国際化(i18n)とローカリゼーション(L10n)のベストプラクティス。 ---
パブリック見出しにきれいにマッピングされなかったインポート元のセクションも、以下またはサポートファイルにそのまま保持されています。注目すべきインポートセクション: 1. コアコンセプト、3. 実装パターン、4. ファイル構造、6. よくある問題、7. RTLサポート、8. チェックリスト。
このスキルを使用すべき場合
このセクションをトリガーフィルターとして使用します。オペレーターがファイルをロードしたり、コマンドを実行したり、プルリクエストを開いたりする前に、アクティベーションの境界を明確にする必要があります。
- プロジェクトタイプ - i18nが必要か?
- パブリックWebアプリ - ✅ はい
- SaaS製品 - ✅ はい
- 内部ツール - ⚠️ 場合による
- 単一リージョンアプリ - ⚠️ 将来的に検討
- 個人プロジェクト - ❌ オプション
操作表
| 状況 | 開始場所 | なぜ重要か |
|---|---|---|
| 初回使用 | metadata.json | コピーされたワークフローに触れる前に、external_source ブロックを通じてリポジトリ、ブランチ、コミット、インポートパスを確認する |
| 証明レビュー | ORIGIN.md | レビュー担当者に、インポート元の平易な監査証跡を提供する |
| ワークフロー実行 | scripts/i18n_checker.py | 実行を実質的に変更する最小のコピーファイルから開始する |
| コンテキストの補足 | scripts/i18n_checker.py | パッケージ全体をロードせずに、次に関連性の高いコピー元ファイルを追加する |
| 引き継ぎ判断 | ## 関連スキル | タスクが範囲から外れた場合に、より強力なネイティブスキルに切り替えるのに役立つ |
ワークフロー
このワークフローは、意図的に編集業務と運用業務の両方を兼ねています。下流のエンハンサーフローに供給するパブリック取り込み基準を満たしながら、オペレーターにとってインポート元を有用なものに保ちます。
- ユーザーの目標、インポートされたワークフローの範囲、およびこのスキルがタスクに適切なルーターであるかどうかを確認する。
- コピーされた上流サポートファイルをロードする前に、概要と証明ファイルを読む。
- 現在のリクエストの結果を実質的に変更する参照、例、プロンプト、またはスクリプトのみをロードする。
- 上流ワークフローを実行し、作業ノートに証明とソースの境界を明示的に保持する。
- 上流の期待値と、コピーファイルで指摘できる証拠に対して結果を検証する。
- 作業がこのインポートされたワークフローの中心範囲から外れた場合は、関連スキルにエスカレーションまたは引き継ぐ。
- マージまたはクローズの前に、使用したもの、変更したもの、レビュー担当者がまだ確認する必要があるものを記録する。
インポートされたワークフローノート
インポート: 1. コアコンセプト
| 用語 | 意味 |
|---|---|
| i18n | 国際化 - アプリを翻訳可能にする |
| L10n | ローカリゼーション - 実際の翻訳 |
| ロケール | 言語 + 地域 (en-US, tr-TR) |
| RTL | 右から左へ記述する言語 (アラビア語、ヘブライ語) |
例
例1: 上流ワークフローを直接依頼する
@i18n-localization を使用して <タスク> を処理してください。コピーされた上流ワークフローから開始し、結果を変更するファイルのみをロードし、回答に証明を可視化したままにしてください。
説明: オペレーターがインポートされたワークフローを必要とするが、リポジトリ全体は必要ない場合の最も安全な開始点です。
例2: 証明に基づいたレビューを依頼する
@i18n-localization を metadata.json と ORIGIN.md に対してレビューし、どのコピーされた上流ファイルを最初にロードするか、その理由を説明してください。
説明: レビューやトラブルシューティングの前に、出所とファイル選択に関する正確で監査可能な説明が必要な場合に使用します。
例3: 実行前にコピーされたサポートファイルを絞り込む
@i18n-localization を <タスク> に使用してください。結果を変更するコピーされた参照、例、またはスクリプトのみをロードし、事前にファイル名を明示してください。
説明: デフォルトでコピーパッケージ全体をロードするのではなく、段階的な開示に沿ってスキルを維持します。
例4: レビュー担当者用パケットを作成する
@i18n-localization を、コピーされた上流ファイルと証明を使用してレビューし、マージ前のギャップをまとめてください。
説明: PR が人間のレビューを待っており、再現可能な監査パケットが必要な場合に役立ちます。
ベストプラクティス
生成されたパブリックスキルは、上流リポジトリのレビュー可能なパッケージングレイヤーとして扱います。目標は、証明を明示的に保ち、実行を実質的に改善するコピー元のソースマテリアルのみをロードすることです。
- 生のテキストではなく翻訳キーを使用する
- 機能ごとに翻訳を名前空間で区切る
- 複数形に対応する
- ロケールごとに日付/数値形式を処理する
- 最初からRTLを計画する
- 複雑な文字列にはICUメッセージ形式を使用する
- コンポーネント内で文字列をハードコードする
インポートされた運用ノート
インポート: 5. ベストプラクティス
✅ 推奨事項
- 生のテキストではなく翻訳キーを使用する
- 機能ごとに翻訳を名前空間で区切る
- 複数形に対応する
- ロケールごとに日付/数値形式を処理する
- 最初からRTLを計画する
- 複雑な文字列にはICUメッセージ形式を使用する
❌ 禁止事項
- コンポーネント内で文字列をハードコードする
- 翻訳済み文字列を連結する
- テキストの長さを想定する(ドイツ語は30%長い)
- RTLレイアウトを忘れる
- 同じファイル内で言語を混在させる
トラブルシューティング
問題: オペレーターがインポートされたコンテキストをスキップし、汎用的に答えすぎた
症状: 結果が plugins/antigravity-awesome-skills-claude/skills/i18n-localization の上流ワークフローを無視し、証明に言及せず、コピーされたソースファイルをまったく使用しない。
解決策: metadata.json、ORIGIN.md、および最も関連性の高いコピーされた上流ファイルを再度開く。最初に external_source ブロックを確認し、続行する前に証明を再表明する。
問題: レビュー中にインポートされたワークフローが不完全に感じられる
症状: レビュー担当者は生成された SKILL.md を見ることができるが、現在のタスクにどの参照、例、またはスクリプトが重要かをすぐに判断できない。
解決策: 自分が取ったパスを正当化する、正確なコピーされた参照、例、スクリプト、またはアセットを指し示す。ギャップが依然として存在する場合は、隠蔽せずにPRに記録する。
問題: タスクが異なる専門分野に逸脱した
症状: インポートされたスキルは正しい場所から始まるが、作業がデバッグ、アーキテクチャ、設計、セキュリティ、またはネイティブスキルの方が適切に処理できるリリースオーケストレーションに変わってしまう。 解決策: 関連スキルセクションを使用して、意図的に引き継ぐ。インポートされた証明を可視化したままにして、次のスキルが空白から開始するのではなく、適切なコンテキストを継承できるようにする。
関連スキル
@00-andruia-consultant- このインポートされたスキルがコンテキストを確立した後に、そのネイティブ専門分野の方が作業に適している場合に使用する。@00-andruia-consultant-v2- このインポートされたスキルがコンテキストを確立した後に、そのネイティブ専門分野の方が作業に適している場合に使用する。@10-andruia-skill-smith- このインポートされたスキルがコンテキストを確立した後に、そのネイティブ専門分野の方が作業に適している場合に使用する。@10-andruia-skill-smith-v2- このインポートされたスキルがコンテキストを確立した後に、そのネイティブ専門分野の方が作業に適している場合に使用する。
追加リソース
以下のサポートマトリクスとリンクされたファイルを、このインポートされたスキルのオペレーターパケットとして使用します。これらは、実際のコピーされたソースマテリアルを反映している必要があり、汎用的な足場であってはなりません。
| リソースファミリ | レビュー担当者への提供内容 | パスの例 |
|---|---|---|
references | 上流からコピーされた参照ノート、ガイド、または背景資料 | references/n/a |
examples | 上流からコピーされた実例または再利用可能なプロンプト | examples/n/a |
scripts | 実行または検証を変更する上流ヘルパースクリプト | scripts/i18n_checker.py |
agents | インポートされたパッケージに実際に含まれるルーティングまたは委任ノート | agents/n/a |
assets | ソースパッケージからコピーされたサポートアセットまたはスキーマ | assets/n/a |
インポートされた参照ノート
インポート: 3. 実装パターン
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
インポート: 4. ファイル構造
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
インポート: 6. よくある問題
| 問題 | 解決策 |
|---|---|
| 翻訳が不足している | デフォルト言語にフォールバックする |
| ハードコードされた文字列 | リンター/チェッカースクリプトを使用する |
| 日付形式 | Intl.DateTimeFormat を使用する |
| 数値形式 | Intl.NumberFormat を使用する |
| 複数形 | ICUメッセージ形式を使用する |
インポート: 7. RTLサポート
/* CSS Logical Properties */
.container {
margin-inline-start: 1rem; /* margin-left ではない */
padding-inline-end: 1rem; /* padding-right ではない */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
インポート: 8. チェックリスト
リリース前:
- すべてのユーザー向け文字列が翻訳キーを使用している
- サポートされているすべての言語のロケールファイルが存在する
- 日付/数値の書式設定にIntl APIを使用している
- RTLレイアウトがテストされている(該当する場合)
- フォールバック言語が設定されている
- コンポーネント内にハードコードされた文字列がない
インポート: スクリプト
| スクリプト | 目的 | コマンド |
|---|---|---|
scripts/i18n_checker.py | ハードコードされた文字列と不足している翻訳を検出する | python scripts/i18n_checker.py <project_path> |
インポート: 制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと。
- 必要な入力、権限、安全境界、または成功基準が欠けている場合は、立ち止まって明確化を求めること。