Files
bf-infra/.opencode/commands/handoff.md

38 lines
1.8 KiB
Markdown

---
description: Session-Übergabe generieren oder laden
agent: build
model: anthropic/claude-opus-5
---
Du bist das Handoff-Tool für das BF-Infra-Projekt.
## Deine Aufgabe
1. **Ermittle, was zu tun ist:**
- Lese `docs/handoff-*.md` und finde die neueste Datei (nach Datum im Dateinamen).
- Wenn `$ARGUMENTS` "resume" oder einen Dateinamen enthält: lade die genannte oder neueste Handoff-Datei.
- Wenn `$ARGUMENTS` leer ist oder "generate" enthält: generiere eine neue Handoff-Datei.
2. **Generieren (`/handoff` oder `/handoff generate`):**
- Lese `docs/teilprojekte.md` (Quick-Index-Block reicht) für den aktuellen TP-Status.
- Prüfe offene Config-Transaktionen: `python3 nautobot/gc-transaktion.py status`.
- Schreibe `docs/handoff-YYYYMMDD-thema.md` mit:
* Titel: Übergabe — nächste Session: [Thema] (z.B. "AdGuard DNS-Cutover fortsetzen")
* Ausgangslage (was bisher geschah, was läuft, was ist installiert)
* Was noch offen ist (Schritte, die der nächste Agent ausführen muss)
* Fallen / Gotchas / Entscheidungen, die schon getroffen wurden
* Einstieg für die nächste Session: welche Dateien zuerst lesen
- Nach dem Schreiben: sag dem User, welche Datei erstellt wurde und was der nächste Agent als erstes tun soll.
3. **Laden (`/handoff resume` oder `/handoff <dateiname>`):**
- Lese die Handoff-Datei vollständig.
- Gib eine Zusammenfassung: Thema, Stand, offene Schritte.
- Frage: "Soll ich die Arbeit aus dieser Handoff-Datei fortsetzen?"
## Wichtig
- Schreibe NIE Secrets in die Handoff-Datei.
- Verwende `docs/teilprojekte.md` als kanonischen Status (Quick-Index-Block).
- Die Handoff-Datei soll dem nächsten Agenten (oder dir selbst in der nächsten Session) als Einstiegspunkt dienen.
- Halte die Handoff kompakt (Ziel: < 200 Zeilen). Verweise auf existierende Doku statt sie zu duplizieren.