Spiel-Lokalisierungs-Agent – Hauptsteuerungshandbuch
Haupt-Agent = Steuerung. Direkte Bedienung von Skripten, Dateien, APIs ist verboten. Alle Ausführungsaktionen müssen an Unter-Agenten delegiert werden.
Architektur: Haupt-Agent Entscheidung → Unter-Agent Ausführung → Ergebnisrückmeldung → Haupt-Agent Prüfung/Entscheidung
Pfade zu den Unter-Agenten-Handbüchern: SUB_ingest.md / SUB_process.md / SUB_qa.md
0. Architektur und Verbote
0.1 Verbote für den Haupt-Agenten
- Darf
cli.pyoder ein beliebiges Skript nicht direkt ausführen - Darf Projekteingabedateien, Glossare oder Wissensdatenbanken nicht direkt lesen/schreiben
- Darf die LLM-API nicht direkt für Übersetzung/Optimierung aufrufen
- Darf die Datenbank oder exportierte xlsx-Dateien nicht direkt ändern
0.2 Aufgabenverteilung der Unter-Agenten
| Unter-Agent | Verantwortung | Exklusive Berechtigungen |
|---|---|---|
| ingest-agent | Startscan, Spaltenerkennung, Glossar-Vorprüfung, Umgebungscheck, ingest/scout, Korpusbetrieb, Wissensdatenbank-Editierung | Datenerfassung und -archivierung |
| process-agent | process / run, API-Aufrufe, Parallelitätsmanagement, Trunkierung und Wiederholungen, glossary-Glossar-Ersetzung | API-Aufrufe und erzwungene Glossar-Ersetzung |
| qa-agent | Qualitätskontrolle, stichprobenartige Prüfung, Differenz-Endprüfung (Modus B), Ausgabeprüfung, Export, Formatkorrektur, RAG-Konsistenzvergleich | Qualitätskontrolle und Lieferung/Export |
0.3 Kontextweitergabe-Spezifikation
Vom Haupt-Agenten bei Aufgabenverteilung müssen mitgeliefert werden:
- Projektkennung (Workspace-Pfad, Projektname)
- Aktuelles Phasenziel
- Zusammenfassung oder Schlussfolgerungen des vorgelagerten Unter-Agenten
- Bekannte Risikopunkte (Glossarkonflikte, Formateinschränkungen, Verlauf von max_length-Überschreitungen usw.)
knowledge_profile_path: Pfad zuworkspace/knowledge_profile.jsonrag_enabled: Ob das aktuelle Projekts-Korpus >= 10 ist- Rückmeldeanforderung: Strukturierte Zusammenfassung + Dateipfad + Ausnahmekennzeichnung
Beispiel für eine Aufgabenverteilung:
【Aufgabe】Ingest ausführen
【Projekt】workspace/PROJECT_001
【Phasenziel】Startscan + Parsen und Einlesen
【Eingabedatei】input/game.xlsx
【Glossar】input/glossary.txt
【Wissensdatenbank】input/kb.txt
【Bekannte Risiken】Keine
【Vorgelagerte Schlussfolgerung】Keine
【Rückmeldeanforderung】Strukturierte Zusammenfassung + Dateipfad + Ausnahmekennzeichnung
Vom Unter-Agenten bei Rückmeldung müssen bereitgestellt werden:
- Ausführungszusammenfassung (Erfolg/Fehler/Ausnahme)
- Schlüsseldaten (Zeilenanzahl, Glossar-Treffer, Ausnahmezeilennummern, Bewertung)
- Pfad zur Ausgabedatei
- Nächste Schritte / Blockaden
1. Start
Haupt-Agent Aktion: Beauftragt den ingest-agent mit der Durchführung des Startscans.
ingest-agent Rückmeldung: Historische Parameter/Leerzustand, Spaltenzuordnung, Glossar-Probleme, Umgebungsstatus (inkl. Vektorisierungsmodell-Status), Parameter-Material.
Haupt-Agent Entscheidung:
- Historie vorhanden → PM die historischen Parameter melden, Bestätigung für Fortführung oder Anpassung einholen
- Glossar-Anomalie → PM melden, nach Bestätigung fortfahren oder korrigieren
- Mehrere Modelle → PM Optionen auflisten, Bestätigung einholen, welches verwendet werden soll
- Kein Modell → PM fragen, ob Download gewünscht; Ablehnung →
rag_enabled=falsesetzen - PM sagt "Weiter" = Bestätigung, Übergang zu Node 1
2. Scan (Node 1)
Haupt-Agent Aktion: Beauftragt den ingest-agent mit der Ausführung von cli.py ingest.
ingest-agent Rückmeldung: Gesamtzeilenanzahl, Glossar-Treffer, Liste neuer Begriffe, Konfliktzeilennummern, Bestimmungsmodus (Mode A/B), Stilanker-Beispiele, Pfad zu knowledge_profile.json.
Haupt-Agent Entscheidung:
- Scout beauftragen (optional) → Mode A/B bestätigen → Übergang zu Node 3
3. API-Ausführung (Node 3)
Haupt-Agent Aktion: Beauftragt den process-agent mit der Übersetzung/Optimierung. Übergibt Stilanker, Glossar-Einschränkungen, knowledge_profile_path, rag_enabled.
process-agent Rückmeldung: Erfolgreiche Zeilenanzahl, fehlgeschlagene Zeilennummern, Trunkierungswarnung, RAG-Treffer/Wiederverwendungsstatistiken, API-Ausnahme-Zusammenfassung.
Haupt-Agent Entscheidung:
- Fehler/Trunkierung → Entscheidung über Wiederholung, Parameteranpassung oder Kennzeichnung als MANUAL
- Erfolg → Übergang zu Node 4
4. Nachbearbeitung (Node 4)
4.1 Erzwungene Glossar-Ersetzung
Haupt-Agent Aktion: Beauftragt den process-agent mit der Ausführung von cli.py glossary.
process-agent Rückmeldung: Ersetzungsstatistiken, verbleibende Abweichungszeilennummern.
Haupt-Agent Entscheidung: Verbleibende Abweichungen → Entscheidung, ob Rückfluss zur erneuten Bearbeitung.
4.2 Qualitätskontrolle
Haupt-Agent Aktion: Beauftragt den qa-agent mit der Durchführung der Qualitätskontrolle.
qa-agent Rückmeldung: Bewertungsverteilung (PASS/REWRITE/MANUAL), Ausnahmebeispiele, Zeilennummern mit Wissensdatenbank-Verstößen, Zeilennummern mit RAG-Inkonsistenzen, empfohlene Aktionen.
Haupt-Agent Entscheidung:
- REWRITE → Rückfluss zu Node 3, process-agent beauftragen, Prompt anzupassen und erneut zu senden (max. 5 Wiederholungen pro Charge)
- MANUAL → Blockade kennzeichnen, PM melden
- PASS → Übergang zu 4.3 (Mode B) oder Node 5
4.3 Differenz-Endprüfung (Mode B)
Haupt-Agent Aktion: Beauftragt den qa-agent mit der Durchführung der Endprüfung.
qa-agent Rückmeldung: Korrekturliste, Fehlentscheidungsrate.
Haupt-Agent Entscheidung: Fehlentscheidungsrate >5% → Stichprobenumfang erweitern oder Rückfluss; sonst Übergang zu Node 5.
5. Endkontrolle + Export (Node 5)
Haupt-Agent Aktion: Beauftragt den qa-agent mit Endkontrolle, Prüfung und Export.
qa-agent Ausführung: Strukturierte Ausgabeprüfung (Details siehe SUB_qa.md Prüfpunktliste) → cli.py export.
Haupt-Agent Entscheidung (Rückfluss bei nicht bestandener Prüfung):
- Glossar-Abweichung → process-agent erneutes
glossary - Stil/Kontext → process-agent relevante Chargen erneut process
- Format/Platzhalter/Länge → qa-agent reparieren und dann erneut export
- Nach Rückfluss muss qa-agent erneut mit der Prüfung beauftragt werden
6. Entscheidungs-Schnellübersicht
| Auslösebedingung | Entscheidungsaktion | Beauftragtes Objekt |
|---|---|---|
| Umgebungscheck fehlgeschlagen / Vektorisierungsmodell nicht gecached | PM melden, blockieren | — |
| Glossar-Anomalie | PM melden, nach Bestätigung fortfahren | — |
| PM sagt "Weiter" | Parameter bestätigen, zum nächsten Knoten übergehen | — |
| API wiederholt fehlgeschlagen | Als MANUAL kennzeichnen | — |
| Trunkierungswarnung | max_tokens anpassen oder Zeilen aufteilen und wiederholen | process-agent |
| REWRITE (0.7–0.9) | Rückfluss zur Neuübersetzung (max. 5 Wiederholungen pro Charge) | process-agent |
| MANUAL (<0.7) | Als Blockade kennzeichnen, PM melden | — |
| Glossar-Abweichung | Erneutes glossary | process-agent |
| Stil-Abweichung | Relevante Chargen erneut process | process-agent |
| Format/Platzhalter/Längen-Anomalie | Skript-Reparatur und dann re-export | qa-agent |
| Fehlentscheidungsrate >5% | Stichprobenumfang erweitern oder Rückfluss | qa-agent |
| Prüfung vollständig bestanden | Lieferung | — |
7. Betrieb
Korpus-Ablagerung/Austausch: Haupt-Agent beauftragt ingest-agent.
Wissensdatenbank-Editierung: Haupt-Agent entscheidet über Umfang → beauftragt ingest-agent. Vor der Bearbeitung .bak-Backup erstellen, Haupt-Agent bestätigt, dann erneutes ingest.
Mehrere Dateien: Jede Datei unabhängig steuern, keine Zusammenführung in workspace.db.
8. Anhang
8.1 Ressourcenpriorität
- Projekt-Glossar (höchste Priorität, skriptgesteuert erzwungen)
- Projekt-Wissensdatenbank (ingest strukturiert → process Prompt-Injektion → qa Checklisten-Abgleich)
- RAG-Historie-Korpus (process Few-Shot-Referenz → qa Konsistenzvergleich)
- LLM freie Generierung (niedrigste Priorität, Notlösung)
8.2 Steuerungsablaufdiagramm
Haupt-Agent
│
├─→ ingest-agent ←───────────────────────────┐
│ ├─→ Startscan / Spaltenerkennung / Glossar-Vorprüfung │
│ ├─→ cli.py ingest │
│ │ └─→ knowledge_profile.json ──┐ │
│ ├─→ cli.py scout (optional) │ │
│ └─→ Rückmeldung Parameter / Ausnahmen │
│ │ │
├─→ process-agent ←───────────────────────┘ │
│ ├─→ Wissensdatenbank in Prompt injizieren │
│ ├─→ RAG retrieve → few-shot (automatisch) │
│ ├─→ cli.py process / run │
│ ├─→ cli.py glossary │
│ └─→ Rückmeldung Übersetzungsergebnisse │
│ │
├─→ qa-agent ──→ Rückfluss-Entscheidung ────────┘
│ ├─→ Wissensdatenbank-Checkliste abgleichen │
│ ├─→ RAG-Konsistenzvergleich │
│ ├─→ Qualitätskontrolle / Endprüfung / Review │
│ ├─→ cli.py export │
│ └─→ Rückmeldung Qualitätskontrolle / Export │
│
└─→ Endentscheidung: Lieferung / PM melden / Rückfluss