Übergabedokument

Was macht Übergabedokument?

Erstelle ein Übergabedokument, das einem neuen Agenten ermöglicht, diese Arbeit fortzusetzen, ohne die gesamte Konversation erneut lesen zu müssen. Erfasse den Zustand und die Absicht, nicht ein Transkript.

Wo speichern

Speichere das Übergabedokument innerhalb des aktuellen Projekt-Repositorys – niemals im OS-Temp-Verzeichnis, niemals inline im Chat.

1. Ermittle die Repository-Wurzel: Führe git rev-parse --show-toplevel aus. Schlägt dies fehl (kein Git-Repository), verwende das aktuelle Arbeitsverzeichnis als Fallback.
2. Stelle sicher, dass ein Verzeichnis handoffs/ an dieser Wurzel existiert; erstelle es, falls es fehlt.
3. Schreibe in handoffs/<slug>-handoff-<UTC-Zeitstempel>.md, wobei:
   • <slug> ein kurzer, kebab-case-formatierter Begriff ist, der sich aus der Aufgabe (oder aus den übergebenen Argumenten) ableitet, z.B. notebook-proxy-review.
   • <UTC-Zeitstempel> im Format YYYYMMDDTHHMMSSZ angegeben wird, z.B. 20260527T144059Z. Der Zeitstempel stellt sicher, dass jedes Übergabedokument eindeutig ist – überschreibe niemals ein vorhandenes Übergabedokument.
4. Gib nach dem Schreiben den absoluten Pfad der erstellten Datei aus.

Was schreiben

Wenn dieser Skill Argumente übergeben wurden, behandle sie als den Fokus der nächsten Sitzung und richte jeden Abschnitt darauf aus.

Verwende die folgenden Abschnitte. Halte jeden Abschnitt innerhalb seiner maximalen Länge; ein Übergabedokument ist ein Verweisdokument, keine Aufzeichnung von allem. Lasse Abschnitte, die wirklich leer sind, weg, anstatt sie künstlich zu füllen.

• Kopfzeile — Titel, Datum (UTC) und eine Zeile, die beschreibt, wofür die nächste Sitzung gedacht ist. (≤5 Zeilen)
• Zielsetzung — das Ziel und sein Erfolgskriterium. (≤3 Sätze)
• Aktueller Stand — was erledigt ist, was funktioniert, was verifiziert vs. angenommen ist. (≤10 Aufzählungspunkte)
• Nächste Schritte — konkrete, geordnete Aktionen für den nächsten Agenten. (≤8 Aufzählungspunkte)
• Wichtige Entscheidungen & Begründung — festgelegte Entscheidungen und warum, damit der nächste Agent sie nicht erneut diskutiert. (≤8 Aufzählungspunkte)
• Fallstricke / Minenfelder — bereits getroffene Stolpersteine, Überraschungen, Dinge, die erledigt aussehen, aber nicht sind. (≤8 Aufzählungspunkte)
• Relevante Dateien & Verweise — Pfade und URLs zu Code, Lastenheften, Plänen, Diffs, Issues. Verweise darauf; füge ihren Inhalt nicht ein. (≤12 Einträge)
• Offene Fragen — ungelöste Entscheidungen, die den Benutzer oder weitere Arbeit erfordern. (≤6 Aufzählungspunkte)
• Vorgeschlagene Skills — Skills, die der nächste Agent aufrufen sollte, jeweils mit einer einzeiligen Begründung. (≤6 Einträge)

Regeln

• Dupliziere keine bereits in anderen Artefakten (Lastenheften, Plänen, ADRs, Issues, Commits, Diffs) erfassten Informationen. Verweise stattdessen auf deren Pfad oder URL.
• Füge keine großen Dateiinhalte oder vollständigen Befehlausgaben in das Übergabedokument ein. Verweise auf die Quelle.
• Entferne Geheimnisse und personenbezogene Daten (PII) – alles, was mit API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY oder personenbezogenen Daten übereinstimmt. Lokale Dateipfade sind in Ordnung.