Communityライティング&編集github.com

tzwkb/game-loc-translator

エージェントスキル — RAGベースのゲームローカライズ翻訳エンジン(新規翻訳 + MTPE)。

game-loc-translator とは?

このスキルは、ゲームローカライズ向けに設計されたRAGベースの翻訳エンジンです。主エージェントが全体のワークフローを調整し、3つの子エージェント(ingest-agent、process-agent、qa-agent)が各タスク(データ取り込み、翻訳実行、品質保証)を実行します。主エージェントは直接スクリプトやAPIを呼び出さず、すべてのアクションを子エージェントに委任することで、堅牢なエラー処理と段階的な品質管理を実現します。このスキルは、用語の強制適用、RAGによる過去の翻訳の再利用、QAフィードバックに基づく自動リトライをサポートし、大規模なゲームローカライズプロジェクトの効率と一貫性を大幅に向上させます。Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、プロジェクトのワークスペース構造に依存します。

対応~Claude Code~Codex CLI~Cursor
npx skills add tzwkb/game-loc-translator

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

ゲームローカライズエージェント — 主スケジュールマニュアル

主エージェント = スケジューラ。スクリプト、ファイル、APIの直接操作は禁止。すべての実行アクションは子エージェントに委任すること。

アーキテクチャ:主エージェントの決定 → 子エージェントの実行 → 結果の返送 → 主エージェントのレビュー/決定

子エージェントマニュアルのパス:SUB_ingest.md / SUB_process.md / SUB_qa.md


0. アーキテクチャと禁止事項

0.1 主エージェントの禁止事項

  • cli.py や任意のスクリプトを直接実行してはならない
  • プロジェクトの入力ファイル、用語集、ナレッジベースを直接読み取り/書き込みしてはならない
  • 翻訳/最適化のためにLLM APIを直接呼び出してはならない
  • データベースやエクスポートされたxlsxを直接変更してはならない

0.2 子エージェントの役割分担

子エージェント責務排他的権限
ingest-agentスキャン起動、列検出、用語事前チェック、環境チェック、ingest/scout、コーパス運用、ナレッジベース編集データ取り込みとアーカイブ
process-agentprocess / run、API呼び出し、並行管理、トランケーションリトライ、glossary用語置換API呼び出しと用語強制置換
qa-agent品質チェックサンプリング、差分最終レビュー(Mode B)、出力レビュー、exportエクスポート、フォーマット修正、RAG一貫性比較品質チェックレビューと納品エクスポート

0.3 コンテキスト受け渡し仕様

主エージェントがタスクを発行する際に必ず含めるもの:

  1. プロジェクト識別子(ワークスペースパス、プロジェクト名)
  2. 現在のフェーズ目標
  3. 上流子エージェントの出力サマリーまたは主要な結論
  4. 既知のリスクポイント(用語の競合、フォーマット制約、max_length超過履歴など)
  5. knowledge_profile_path:workspace/knowledge_profile.json のパス
  6. rag_enabled:現在のプロジェクトのcorpusが10以上かどうか
  7. 報告要件:構造化サマリー + ファイルパス + 異常マーク

発行テンプレート例:

【タスク】ingestを実行
【プロジェクト】workspace/PROJECT_001
【フェーズ目標】スキャン起動 + 解析取り込み
【入力ファイル】input/game.xlsx
【用語集】input/glossary.txt
【ナレッジベース】input/kb.txt
【既知リスク】なし
【上流結論】なし
【報告要件】構造化サマリー + ファイルパス + 異常マーク

子エージェントは報告時に必ず以下を提供すること:

  1. 実行サマリー(成功/失敗/異常)
  2. キーデータ(行数、用語ヒット数、異常行番号、スコア)
  3. 出力ファイルパス
  4. 次のステップの提案 / ブロッカー

1. 起動

主エージェントのアクション:ingest-agentにスキャン起動を指示。

ingest-agentの報告:履歴パラメータ/空状態、列マッピング、用語問題、環境状態(ベクトル化モデルの状態を含む)、パラメータ素材。

主エージェントの決定:

  • 履歴が存在する → PMに履歴パラメータを報告し、継続か調整かを確認
  • 用語異常 → PMに報告、確認後に続行または修正
  • 複数モデル → PMにオプションを列挙、使用するものを確認
  • モデルなし → PMにダウンロードするか質問;拒否 → rag_enabled=false とマーク
  • PMが「続行」と言う = 確認、Node 1へ

2. スキャン(Node 1)

主エージェントのアクション:ingest-agentに cli.py ingest を指示。

ingest-agentの報告:総行数、用語ヒット数、新しい用語リスト、競合行番号、判定モード(Mode A/B)、スタイルアンカーサンプル、knowledge_profile.json のパス。

主エージェントの決定:

  • scoutを指示(オプション)→ Mode A/Bを確認 → Node 3へ

3. API実行(Node 3)

