From 9c6ca2118a3c38f2be33fd9cb75fc9f765cef2b2 Mon Sep 17 00:00:00 2001 From: Gulum Date: Mon, 22 Jun 2026 21:14:47 +0200 Subject: [PATCH] =?UTF-8?q?docs(skill):=20internes=20agentContext-Feld=20a?= =?UTF-8?q?m=20Ticket=20(Z=C3=BCchterin-unsichtbar)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .claude/skills/ticket-triage/SKILL.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/.claude/skills/ticket-triage/SKILL.md b/.claude/skills/ticket-triage/SKILL.md index ec7b6c5..2591b38 100644 --- a/.claude/skills/ticket-triage/SKILL.md +++ b/.claude/skills/ticket-triage/SKILL.md @@ -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 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": ""}` aktualisiert es, + ohne den Status zu ändern. + ## Verifikation vor „fertig" - Code-Fixes: `npx tsc --noEmit`, `npx vitest run`, betroffene `npx playwright test`, `dotnet build`/`dotnet test`, Python-`test_*.py` — grün.