i18n & Localization(国際化・ローカライゼーション)
概要
このパブリック取り込み用コピーは、https://github.com/sickn33/antigravity-awesome-skills の plugins/antigravity-awesome-skills/skills/i18n-localization を、その出典を隠すことなくネイティブのOmni Skills編集形式にパッケージ化したものです。
オペレーターが上流ワークフロー、サポートファイル、リポジトリコンテキストをそのまま維持しつつ、パブリックバリデーターとプライベートエンハンサーが通常のダウンストリームフローを続ける必要がある場合に使用します。
この取り込みは、コピーした上流ファイルをそのまま維持し、metadata.json の external_source ブロックと ORIGIN.md をレビュー用の出典情報アンカーとして使用します。
i18n & Localization(国際化・ローカライゼーション) > 国際化(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 | ローカライゼーション - 実際の翻訳 |
| Locale | 言語 + 地域(en-US、tr-TR) |
| RTL | 右から左への言語(アラビア語、ヘブライ語) |
例
例1:上流ワークフローを直接依頼する
@i18n-localization-v2 を使用して <task> を処理してください。コピーされた上流ワークフローから開始し、結果に影響を与えるファイルのみをロードし、出典情報を回答に明示してください。
説明: オペレーターがインポートされたワークフローは必要だが、リポジトリ全体は必要ない場合の最も安全な開始方法です。
例2:出典に基づいたレビューを依頼する
@i18n-localization-v2 を metadata.json と ORIGIN.md に照らしてレビューし、最初にどのコピーされた上流ファイルをロードするか、その理由を説明してください。
説明: レビューやトラブルシューティングの前に、正確で監査可能な出典とファイル選択の説明が必要な場合に使用します。
例3:実行前にコピーされたサポートファイルを絞り込む
<task> に @i18n-localization-v2 を使用してください。結果に影響を与えるコピーされた参照、例、またはスクリプトのみをロードし、ファイル名を明示してから実行してください。
説明: デフォルトでコピーパッケージ全体をロードするのではなく、段階的な開示に沿ってスキルを維持します。
例4:レビューパケットを作成する
@i18n-localization-v2 をコピーされた上流ファイルと出典情報を使用してレビューし、マージ前のギャップをまとめてください。
説明: PRが人間のレビューを待っており、再現可能な監査パケットが必要な場合に役立ちます。
ベストプラクティス
生成されたパブリックスキルは、上流リポジトリのレビュー可能なパッケージングレイヤーとして扱います。目標は、出典情報を明確にし、実行に実質的に貢献するコピー元の素材のみをロードすることです。
- 生のテキストではなく翻訳キーを使用する
- 翻訳を機能ごとに名前空間で区切る
- 複数形に対応する
- ロケールごとに日付/数値形式を処理する
- 最初からRTLを計画する
- 複雑な文字列にはICUメッセージ形式を使用する
- コンポーネント内で文字列をハードコードしない
インポートされた運用ノート
インポート:5. ベストプラクティス
推奨事項 ✅
- 生のテキストではなく翻訳キーを使用する
- 翻訳を機能ごとに名前空間で区切る
- 複数形に対応する
- ロケールごとに日付/数値形式を処理する
- 最初からRTLを計画する
- 複雑な文字列にはICUメッセージ形式を使用する
禁止事項 ❌
- コンポーネント内で文字列をハードコードする
- 翻訳済み文字列を連結する
- テキストの長さを想定する(ドイツ語は30%長い)
- RTLレイアウトを忘れる
- 同じファイルに言語を混在させる
トラブルシューティング
問題:オペレーターがインポートコンテキストをスキップし、汎用的すぎる回答を返した
症状: 結果が plugins/antigravity-awesome-skills/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論理プロパティ */
.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> |
インポート:制限事項
- このスキルは、タスクが上記で説明された範囲に明確に一致する場合にのみ使用してください。
- この出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要なインプット、権限、安全境界、成功基準が欠けている場合は、停止して明確化を求めてください。