主エージェントのアクション:process-agentに翻訳/最適化を指示。スタイルアンカー、用語制約、knowledge_profile_path、rag_enabled を発行。

process-agentの報告:成功行数、失敗行番号、トランケーション警告、RAGヒット/再利用統計、API異常サマリー。

主エージェントの決定:

  • 失敗/トランケーション → リトライ、パラメータ調整、またはMANUALとマークするかを決定
  • 成功 → Node 4へ

4. 後処理(Node 4)

4.1 用語強制置換

主エージェントのアクション:process-agentに cli.py glossary を指示。

process-agentの報告:置換統計、残余偏差行番号。

主エージェントの決定:残余偏差 → 再処理に戻すかどうかを決定。

4.2 品質チェック

主エージェントのアクション:qa-agentに品質チェックを指示。

qa-agentの報告:スコア分布(PASS/REWRITE/MANUAL)、異常サンプル、ナレッジベース違反行番号、RAG不一致行番号、推奨アクション。

主エージェントの決定:

  • REWRITE → Node 3に戻し、process-agentにプロンプト調整を指示して再送信(1バッチ最大5回)
  • MANUAL → ブロッカーとしてマーク、PMに報告
  • PASS → 4.3(Mode B)またはNode 5へ

4.3 差分最終レビュー(Mode B)

主エージェントのアクション:qa-agentに最終レビューを指示。

qa-agentの報告:修正リスト、誤判定率統計。

主エージェントの決定:誤判定率 >5% → サンプリング拡大または再処理;それ以外はNode 5へ。


5. 最終校正 + エクスポート(Node 5)

主エージェントのアクション:qa-agentに最終校正、レビュー、エクスポートを指示。

qa-agentの実行:構造化出力レビュー(詳細は SUB_qa.md のレビュー項目一覧を参照)→ cli.py export。

主エージェントの決定(レビュー未合格時の再処理):

  • 用語逸脱 → process-agentに glossary を再実行
  • スタイル/コンテキスト → process-agentに関連バッチを再処理
  • フォーマット/プレースホルダー/長さ → qa-agentが修正後、再エクスポート
  • 再処理後はqa-agentに再レビューを指示

6. 決定クイックリファレンス

トリガー条件決定アクション指示対象
環境チェック失敗 / ベクトル化モデル未キャッシュPMに報告、ブロック—
用語異常PMに報告、確認後に続行—
PMが「続行」と言うパラメータを確認、次のノードへ—
API連続失敗MANUALとマーク—
トランケーション警告max_tokens調整または分割リトライprocess-agent
REWRITE(0.7–0.9)再翻訳に戻す(1バッチ最大5回)process-agent
MANUAL(<0.7)ブロッカーとしてマーク、PMに報告—
用語逸脱glossaryを再実行process-agent
スタイル逸脱関連バッチを再処理process-agent
フォーマット/プレースホルダー/長さ異常スクリプト修正後、再エクスポートqa-agent
誤判定率 >5%サンプリング拡大または再処理qa-agent
レビューすべて合格納品—

7. 運用

コーパス蓄積/相互運用:主エージェントがingest-agentに指示。

ナレッジベース編集:主エージェントが範囲を決定 → ingest-agentに指示。編集前に .bak バックアップを作成、主エージェント確認後、再ingest。

複数ファイル:各ファイルを独立してスケジュール、workspace.dbは統合しない。


8. 付録

8.1 リソース優先順位

  1. プロジェクト用語集(最優先、スクリプト強制実行)
  2. プロジェクトナレッジベース(ingest構造化 → processプロンプト注入 → qaチェックリスト参照)
  3. RAG履歴コーパス(process few-shot参照 → qa一貫性比較)
  4. LLM自由生成(最低、最終手段)

8.2 スケジュールフローチャート

主エージェント
  │
  ├─→ ingest-agent  ←───────────────────────────┐
  │       ├─→ スキャン起動 / 列検出 / 用語事前チェック│
  │       ├─→ cli.py ingest                      │
  │       │   └─→ knowledge_profile.json ──┐     │
  │       ├─→ cli.py scout(オプション)    │     │
  │       └─→ パラメータ/異常を報告         │     │
  │                                         │     │
  ├─→ process-agent ←───────────────────────┘     │
  │       ├─→ ナレッジベース注入プロンプト         │
  │       ├─→ RAG retrieve → few-shot(自動)     │
  │       ├─→ cli.py process / run                │
  │       ├─→ cli.py glossary                     │
  │       └─→ 翻訳結果を報告                      │
  │                                               │
  ├─→ qa-agent ──→ 再処理決定 ────────────────────┘
  │       ├─→ ナレッジベースチェックリスト参照
  │       ├─→ RAG一貫性比較
  │       ├─→ 品質チェックサンプリング / 最終レビュー / レビュー
  │       ├─→ cli.py export
  │       └─→ 品質チェック/エクスポート結果を報告
  │
  └─→ 最終決定:納品 / PM報告 / 再処理

関連スキル