Communitygithub.com

dubbl-a/house-rules

Gibt einen Snapshot der aktuellen Session aus (SHA, Tree-Zustand, ausgelieferte PRs, wichtigste Erkenntnis, nächste Schritte), erstellt nur für die nächste Arbeitsrunde Issues und protokolliert per Entscheidung Verschobenes dort, wo die Entscheidung lebt. Nutzen Sie es für „Wrap Up“ oder „Übergabe“.

Was ist house-rules?

Diese Skill (für Claude Code, Cursor, Codex o.Ä.) erzeugt bei explizitem Aufruf einen strukturierten Übergabe-Snapshot einer abgeschlossenen KI-Agenten-Session. Der Snapshot enthält: den genauen Commit-Hash des Default-Branches, den aktuellen Tree-Zustand (sauber/verschmutzt, Anzahl Worktrees), die seit dem letzten Release-Tag ausgelieferten PRs, die wichtigste Erkenntnis der Session sowie eine geordnete Liste der nächsten Arbeitsschritte. Für jeden nächsten Schritt wird – nach Prüfung auf bereits existierende Issues – ein neues GitHub-Issue erstellt. Per Entscheidung bewusst zurückgestellte Aufgaben werden nicht als Issue abgelegt, sondern dort dokumentiert, wo die Entscheidung bereits festgehalten ist (z. B. CHANGELOG, Entscheidungsdokument oder Code-Kommentar). Die Skill öffnet niemals eigenständig Issues; sie läuft nur auf Anforderung. Sie unterstützt GitHub CLI (`gh`) und erfordert Authentifizierung. Bei Fehlen des CLI oder bei leeren Abschnitten gibt sie dennoch alle Informationen aus.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/plugins/house/skills/handoff

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Handoff (Übergabe)

Handoff gibt einen Snapshot aus: die festgelegte Zusammenfassung, die die nächste Session zuerst liest. Es erstellt keine Datei für den Snapshot selbst, weil dieser aus dem Default-Branch, Merged-PRs und den Release-Notes jederzeit neu abgeleitet werden kann – ein ständig gleichlautendes Issue wäre Rauschen. Ein Issue wird nur für Arbeit geöffnet, die jemand erledigen wird: Jeder Punkt der nächsten Arbeitsrunde wird zu einem Issue, nachdem er mit offenen Issues abgeglichen wurde. Alles, was per Entscheidung verschoben wurde, wird mit seiner Begründung dort festgehalten, wo die Entscheidung bereits lebt – denn diese Begründung ist das Einzige, was die nächste Session nicht selbst rekonstruieren kann.

Der Harness setzt die vollständige History einer Session bereits mit --continue oder --resume fort und behält maschinenlokalen automatischen Speicher. Daher enthält der Snapshot nur das, was diese nicht können: nächste Schritte und Entscheidungen, die eine andere Maschine oder Person im Repo oder in dessen Issues finden muss. Gate-Ergebnisse und Zähltabellen sind bewusst nicht enthalten: Beide laufen in Sekunden gegen den aufgezeichneten SHA neu, und eine Neulaufzahl kann nicht so gefälscht werden wie eine kopierte.

Diese Skill kann Issues öffnen und schließen, daher feuert sie nie von selbst. Führen Sie sie nur auf Anfrage aus und nur dann, wenn eine Session tatsächlich endet.

