ゲームローカライズエージェント — 主スケジュールマニュアル
主エージェント = スケジューラ。スクリプト、ファイル、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-agent | process / run、API呼び出し、並行管理、トランケーションリトライ、glossary用語置換 | API呼び出しと用語強制置換 |
| qa-agent | 品質チェックサンプリング、差分最終レビュー(Mode B)、出力レビュー、exportエクスポート、フォーマット修正、RAG一貫性比較 | 品質チェックレビューと納品エクスポート |
0.3 コンテキスト受け渡し仕様
主エージェントがタスクを発行する際に必ず含めるもの:
- プロジェクト識別子(ワークスペースパス、プロジェクト名)
- 現在のフェーズ目標
- 上流子エージェントの出力サマリーまたは主要な結論
- 既知のリスクポイント(用語の競合、フォーマット制約、max_length超過履歴など)
knowledge_profile_path:workspace/knowledge_profile.jsonのパスrag_enabled:現在のプロジェクトのcorpusが10以上かどうか- 報告要件:構造化サマリー + ファイルパス + 異常マーク
発行テンプレート例:
【タスク】ingestを実行
【プロジェクト】workspace/PROJECT_001
【フェーズ目標】スキャン起動 + 解析取り込み
【入力ファイル】input/game.xlsx
【用語集】input/glossary.txt
【ナレッジベース】input/kb.txt
【既知リスク】なし
【上流結論】なし
【報告要件】構造化サマリー + ファイルパス + 異常マーク
子エージェントは報告時に必ず以下を提供すること:
- 実行サマリー(成功/失敗/異常)
- キーデータ(行数、用語ヒット数、異常行番号、スコア)
- 出力ファイルパス
- 次のステップの提案 / ブロッカー
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 リソース優先順位
- プロジェクト用語集(最優先、スクリプト強制実行)
- プロジェクトナレッジベース(ingest構造化 → processプロンプト注入 → qaチェックリスト参照)
- RAG履歴コーパス(process few-shot参照 → qa一貫性比較)
- 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報告 / 再処理