Wissenserfassung (Knowledge Capture)
Automatische Verwendung
Erstelle oder aktualisiere vor der finalen Antwort für jede Repository-Aufgabe genau eine aktive session-Erfassung für den aktuellen Workflow, wenn sich Dateien geändert haben, Tests ausgeführt wurden oder eine Entscheidung/Entdeckung/Weiterverfolgung getroffen wurde. Tue dies nach der Verifikation und vor dem Abfragen von Aufräumarbeiten oder Freigaben.
Erstelle keine neue Erfassung, nur weil die Fähigkeit erneut aufgerufen wird. Wenn ein aktiver Erfassungspfad für diesen Workflow bekannt ist, aktualisiere diese Datei. Andernfalls lies .ai/raw/active-session.json als Kandidaten für einen aktiven Zeiger. Wenn keine zuverlässige aktive Erfassung existiert oder sich der Workflow eindeutig geändert hat, erstelle eine neue rohe Erfassung und ersetze den Zeiger.
Erfasse ausreichende Details zur aktuellen Aufgabe für die spätere Verwendung. Lese bzw. aktualisiere nur die aktive Erfassung des aktuellen Workflows. Lese, aktualisiere, dedupliziere, führe nicht zusammen, synchronisiere, committe, veröffentliche oder verschiebe keine unzusammenhängenden Erfassungen in v0.2.
Eine Erfassung ist nicht allein dadurch vollständig, dass der Helfer eine Datei geschrieben hat. Lasse Nicht erfasst. nicht in Abschnitten stehen, deren Fakten bekannt sind, insbesondere bei Benutzeranfrage, Änderungen und Belege, Entscheidungen und Entdeckungen sowie Offene Fragen und nächste Schritte.
Wenn du eine aktive Erfassung aktualisierst, schreibe die gesamte Erfassung so, wie sie nach dem aktuellen Workflow-Schritt aussehen soll. Füge keine Delta-Notiz an. Nutze den aktuellen Aufgabenkontext, sichtbare Dateien, Diffs, Tests, Befehlsergebnisse und Übergabetexte als Belege. Wenn die Kontinuität unklar ist, erstelle eine neue Erfassung, anstatt fehlenden Kontext zu erfinden.
Halte die Erfassung an der aktuellen Realität ausgerichtet, nicht an jedem Zwischengedanken. Wenn sich eine frühere Entscheidung geändert hat und sich die Arbeit damit geändert hat, erfasse die endgültige/aktuelle Entscheidung und den Beleg. Behalte die überholte Entscheidung nur, wenn sie implementierten Code, einen Rollback, ein ungelöstes Risiko oder eine offene Frage erklärt; lasse rein theoretische, verworfene Optionen weg.
Speichere Erfassungen als .ai/raw/<Typ-Ordner>/YYYY-MM-DDTHH-mm-ssZ--<Typ>--<Thema-Slug>.md. Wenn der genaue Dateiname bereits existiert, hänge vor .md --2, --3 usw. an.
Typen: session -> sessions, discussion -> discussions, investigation -> investigations, decision -> decisions, handoff -> handoffs.
Für session-Erfassungen pflege .ai/raw/active-session.json als lokalen Zeiger auf die aktive Workflow-Erfassung. Lösche ihn nicht nach jeder finalen Antwort; er unterstützt Wiederaufnahme, Kompaktierung und Übergabe. Ersetze ihn, wenn ein neuer Workflow-Capture startet.
Erfassung (Capture)
Behandle /capture als Erstellen/Aktualisieren der aktuellen Session-Erfassung. Behandle /capture <type> als diesen Erfassungstyp, wenn <type> session, discussion, investigation, decision oder handoff ist.
Führe vor Kontextkompression, Kompaktierung oder Übergabe zuerst eine Erfassung durch, wenn sinnvolle Arbeit oder Entscheidungen noch nicht erfasst wurden.
Wenn Node verfügbar ist, kann der ablauffreie Helfer die erste Erfassung erstellen, die bekannte aktive Erfassung mit --update <path> ersetzen oder die anvisierte Erfassung mit --update-active ersetzen. Übergabe umfangreicher, abschnittsweiser Details über --stdin oder schreibe Markdown direkt. Der Helfer blockiert standardmäßig reine Titel-/Zusammenfassungs-Erfassungen, da sie nützliches Session-Wissen verlieren.
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "Auth Refresh Token Fix" --summary "Verhalten des abgelaufenen Refresh Tokens behoben" --stdin
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "Auth Refresh Token Fix" --update .ai/raw/sessions/2026-07-04T18-22-10Z--session--auth-refresh-token-fix.md --stdin
node .agents/skills/knowledge-capture/scripts/capture.js --type session --title "Auth Refresh Token Fix" --update-active --stdin
Gib Markdown-Überschriften aus references/raw-capture-schema.md über stdin ein. Wenn Node oder Shell-Ausführung nicht verfügbar ist, erstelle oder aktualisiere das Markdown direkt.
Verwende diese Reihenfolge für aktive Session-Erfassungen:
- Wenn der aktive Pfad im aktuellen Kontext bekannt ist, aktualisiere diesen Pfad.
- Andernfalls lies
.ai/raw/active-session.jsonals Kandidaten-Zeiger. - Wenn sowohl der Zeiger als auch die Laufzeit ein
agent_session_idoffenlegen und diese übereinstimmen, aktualisiere ihn. - Wenn die Session-ID abweicht, fehlt oder nicht verfügbar ist, aber die Benutzeranfrage oder Übergabe eindeutig denselben Workflow fortsetzt, aktualisiere ihn und aktualisiere den Zeiger.
- Andernfalls erstelle eine neue Erfassung und ersetze den Zeiger. Wähle niemals durch Raten des neuesten Dateinamens.
Leitplanken
- Erfasse nützliche rohe Details, vermeide aber Transkripte, große Logs und ganze Dateien.
- Füge geänderte Dateien, Tests, Befehle und Belege unter
Änderungen und Belegeein; gruppiere Dateien nach Zweck, wenn mehrere Dateien geändert wurden. - Füge nur seltene, nicht offensichtliche oder entscheidungsrelevante Befehle/Ergebnisse ein; lasse Routinebefehle weg, die später keine Rolle spielen.
- Reorganisiere eine aktive Erfassung nur, um sie genau und nützlich zu machen. Erfinde keine Fakten und behalte keine veraltete Theorie stillschweigend bei, als wäre sie noch wahr.
- Behandle
agent_session_idals nützliche Leitplanke, nicht als Definition eines Workflows. Eine neue Agentensession kann denselben Workflow fortsetzen. - Verwende
--agent-session-idnur, wenn die Laufzeit eindeutig eine stabile aktuelle Session, Unterhaltung, Thread oder Run-ID offenlegt. Wenn nicht verfügbar, lasse es weg. Erfinde niemals eine. - Schließe Geheimnisse, Anmeldedaten, API-Schlüssel, private Schlüssel, private Kundendaten und nicht zusammenhängende persönliche Erinnerungen aus.
- Wenn sensible Inhalte vorhanden sind, erstelle keine Erfassung; fasse zunächst abstrakt zusammen.
- Der rohe/lokale Zustand stammt vom
.ai/raw/-Pfad und der Skill-Policy, nicht von workflow-spezifischen Feldern pro Erfassung. - Behandle den Node-Helfer als optional. Direkte Dateierstellung ist weiterhin zulässig.
Nach dem Speichern melde den Pfad, den Typ und ob die Erfassung erstellt oder aktualisiert wurde. Wenn der Helfer die Erfassung blockiert, melde die Warnung und speichere den rohen Inhalt nicht.
Referenzen
- Lese
references/raw-capture-schema.mdnur, wenn du manuell schreibst oder das Schema änderst. - Lese
references/active-session-example.md, wenn du unsicher bist, wie eine aktualisierte Workflow-Erfassung aussehen sollte. - Lese
references/agent-portability.mdnur, wenn du diese Fähigkeit an einen anderen Agenten anpasst.