Projektübergabe

Was macht Projektübergabe?

Erstelle eine aktuelle Momentaufnahme, die es einem neuen Agenten ermöglicht, die Arbeit ohne das Gespräch fortzusetzen. Lösche das Gespräch nicht selbst.

1. Ziel ermitteln

Bestimme das Übergabeziel, bevor du schreibst:

1. Bevorzuge ein explizites Verzeichnis, das mit dem Aufruf übergeben wurde. Normalisiere es und überprüfe, ob es existiert.
2. Andernfalls leite Kandidaten aus Verzeichnissen und Dateien ab, die in dieser Sitzung tatsächlich besprochen, gelesen, erstellt oder bearbeitet wurden.
3. Behandle das aktuelle Arbeitsverzeichnis, das Codex-Workspace-Root, das Versionskontroll-Root und Projekt-Marker wie README.md, AGENTS.md, package.json oder pyproject.toml nur als Hinweise. Keiner davon ist für sich genommen maßgeblich, und ein Projekt muss Git nicht verwenden.
4. Fahre nur dann ohne Nachfrage fort, wenn ein Kandidat eindeutig durch die Sitzungsnachweise gestützt wird.
5. Wenn das Ziel fehlt oder mehrdeutig ist, zeige die wahrscheinlichen Kandidaten an und stelle eine präzise Frage: HANDOFF.md 要写到哪个目录？ Rate nicht.

Wenn mehrere unabhängige Projekte geändert wurden, bevorzuge eine separate HANDOFF.md für jedes und bestätige deren Ziele, bevor du schreibst.

2. Tatsächlichen Zustand überprüfen

Nachdem du jedes Zielverzeichnis aufgelöst hast:

• Überprüfe die relevante Sitzungsarbeit und inspiziere die Struktur des Ziels, Anweisungen, wichtige Dokumentation, Implementierungsdateien und Ausgaben.
• Wenn eine Versionskontrolle existiert, überprüfe deren Status und relevante Änderungen. Wenn nicht, fahre fort, ohne dies als Fehler zu behandeln.
• Nutze vorhandene Test- oder Validierungsnachweise. Führe nur leichte, sichere Prüfungen durch, wenn sie nützlich sind; installiere keine Abhängigkeiten oder nimm keine nicht zusammenhängenden Projektänderungen vor.
• Lies eine vorhandene HANDOFF.md vor dem Aktualisieren. Behalte weiterhin gültige Informationen bei, ersetze veralteten Status und verschiebe neu abgeschlossene Arbeiten aus dem Abschnitt „Verbleibende Arbeit“.

Verlasse dich nicht nur auf das Gesprächsgedächtnis, wenn Dateisystem-Nachweise verfügbar sind.

3. HANDOFF.md schreiben

Erstelle oder aktualisiere <bestätigtes-Ziel>/HANDOFF.md als präzises aktuelles Zustandsdokument mit diesen Abschnitten:

# Projektübergabe

> Aktualisiert: YYYY-MM-DD
> Ziel: /absoluter/bestätigter/pfad

## Aktueller Zustand und Struktur

## Abgeschlossene Fälle

## Entscheidungen und Konventionen

## Verbleibende Arbeit und genauer nächster Schritt

## Fallstricke und Sackgassen

## Validierung, Risiken und offene Fragen

Wende diese Regeln an:

• Gib abgeschlossenen Fällen konkrete Ergebnisse und projektrelative Datei- oder Verzeichnispfade.
• Dokumentiere Entscheidungen, technische Wahlmöglichkeiten, Stil- oder Namenskonventionen und deren Gründe. Füge bei Bedarf Hinweise auf Nachweise bei.
• Mache verbleibende Arbeit umsetzbar: Priorität, genaue Startdatei oder Befehl, Hindernisse und die Bedingung für den Abschluss.
• Notiere fehlgeschlagene Ansätze und warum sie fehlgeschlagen sind, damit der nächste Agent sie nicht wiederholt.
• Gib ausgeführte Tests oder Prüfungen und deren Ergebnisse an. Sage explizit, was nicht verifiziert wurde.
• Unterscheide beobachtete Fakten von Sitzungsbehauptungen und Schlussfolgerungen. Kennzeichne Unsicherheit als 待確認; erfinde niemals Abschlüsse, Entscheidungen oder Testergebnisse.
• Verwende absolute Daten, präzise Prosa und Pfade anstelle einer gesprächsartigen Erzählung.
• Gib niemals Anmeldeinformationen, Token, private persönliche Informationen, Umgebungsdateiinhalte oder große Rohprotokolle ein.
• Behalte die Datei als die neueste Übergabemomentaufnahme bei, nicht als Append-Only-Verlauf.

Ändere nur die beabsichtigte HANDOFF.md, es sei denn, der Benutzer fordert explizit andere Änderungen an.

4. Überprüfen und melden

Lies die fertige Datei erneut und bestätige, dass:

• sie sich im bestätigten Verzeichnis befindet;
• jeder erforderliche Abschnitt vorhanden ist;
• die nächste Aktion spezifisch genug ist, damit ein neuer Agent sofort beginnen kann;
• Behauptungen, Pfade, Daten und Validierungsstatus mit den verfügbaren Nachweisen übereinstimmen;
• keine sensiblen Informationen in das Dokument kopiert wurden.

Melde den geschriebenen Pfad, eine kurze Zusammenfassung und alle ungelösten Unsicherheiten. Höre dann auf, damit der Benutzer die Übergabe überprüfen kann, bevor er manuell /clear ausführt.