Standardpfad

  1. Tree-Zustand erfassen: SHA, Sauberkeit, Worktrees, offene PRs.
  2. Auflisten, was seit dem letzten Release-Tag (oder seit Sitzungsbeginn, falls es keinen Tag gibt) ausgeliefert wurde.
  3. Eine wichtigste Erkenntnis nennen, mit Beleg.
  4. Die Liste der nächsten Arbeitsschritte schreiben: geordnet, konkret, jeder Punkt mit seiner Begründung.
  5. Für jeden nächsten Schritt offene Issues prüfen, die ihn bereits abdecken; nur wenn keines existiert, ein neues Issue öffnen und dessen Nummer notieren.
  6. Für alles, was per Entscheidung verschoben wurde, die Begründung dort festhalten, wo die Entscheidung bereits lebt (CHANGELOG, Entscheidungsdokument, Code-Kommentar an der Stelle); nur wenn kein solcher Ort existiert, ein als „nicht geplant“ geschlossenes Issue anlegen. Tun Sie dies niemals für etwas, das einfach nicht gemacht wurde – das bleibt ein Punkt der nächsten Arbeitsrunde oder fällt still weg.
  7. Legacy-Bereinigung: Wenn ein offenes Issue mit dem Titel „Session carryover“ existiert, schließen Sie es mit einem Kommentar, der auf die Issues verweist, in die sein Inhalt aufgeteilt wurde.
  8. Snapshot in der Antwort ausgeben: den Veraltungs-Hinweis, Tree-Zustand, Ausgeliefertes, wichtigste Erkenntnis, Liste der nächsten Schritte mit Issue-Nummern und die per Entscheidung verschobenen Punkte mit Angabe, wo sie festgehalten sind.

Tree-Zustand erfassen

Führen Sie diese Befehle gegen den Default-Branch des Repos aus, nicht gegen den Branch, in dem sich die Session gerade befindet:

git rev-parse HEAD
git status --short
git worktree list
gh pr list --state open

Notieren Sie den exakten SHA, ob der Tree sauber ist, wie viele Worktrees existieren und wie viele PRs offen sind. Ein vages „die Dinge sind in einem guten Zustand“ ist kein Tree-Zustand; der SHA ist die Tatsache, die der nächsten Session erlaubt zu bestätigen, dass sich nichts unter ihr bewegt hat, und er ist das, wogegen jedes Gate und jeder Zähler neu läuft – weshalb keines dieser Ergebnisse irgendwo abgelegt wird.

Ausgeliefertes auflisten

Vom letzten Release-Tag (oder, falls es keinen gibt, vom Beginn der Session) bis zum aktuellen HEAD jeden PR auflisten, der gemergt wurde, pro Zeile: Nummer und was er getan hat. Falls nichts gemergt wurde, schreiben Sie „Keine“ unter diese Überschrift. Lassen Sie die Überschrift nicht weg, weil die Liste leer ist; ein fehlender Abschnitt liest sich als „niemand hat nachgesehen“, nicht als „nichts ausgeliefert“.

Die wichtigste Erkenntnis nennen

Eine Erkenntnis, formuliert als Entscheidung mit dem dazugehörigen Beleg – keine Zusammenfassung von allem, was passiert ist. Wenn in dieser Session nichts diese Messlatte erreicht hat, schreiben Sie „Keine wichtigste Erkenntnis in dieser Session“, anstatt eine nebensächliche Beobachtung aufzublähen.

Die Liste der nächsten Arbeitsschritte schreiben und jeden Punkt in ein Issue umwandeln

Eine geordnete Liste konkreter nächster Aktionen, jede mit der einzeiligen Begründung, die sie motiviert. „Hier beginnen“ bedeutet, dass der erste Punkt wirklich der ist, mit dem die nächste Session beginnen sollte – nicht nur der erste, der einem einfällt.

Für jeden Punkt offene Issues durchsuchen, bevor Sie ein neues öffnen:

gh issue list --search "<Zusammenfassung des Punkts>" --state open

Wenn ein offenes Issue ihn bereits abdeckt, dessen Nummer verwenden. Andernfalls eines öffnen:

gh issue create --title "<Punkt>" --body "<die einzeilige Begründung>"

Ein Issue existiert für Arbeit, die jemand erledigen wird; ein Punkt der nächsten Arbeitsrunde, der nie zu einem wird, ist eine Liste in Prosa, der die nächste Session vertrauen muss, statt einem Tracker, auf den sie sich stützen kann.

Per Entscheidung Verschobenes dort festhalten, wo die Entscheidung lebt

