Communitygithub.com

Devolutions/UniGetUI

UniGetUIの英語言語ファイルをソースコードの使用状況と同期し、不足している翻訳キーを特定し、未使用のエントリを削除し、ローカライゼーションのずれを報告し、ロケールファイルを英語のキー順序に並べ替えます。ユーザーが言語ファイルの同期、翻訳不足、i18nのずれ、またはロケールファイルの英語の順序への整合を依頼したときに使用します。

UniGetUI とは?

このスキルはUniGetUIプロジェクトのローカライゼーションワークフローを効率化する、AIエージェント向けの専門ツールです。主な機能として、英語のベース言語ファイル(en.xaml)をソースコード全体の翻訳キー使用状況と照合し、不足している翻訳キーを特定、未使用のキーを削除、既存翻訳のずれを報告します。さらに、任意のロケールファイルを英語のキー順序に再配置できます。開発者は手動で翻訳の完全性を追跡する必要がなくなり、特に複数の言語を管理するチームに有用です。主にUniGetUIプロジェクト向けに設計されていますが、類似したXAMLベースのローカライゼーション構造を持つ他のプロジェクトにも応用可能です。このスキールは`typos`や`xmllint`などの外部ツールに依存し、安全なファイル操作のためにGitの変更を確認します。

対応~Claude Code~Codex CLI~Cursor
npx skills add Devolutions/UniGetUI

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

UniGetUI は何をしますか?

UniGetUIの英語言語ファイルをソースコードの使用状況と同期し、不足している翻訳キーを特定し、未使用のエントリを削除し、ローカライゼーションのずれを報告し、ロケールファイルを英語のキー順序に並べ替えます。ユーザーが言語ファイルの同期、翻訳不足、i18nのずれ、またはロケールファイルの英語の順序への整合を依頼したときに使用します。

概要

このスキルは、UniGetUIプロジェクトのローカライゼーションファイル(XAML形式)を管理・同期するための自動化ツールです。以下の操作を実行できます:

  • 不足キーの検出:ソースコードで使用されているが翻訳ファイルに存在しないキーを特定します。
  • 未使用キーの削除:翻訳ファイルに存在するが、ソースコードで参照されていないキーを特定します。
  • ローカライゼーションのずれの報告:翻訳ファイル内の値が元の英語キーと構造的に異なる場合に報告します。
  • キー順序の同期:任意のロケールファイルを英語(デフォルト)ファイルのキー順序に合わせて並べ替えます。

プラットフォーム

  • UniGetUI:このツールはUniGetUIプロジェクト専用に設計されています。

使用方法

前提条件

  • typos コマンド(スペルチェック用)
  • xmllint コマンド(XMLの整形用)
  • Gitリポジトリ(変更管理用)

コマンド

スキルは以下のコマンドを提供します:

  • sync_locale:英語の言語ファイルをソースコードのキー使用状況と同期します。
  • check_missing_keys:不足している翻訳キーを報告します。
  • remove_unused_keys:未使用の翻訳キーを削除します。
  • report_drift:ローカライゼーションのずれを報告します。
  • reorder_locale:ロケールファイルを英語のキー順序に並べ替えます。

例

# 英語の言語ファイルを同期
sync_locale --lang en

# 不足しているキーを報告
check_missing_keys --lang fr

# 未使用のキーを削除
remove_unused_keys --lang de

# ずれを報告
report_drift --lang ja

# ロケールファイルを並べ替え
reorder_locale --lang es

設定

このスキルは、以下の環境変数または設定ファイルで設定可能です:

  • UNIGETUI_LOCALE_PATH:ロケールファイルへのパス(デフォルト:./src/UniGetUI/Locales)
  • UNIGETUI_SOURCE_PATH:ソースコードへのパス(デフォルト:./src)
  • UNIGETUI_DEFAULT_LANG:デフォルトの言語コード(デフォルト:en)

注意事項

  • このスキルは常にGitの変更を確認し、ファイルを変更する前に安全な操作を保証します。
  • 翻訳ファイルはXAML形式である必要があります。
  • ソースコードはC#(.cs)およびXAML(.xaml)ファイル内の翻訳キーをスキャンします。

関連リソース

関連スキル