mcpField
F
flutter-localization

flutter-localization

github.com/thienqo開発1796 回インストール1 日前に更新
リポジトリ

flutter-localization について

Flutter の開発で、既存のローカライズ手順に沿ってユーザー向けテキストを管理するスキルです。メッセージ設計、ロケール別の書式、RTL 対応、多言語での検証を扱います。

主な機能

  1. 01既存のローカライズ設定の確認
  2. 02ICU の複数形とプレースホルダー
  3. 03アクティブなロケールに応じた書式
  4. 04RTL レイアウトとフォールバック対応
  5. 05生成テキストと画面レイアウトの検証

活用シーン

  1. 01多言語 UI テキストの追加
  2. 02日付や数値のロケール別表示の確認
  3. 03RTL と長文レイアウトのテスト

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-localization

インストール後、Claude Code で/flutter-localizationを入力して読み込まれたか確認します。

同梱ファイルreferences/icu-messages-and-formatting.md

詳細

Flutter のローカライズ

ユーザー向けテキストはプロジェクトのローカライズパイプラインで管理し、断片を連結するのではなく、意味をモデル化してください。

調査

pubspec.yaml、l10n.yaml、既存の ARB ファイル、生成されたローカライズへのアクセス方法、サポート対象ロケール、フォーマット用パッケージを確認してください。移行を依頼されていない限り、既存のローカライズツールを維持してください。

ルール

  • 説明的で安定したメッセージキーを使用し、翻訳者に文脈が必要なプレースホルダーには説明を付けてください。
  • 翻訳文をコード内で組み立てるのではなく、ICU の複数形、選択、プレースホルダーの機能を使用してください。
  • 日付、時刻、数値、通貨、単位をアクティブなロケールに合わせてフォーマットしてください。
  • エラー、セマンティクスラベル、空の状態を含め、ユーザー向け文字列をハードコードしないでください。
  • RTL には方向対応 API と start/end 配置を使用してください。意味上必要なアセットのみ反転してください。
  • フォールバックと未対応ロケールの方針を明確に定めてください。
  • 国から言語を推測したり、ユーザーが選択していないロケールの上書きを永続化したりしないでください。

検証

ローカライズを生成して解析し、RTL ロケール、長い文字列、複数形、リソースの欠落、ロケールに応じたフォーマットなど、代表的な条件をテストしてください。ローカライズとレイアウトの不具合は同時に発生することが多いため、大きな文字サイズで主要な画面を実行してください。

メッセージのフォーマットまたはローカライズが対象となる場合は、ICU メッセージとフォーマットのリファレンスに従ってください。

参考資料

コメント