Etwas, das diese Session bewusst nicht getan hat, ist nicht dasselbe wie etwas, das einfach nicht in diese Session gepasst hat. Nur die erste Art wird festgehalten, mit ihrer Begründung, an dem Ort, an dem die Entscheidung bereits lebt: dem CHANGELOG-Eintrag, der darum herum ausgeliefert wurde, einem Entscheidungsdokument oder dem Code-Kommentar an der Stelle. Verweisen Sie im Snapshot auf diesen Ort. Nur wenn kein solcher Ort existiert, legen Sie es als geschlossenes Issue an:

gh issue create --title "<Punkt>" --body "Per Entscheidung verschoben: <die Begründung>"
gh issue close <N> --reason "nicht geplant"

Die Begründung ist die eine Zeile, die die nächste Session nicht selbst rekonstruieren kann; ein einfach nicht erledigtes Ding braucht keinen Eintrag, denn es ist entweder immer noch ein Punkt der nächsten Arbeitsrunde oder es war nie eine Verpflichtung.

Legacy: Ein offenes Carryover-Issue stilllegen

Falls ein Issue mit dem Titel „Session carryover“ noch offen ist (aus der Zeit vor dieser Praxis), schließen Sie es, statt es für immer offen zu lassen:

gh issue list --search "Session carryover" --state open
gh issue close <N> --comment "Zurückgezogen: aufgeteilt in <Issue-Nummern aus diesem Handoff>."

Diesen Schritt überspringen, sobald kein solches Issue mehr existiert.

Snapshot ausgeben

Beginnen Sie mit dem Veraltungs-Hinweis, sinngemäß: „Überprüfen Sie alles hier, bevor Sie sich darauf verlassen – dies ist ein Snapshot, und das Repo bewegt sich.“ Dann der Reihe nach: Tree-Zustand, ausgelieferte PRs, wichtigste Erkenntnis, Liste der nächsten Schritte mit Issue-Nummern jedes Punkts, per Entscheidung verschobene Punkte mit Angabe, wo sie festgehalten sind. Geben Sie dies in der Antwort aus; es wird nie abgelegt.

Notausgänge

  • Kein gh CLI oder nicht authentifiziert. Den Snapshot trotzdem ausgeben, ebenso die Liste der nächsten Schritte und der per Entscheidung verschobenen Punkte; sagen, dass kein Issue geöffnet werden konnte, und die Person bitten, sie von Hand anzulegen.
  • Nichts ausgeliefert, keine wichtigste Erkenntnis, keine nächsten Arbeitsschritte oder nichts per Entscheidung verschoben. Sagen Sie das klar in dem entsprechenden Abschnitt, statt ihn wegzulassen oder aufzublähen.

Nicht tun

  • Führen Sie dies nicht von selbst aus. Es kann Issues öffnen und schließen und feuert nur auf Anfrage.
  • Kopieren Sie kein Gate-Ergebnis oder eine Zähltabelle in den Snapshot; sie werden gegen den aufgezeichneten SHA neu gestartet, und ein Leser vertraut dem Neulauf, nicht der Kopie.
  • Öffnen Sie kein Issue für einen nächsten Arbeitsschritt, ohne zu prüfen, ob es bereits eines gibt, das ihn abdeckt.
  • Öffnen Sie kein Issue für etwas, das einfach nicht gemacht wurde – das ist nicht dasselbe wie „per Entscheidung verschoben“.
  • Lassen Sie den Veraltungs-Hinweis nicht weg, weil sich die Session aktuell anfühlt; der nächste Leser hat keine Möglichkeit, das ohne diesen Hinweis zu wissen.
  • Blähen Sie keine fehlende wichtigste Erkenntnis oder eine leere Auslieferungsliste auf, um den Snapshot substanzieller wirken zu lassen, als die Session war.
  • Lassen Sie kein „Session carryover“-Issue offen, nachdem dieser Handoff gelaufen ist.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Verwandte Skills