GitHub-Workflow
Wählen Sie die angeforderte Operation aus und folgen Sie deren Aufgabenreferenz. Jede Operation arbeitet mit einem normalen Issue oder PR ohne vorherige ghflow-Aufgaben. Laden Sie nur die jetzt benötigte Aufgabe und die gemeinsamen Regeln. Wenden Sie Arbeitskontext und Tool-Ausgabe für Referenzladungen, Suchen und Übergaben an.
Bevor Sie entscheiden, wie die Operation ausgeführt wird, wenden Sie Ausführungsmodus an. Lokale Modellarbeit bleibt in der aktuellen Sitzung ohne Unteragenten. Dieser Modus überschreibt Aufgabenanweisungen, die Worker entsenden oder neue Überprüfungssitzungen starten.
Quelle und Werkzeuge lokalisieren
Lösen Sie diesen SKILL.md-Pfad durch einen symbolischen Link auf. Sein übergeordnetes Verzeichnis ist GHFLOW_SKILL_DIR. Verwenden Sie absolute Pfade unterhalb dieses Verzeichnisses für Referenzen und Unteragentenübergaben. Setzen Sie GHFLOW_CLI auf den absoluten Pfad von cli/ghflow.py darunter, bevor Sie Befehlsbeispiele ausführen. Setzen Sie den Pfad in Anführungszeichen. Ein Befehlswerkzeug kann für jeden Aufruf eine neue Shell starten, exportieren Sie die Variable daher in jedem Befehl, der sie verwendet, oder schreiben Sie den vollständigen Pfad:
export GHFLOW_CLI="ABSOLUTER_SKILL_VERZEICHNIS/cli/ghflow.py"
python3 "$GHFLOW_CLI" --help
Ersetzen Sie ABSOLUTER_SKILL_VERZEICHNIS durch das aufgelöste Verzeichnis. Das aufgelöste Fähigkeitenverzeichnis ist das Quell-Checkout-Root. Verwenden Sie dessen cli/ghflow.py direkt. Behalten Sie das aktuelle Verzeichnis im Zielprojekt bei, damit Git-, GitHub- und Identitätskonfiguration dieses Projekt verwenden. Lösen Sie die Schreibanleitung über die Links jeder Referenz auf, nicht über das aktuelle Verzeichnis. Wenn Quell-Lesevorgänge externe Verzeichnisberechtigungen benötigen, melden Sie den aufgelösten Checkout-Pfad und verwenden Sie die Einrichtungsanweisungen in Quellzugriffsberechtigungen. Ändern Sie nicht stillschweigend Agentenberechtigungen.
Die ausgewählte Aufgabenreferenz benennt die gemeinsamen Regeln, die sie benötigt. Öffnen Sie eine gemeinsame Referenz, wenn ihre Bedingung zutrifft, und lesen Sie den Abschnitt, der die Entscheidung trifft; lesen Sie nicht jede gemeinsame Referenz vor der ersten Aktion. Die Bedingungen: Autorisierung bei einer Frage zu Berechtigung oder Umfang; Evidenz bevor Sie ein Ergebnis melden oder eine Kennung weitergeben; Entscheidungen bei fehlender Tatsache oder Wahl; Agentenidentität bevor ein Agent Git- oder GitHub-Befehle ausführt; GitHub-Schreibvorgänge vor dem Ändern von GitHub-Einträgen. CLI-Lesevorgänge gewähren keine Schreibberechtigung.
Die angeforderte Operation auswählen
Stimmen Sie die explizite Benutzeranfrage mit der folgenden Operation ab. Identifizieren Sie das Betreff-Repository aus der Benutzeranfrage oder dem Ziel-Checkout. python3 "$GHFLOW_CLI" facts meldet Checkout, Repository, Tooling, Identitätsbereitschaft und die Projektfaktendatei; mit --issue ISSUE_URL fügt es die Branches, Worktrees, PRs und Board-Elemente des Issues hinzu. Verwenden Sie es anstelle separater git- und gh-Lesevorgänge für diesen Zustand und lesen Sie .ghflow/project.md, wenn es eines meldet. Für einen Start einer lokalen Modellsitzung gibt preamble ISSUE_URL diese Fakten als kompakten Block aus, der in die erste Eingabeaufforderung passt. Das Quell-Checkout liefert Anweisungen und Werkzeuge; sein Remote und das konfigurierte Konto identifizieren nicht das Betreff. Wenn das ausgewählte Repository, Issue oder der PR fehlt, geben Sie die erforderliche Eingabe zurück, bevor GitHub-Suchen oder Dispatch durchgeführt werden. Für eine reine Bewertungsanfrage erklären Sie die Operation und ihre Grenzen, ohne eine Auslieferung durchzuführen. Wenn ein wesentlicher Endpunkt unklar ist, fragen Sie nur nach dieser Entscheidung. Wählen Sie keine Backlog-Arbeit aus oder fügen Sie eine festgelegte Reihenfolge hinzu. Eine Auslieferungsanfrage standardmäßig auf Überprüfungs-Nachverfolgung mit offenem PR. Lesen Sie seine Koordinator-Referenz und wenden Sie den ausgewählten Ausführungsmodus auf Dispatch- und Überprüfungsanforderungen an.
| Anfrage | Aufgabenreferenz |
|---|---|
| Ein bestehendes Issue neu bewerten | reconsider-issue |
| Eine Idee oder ein Issue definieren, einschließlich Entwurfsarbeit | define-issue |
| Issue-Entscheidungen mit dem Benutzer klären | interview-issue |
| Ein breites übergeordnetes Thema in Kinder aufteilen | decompose-parent-issue |
| Einen überprüften Issue-Entwurf veröffentlichen | file-issue |
| Ein Issue durch lokale Commits implementieren | implement-issue |
| Codeänderungen unabhängig überprüfen | review-changes |
| Committierte Änderungen als PR veröffentlichen | submit-pr |
| PR-Feedback beantworten und CI reparieren | address-pr-review |
| Einen explizit autorisierten PR mergen | merge-pr |
| Ein ausgewähltes Issue ausliefern oder bearbeiten | express-issue |
| Ein vereinbartes übergeordnetes Issue ausliefern | deliver-parent-issue |
| Verwandte Issues unter Themen gruppieren | bundle-issues |
| Eine angeforderte Menge offener Issues bewerten | triage-issues |
| Issues klären, die Eingaben benötigen | sweep-needs-input |
| Akzeptierte Issues definieren | sweep-needs-definition |
| Nicht blockierte Issues zur Definition zurückgeben | sweep-blocked |
| Geschlossene Issues prüfen | sweep-audit-closed |
| Einen angeforderten Board-Bereich priorisieren | sweep-prioritize |
| Issues in die Ready-Warteschlange einordnen | curate-ready-queue |
| Eine explizit angeforderte Ready-Warteschlange abarbeiten | burndown-ready-queue |
| Die Projektfaktendatei schreiben oder aktualisieren | prepare-project-facts |
Ausführen und Übergeben
Für längerfristige Arbeit oder Erkenntnisse, deren Wiederherstellung aufwändig wäre, wenden Sie Aufgabennotizen an. Bei Wiederaufnahme oder nach Kontextkomprimierung lesen Sie die vorhandenen Notizen der Aufgabe, bevor Sie Recherchen wiederholen oder Entscheidungen wieder aufgreifen.
Folgen Sie dem Umfang und Haltepunkt der ausgewählten Referenz. Tragen Sie bestehende Autorisierung über eingeschlossene Aufgaben hinweg. Entwurfs- und Nur-Lesen-Beschränkungen gelten weiterhin; Implementierung oder Einreichung impliziert nie Merge-Berechtigung.
Im delegierten Modus wenden Sie Koordination an. Geben Sie dem Unteragenten die ausgewählte Operation und erforderlichen Eingaben. Wenn die Delegation oder das erforderliche Überprüfungsmodell nicht verfügbar ist, folgen Sie den gemeinsamen Regeln und melden Sie die Einschränkung.
Geben Sie das tatsächliche Ergebnis, Quellen, Prüfungen und verbleibende Entscheidungen der Operation zurück. Melden Sie fehlende Fähigkeiten und unvollständige Evidenz explizit.