docs(skill): internes agentContext-Feld am Ticket (Züchterin-unsichtbar)

Da Subagenten sitzungsgebunden sind, dient ein internes, in der Züchterin-UI
NICHT sichtbares Feld `agentContext` als Arbeitsgedächtnis: der Agent legt dort
Befunde/Ursache/Plan/„worauf gewartet wird"/erledigte Teilschritte ab und setzt
beim Wiederaufgreifen (Answered) genau dort an — statt neu zu untersuchen.
Trennung: agentContext technisch/intern; Frage/Antwort/fixNote bleiben
laienverständlich. PUT {agentContext} aktualisiert ohne Status-Wechsel.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-22 21:14:47 +02:00
parent 8bfa2a7911
commit 9c6ca2118a

View File

@@ -150,6 +150,24 @@ Das Datenmodell unterstützt Mehrrunden über einen **Verlauf/Thread** am Ticket
(mehrere Frage/Antwort-Einträge mit Autor + Zeit), nicht nur ein einzelnes (mehrere Frage/Antwort-Einträge mit Autor + Zeit), nicht nur ein einzelnes
Frage/Antwort-Paar — so geht bei weiteren Antworten nichts verloren. Frage/Antwort-Paar — so geht bei weiteren Antworten nichts verloren.
### Internes Agenten-Kontextfeld (für die Züchterin unsichtbar)
Das Ticket hat ein **internes Kontextfeld** (`agentContext`, NICHT in der Züchterin-
UI sichtbar) — das **Arbeitsgedächtnis** des Agenten. Damit ersetzt das Ticket den
sitzungsgebundenen Subagenten-Kontext:
- **Schreiben:** Bei jeder Bearbeitung legt der Agent dort seinen Arbeitsstand ab
(kompaktes JSON/Markdown): Befunde, vermutete Ursache, geprüfte Hypothesen,
betroffene Dateien/Daten, der Plan, **worauf gewartet wird** (welche Info die
Rückfrage klären soll) und schon erledigte Teilschritte.
- **Lesen:** Beim Wiederaufgreifen eines `Answered`-Tickets liest der Agent zuerst
`agentContext` (+ Verlauf + Triage-Eintrag) und setzt **dort an, wo er aufgehört
hat** — keine Neu-Untersuchung von null.
- **Trennung:** `agentContext` ist intern/technisch (darf IDs/Dateinamen/Hypothesen
enthalten); die **sichtbaren** Felder bleiben laienverständlich (Frage, Antwort,
`fixNote`). `agentContext` wird in der Tickets-Seite NICHT angezeigt.
- `PUT /feedback/{id}` mit `{"agentContext": "<arbeitsstand>"}` aktualisiert es,
ohne den Status zu ändern.
## Verifikation vor „fertig" ## Verifikation vor „fertig"
- Code-Fixes: `npx tsc --noEmit`, `npx vitest run`, betroffene `npx playwright test`, - Code-Fixes: `npx tsc --noEmit`, `npx vitest run`, betroffene `npx playwright test`,
`dotnet build`/`dotnet test`, Python-`test_*.py` — grün. `dotnet build`/`dotnet test`, Python-`test_*.py` — grün.