qt-translation-assistant

Qt 翻訳アシスタントスキル

厳守事項

1. バックアップなしで元の TS ファイルを変更しないでください - 常に元の内容を保持してください
2. AI 翻訳の品質を検証してください - 翻訳が正確で、文脈に適切であることを確認してください
3. 翻訳の一貫性を維持してください - すべての翻訳で用語を統一してください
4. ファイルのエンコーディングを尊重してください - UTF-8 エンコーディングと特殊文字を維持してください
5. 変更は最小限にしてください - 翻訳内容のみを変更し、XML 構造を維持してください

注意すべき兆候

• ユーザーが TS 以外のファイルの翻訳を依頼する
• 適切な AI 設定なしで翻訳するようユーザーが依頼する
• 既存の翻訳を検証せずに上書きするよう依頼される
• サポートされていない言語コードへの翻訳を依頼される

理由と対応の一覧

言い訳	対応
「とにかく全部すぐに翻訳してください」	ローカライズでは品質が重要です。適切な AI 設定と検証が必要です
「用語を統一する必要はありません」	翻訳に一貫性がないとユーザー体験を損ないます。一貫性は不可欠です
「元のファイルをバックアップする必要はありません」	元のファイルは必ず保持してください。翻訳ミスによって内容が破損する可能性があります
「ファイル全体を書き換えてください」	変更するのは翻訳テキストのみです。ほかの変更があると、git diff に表示されます

クイックリファレンス

主なコマンド

# Translate entire directory of TS files
python translate.py /path/to/ts/files/

# Translate specific file
python translate.py /path/to/file.ts

# With custom batch size and workers
python translate.py /path/to/ts/files/ --batch-size 30 --max-workers 3

# Create configuration file
python translate.py --create-config

設定

{
  "api_url": "http://localhost:8080/v1/chat/completions",
  "api_key": "sk-uos-12345",
  "model": "qwen3-coder-flash",
  "temperature": 0.3
}

よくある間違いと修正方法

間違い：AI プロバイダーが正しく設定されていない

修正方法：--create-config を使用して、有効な API 認証情報を含む qt_translation_config.json を作成します

間違い：ファイルが大きく、API がタイムアウトする

修正方法：--batch-size パラメーター（20〜50 を試してください）と --max-workers（2〜5 を試してください）を調整します

間違い：言語コードが正しく検出されない

修正方法：TS ファイルが標準の命名規則（例：project_zh_CN.ts、project_de.ts）に従っていることを確認します

間違い：翻訳品質に問題がある

修正方法：設定ファイルでモデルの選択と温度設定を調整します

間違い：Git diff に不要な変更が多数表示される

修正方法：このツールが変更するのは翻訳内容のみです。それ以外の変更がある場合は、修正が必要なバグを示しています

アーキテクチャ

このスキルは並列処理アーキテクチャを使用します。

• TranslationWorker：自動再試行と指数バックオフを備えた AI API 呼び出しを処理します
• QtTranslationAssistant：並列バッチ処理を行うメインオーケストレーターです
• ThreadPoolExecutor：並行する翻訳ワーカーを管理します（デフォルトは 3）

サブエージェントアーキテクチャと比べたパフォーマンスの向上点：

• サブプロセスのオーバーヘッドなしに API を直接呼び出します（約 5〜10 倍高速）
• バッチサイズが大きくなっています（以前の 10 に対してデフォルトは 30）
• ワーカーを並列実行します（逐次実行ではなく API 呼び出しを 3 件同時に実行）
• エラーを分離します（1 つのバッチの失敗がほかのバッチに影響しません）

主な機能

• TS ファイルをスマートに解析し、未完了の翻訳を特定します
• ThreadPoolExecutor による並列バッチ処理
• 複数の AI プロバイダーに対応します（OpenAI、Anthropic、DeepSeek、ローカルサーバー）
• バッチサイズとワーカー数を設定可能です
• 指数バックオフを使用して自動的に再試行します
• Git diff に適した変更を行います（翻訳内容のみを変更）