conn-castle/agent-outbox

ship-pr

Das Aufrufen dieses Skills autorisiert das Erstellen von Branches, das Staging, Commits, Pushes, das Erstellen oder Aktualisieren von PRs sowie qualifizierte Kommentarantworten, die zur Vorbereitung eines PRs auf den Merge erforderlich sind. Es autorisiert nicht den Merge selbst.

Falls references/repo-specific-pr-policy.md existiert, lesen Sie es vor Beginn des Workflows und behandeln Sie es als maßgeblich.

Eingaben

Erfordert ein pr_worker-Dispatch-Ziel und verwenden Sie für jedes Dispatch /dispatch-agent. Leiten Sie alle zusätzlichen Caller-Inputs in jedem pr_worker-Prompt weiter.

Sofern der Benutzer den Umfang nicht einschränkt, schließen Sie den gesamten aktuellen Arbeitsbaum ein.

Workflow

1. Erstellen Sie einen Branch, wenn die Repository-Normen einen erfordern. Comitten Sie die beabsichtigten Änderungen, pushen Sie und erstellen oder verwenden Sie den PR. Leiten Sie den Titel aus den Änderungen ab und füllen Sie assets/pr-body-template.md, entfernen Sie nicht verwendete Abschnitte und Platzhalter.

2. Starten Sie einen Watcher in einer verwalteten Hintergrundsitzung. Lassen Sie ihn laufen, bis der PR gemerged wird oder der Workflow stoppt, dann stoppen Sie ihn. Falls er nach einem vorübergehenden Transportfehler beendet wird, holen Sie den maßgeblichen Zustand erneut und starten Sie ihn mit demselben append-only Log neu.

   bash <skill_dir>/scripts/watch-pr-events.sh \
     --repo <owner/name> \
     --pr <pr-number> \
     --log-file .agent-layer/tmp/ship-pr-events-<pr-number>.jsonl \
     --interval-seconds 300
   

3. Rufen Sie den aktuellen Head, Checks und Mergeability mit gh ab. Lesen Sie Kommentare mit diesem zustandslosen Befehl; leiten Sie niemals den aktuellen Zustand aus dem Watcher-Log ab:

   bash <skill_dir>/scripts/read-pr-comments.sh \
     --repo <owner/name> \
     --pr <pr-number>
   

   Dispatchen Sie pr_worker für ungelöstes Feedback mit dem genauen PR, Head und references/address-pr-comments.md; für einen fehlgeschlagenen erforderlichen Check geben Sie auch dessen Nachweise und references/fix-ci.md an. Der Worker bearbeitet den lokalen Baum, führt aber keine Commits, Pushes oder Antworten aus. Lösen Sie mechanische Konflikte automatisch.

   Der PR ist nur dann bereit zum Mergen, wenn:

   • Der PR mergeable an seinem neuesten Head ist.
   • Mindestens ein Agent oder menschlicher Reviewer hat Feedback als formales Review oder Kommentar hinterlassen.
   • Jeder erforderliche Check und jedes Repository-Gate sind grün.
   • Jeder qualifizierte Kommentar hat eine validierte Antwort.
   • Falls die optionale Repository-Richtlinie existiert, wird jedes darin definierte Merge-Kriterium erfüllt.

   Falls innerhalb von 10 Minuten nach PR-Erstellung kein Agent oder menschlicher Reviewer Feedback hinterlässt, stoppen und melden, dass kein Feedback eingegangen ist. Falls bereit, fahren Sie mit Schritt 5 fort. Andernfalls adressieren Sie die gesamte umsetzbare Runde, bevor Sie committen.

4. Committen und pushen Sie akzeptierte Korrekturen. Posten Sie jede unterstützte, vom Worker vorgeschlagene Antwort einzeln: Antworten Sie nativ auf Inline-Kommentare; für Konversationskommentare oder Review-Zusammenfassungen posten Sie einen Issue-Kommentar, der auf die Quelle verlinkt. Führen Sie den Kommentarbefehl erneut aus und korrigieren Sie fehlende oder nicht unterstützte Antworten. Kehren Sie zu Schritt 3 zurück, bis bereit. Wenn nur Checks oder Reviews ausstehen, warten Sie auf den Watcher.

5. Fordern Sie eine einmalige Merge-Autorisierung für den genauen PR und Head an. Melden Sie alle wesentlichen Erkenntnisse, eine präzise Zusammenfassung der Kommentardisposition und Nachweise der Bereitschaft.

6. Nach der Autorisierung rufen Sie Head, Checks, Mergeability und Kommentare erneut ab. Bestätigen Sie, dass der lokale Baum vollständig ist und jeder qualifizierte Kommentar eine unterstützte, gepostete Antwort hat. Falls sich etwas geändert hat, kehren Sie zu Schritt 3 zurück und holen Sie eine neue Autorisierung für den resultierenden PR-Head ein; andernfalls mergen.

7. Bestätigen Sie, dass der Checkout sauber ist, wechseln Sie zum Standard-Branch, führen Sie einen Fast-Forward durch und löschen Sie Branches oder Worktrees, die von diesem Workflow erstellt wurden. Bewahren Sie den Zustand und melden Sie alle Bereinigungen, die unsicher durchzuführen sind.