GitHub Projekt Triage
Verwende diese Fähigkeit immer, wenn der Benutzer triage eingibt, es sei denn, die Anfrage zielt ausdrücklich auf einen Nicht-GitHub-Bereich ab. Von innerhalb eines Repos aus verwende standardmäßig das aktuelle GitHub-Projekt. Triage bedeutet maintainer-orientierte Item-Karten: URL, worum es bei jedem Issue/PR geht, warum es wichtig ist, Autorenvertrauen, Passung, Risiko, Nachweis/Teststatus, Blocker und nächste Aktion. Gib niemals nur Warteschlangennummern oder undurchsichtige Referenzen zurück.
Die Ausgabe ist URL-zentriert: Jedes aufgelistete Issue/PR/Repo-Element muss seine GitHub-URL in der ersten Zeile oder im ersten Satz für dieses Element enthalten. Wenn eine Kurzliste erstellt wird, drucke eine URL pro Element.
Verwende RepoBar nur als ersten Durchlauf für eine breite Warteschlangenentdeckung über relevante Besitzer/Organisationen hinweg. RepoBar ist schneller und profilbewusster als selbst gh repo list-Schleifen zu bauen, und es versteht bereits Repo-Aktivität, Issue-Zahlen, PR-Zahlen, lokale Projekte, Authentifizierung, Cache und Filter.
Einrichtung
Bevorzuge ein echtes repobar-Binary, wenn es installiert ist. In diesem Arbeitsbereich existiert es möglicherweise nur als SwiftPM-Produkt in ~/Projects/RepoBar.
repobar_cmd() {
if command -v repobar >/dev/null 2>&1; then
repobar "$@"
elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
"$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
else
swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
fi
}
repobar_cmd status --json
Standardbesitzer für breites Triage: steipete, openclaw. Für breites/Standard-Warteschlangentriage, schließe einen Detaildurchlauf für openclaw/openclaw ein, auch wenn es nicht das erste Repo nach Anzahl ist, weil es die Hauptwarteschlange von ClawdBot/OpenClaw ist. Füge keine amantus-ai oder andere Besitzer hinzu, es sei denn, der Benutzer nennt sie, das aktuelle Repo ist bereits unter diesem Besitzer, oder die Aufgabe fordert explizit alles/jedes. Führe bei einer genauen besitzerspezifischen Aufgabe keine Verbreiterung über den genannten Besitzer hinaus durch.
Lokales Repo-Gate
Bevor du mit der Arbeit in einem lokalen Projekt beginnst, überprüfe, ob der Checkout bereit ist:
git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch
Fahre nur fort, wenn der Branch main ist, der Pull erfolgreich ist und der Arbeitsbaum sauber ist. Wenn der Branch nicht main ist, der Pull fehlschlägt oder git status --short Änderungen anzeigt, stoppe und frage Peter, was zu tun ist. Wechsle keine Branches, stashe nichts, committe nichts, setze nichts zurück, stelle nichts wieder her oder bereinige nichts ohne explizite Anweisung.
Bereichsregel
Wenn der Benutzer triage sagt und das aktuelle Arbeitsverzeichnis ein Git-Repo mit einem GitHub-Remote ist, triage nur dieses Projekt. Verbreitere nicht auf alle Peter/Org-Warteschlangen, es sei denn, der Benutzer sagt broad, all, everything, nennt mehrere Besitzer/Organisationen oder fragt nach Repo-übergreifendem Triage.
Wenn das Repo eine VISION.md hat, lies sie, bevor du beurteilst, was autonom erledigt werden kann. Verwende sie als die maßgebliche Quelle für die Produktpassung, dann wende die Risiko-/Testbarkeitsregeln dieser Fähigkeit an. Wenn keine VISION.md existiert, verwende die unten stehenden Regeln für autonome Passung.
Finde das aktuelle Projekt:
repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
url=$(git remote get-url origin 2>/dev/null || true)
repo=$(printf '%s\n' "$url" |
sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\.git$##')
fi
printf '%s\n' "$repo"
Das Triage des aktuellen Projekts beginnt mit:
gh issue list --repo "$repo" --state open --limit 50 \
--json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
--json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url
Bevor du auf ein Issue oder PR reagierst, lies alle Kommentare und behandle die Kommentare von Peter/Besitzer als maßgebliche Routing-Anweisungen. Wenn Peter sagt, es sieht gut aus, Änderungen benötigt werden, es ersetzt wurde, produktfreigegeben ist oder nicht gewünscht wird, überschreibt dies Bot-Labels und das übliche Triage-Urteil. Wenn es keinen Kommentar von Peter/Besitzer gibt, verwende das Maintainer-Urteil und sage, dass die Entscheidung bei dir liegt.
Dann inspiziere genügend Details, um jedes aufgelistete Element zu erklären. Für kleine Warteschlangen (etwa 10 offene Elemente oder weniger), inspiziere alle Elemente. Für größere Warteschlangen, inspiziere den obersten Prioritätsausschnitt und sage, was nicht erweitert wurde.
gh issue view <n> --repo "$repo" \
--json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
--json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch
Kommentiere, schließe, merge, führe neu aus oder patche nur mit starken Beweisen.
Triage-Ausgabe
Wenn der Benutzer triage sagt, scanne immer offene Issues und offene PRs für das aktuelle Repo. Gib zurück:
Autonome Kandidaten: Elemente, die ohne weitere Produktvorgaben reparierbar/landbar erscheinen, mit URL, warum sie qualifiziert sind, erforderliche Verifizierung und Konfidenz. Dies ist eine Auswahl zur Überprüfung, keine Erlaubnis, mit der Arbeit zu beginnen, es sei denn, der Benutzer bittet auch um autonome Ausführung.Benötigt Peter: Elemente, die durch Peters/Besitzer-Entscheidung, Produktrichtung, fehlende Anmeldeinformationen/Zugriff, Live-Provider-Nachweise, die nicht beschafft werden können, Sicherheits-/Datenschutzurteil oder einen maßgeblichen Peter-Kommentar, der Änderungen anfordert, blockiert sind.Verschieben/schließen/ersetzen: Veraltete, duplizierte, minderwertige oder überlappende Elemente, bei denen die wahrscheinliche Aktion kein neuer Code ist.
Überprüfe für jeden plausiblen autonomen Kandidaten mit verfügbaren High-Reasoning-Subagenten, Oracle oder unabhängiger Agentenüberprüfung die Machbarkeit, bevor du es präsentierst, wenn Toolunterstützung existiert. Gib dem Subagenten nur aufgabenlokale Beweise und frage, ob das Element autonom abgeschlossen werden kann, welche Verifizierung erforderlich ist und was es unsicher machen könnte. Wenn Subagenten nicht verfügbar sind, mache die gleiche Tiefe selbst und sage dies.
Autonomer Arbeitsmodus
Wenn der Benutzer do work autonomously, work you can do autonomously, keep going oder ähnliches sagt, höre nicht nach einer Warteschlangenzusammenfassung oder einem lokalen Patch auf. Behandle es als Erlaubnis, die Warteschlange der berechtigten Issues/PRs sequenziell zu bearbeiten, bis kein sicheres autonomes Element mehr übrig ist, jedes Element mit Nachweis gelandet/geschlossen/verschoben ist oder ein Blocker Peter erfordert.
Arbeite niemals an mehreren Tickets gleichzeitig. Für jedes Element:
- Lies das Issue/PR, den zugehörigen Code, die Doku, CI und
VISION.md, falls vorhanden; google/verwende offizielle Doku, wenn Fakten veraltet oder unklar sein könnten. - Entscheide, ob es autonom ist:
- Los: Leistungsverbesserungen, es sei denn, die Komplexität steigt zu sehr; Bugfixes mit Reproduktions-/Ursachenanalyse und Verifizierungspfad; kleine UI/UX-Anpassungen; Doku-Fixes; schmale Test-/Interne-Fixes; risikoarme Abhängigkeits-/CI-Bereinigung mit grünem Nachweis.
- Zuerst fragen: Neue Funktionen, Produkt-/Vision-Entscheidungen, breite Verhaltensänderungen, risikoreiche Abhängigkeiten, sicherheitskritische Änderungen ohne starken Nachweis, Live-Provider-Arbeit ohne nutzbare Anmeldeinformationen, alles, was nicht End-to-End getestet werden kann.
- Refaktor-Präferenz: Wähle eine saubere, begrenzte Refaktorisierung, wenn sie die bessere Lösung für ein autonomes Element ist; verwende nicht „kleiner Patch" als Standard, wenn dies ein schlechteres Design hinterlässt.
- Implementiere oder repariere den PR auf die bestmögliche wartbare Weise. Bevorzuge es, den Beitragenden-PR zu aktualisieren, wenn er beschreibbar ist; andernfalls erstelle ihn lokal mit Quellenangabe neu.
- Verifiziere lokal und live End-to-End, wenn möglich. Verwende für UI-Verhalten den erwarteten Live-UI-Nachweispfad des Repos, wie Peekaboo, browser-use, Screenshots oder VM-Nachweise. Verwende für API/Provider-Verhalten einen echten nutzbaren Schlüssel/Konto durch den erwarteten Secret-Workflow, wenn verfügbar. Wenn der Zugriff fehlt, stoppe, bevor du so tust, als sei das Element erledigt, und bitte Peter um Hilfe.
- Führe Codex Auto Review vor Commit/Land durch, es sei denn, es ist trivial/nur Doku oder explizit übersprungen; adressiere akzeptierte/umsetzbare Ergebnisse.
- Stelle sicher, dass CI grün ist, PR-Beschreibung/Changelog gut sind, lande/schließe/kommentiere mit Nachweis, kehre dann zu
mainzurück, führe--ff-onlypull aus und verifiziere einen sauberen Arbeitsbaum, bevor du das nächste autonome Element auswählst. - Nach jedem gelandeten PR, poste einen PR-Kommentar mit genau, wie es getestet wurde: lokale Befehle, Live/UI/API-Nachweise, CI-Lauf/Check-Status, gelandeter Commit und etwaige Einschränkungen. Wenn Verifizierungsbilder anwendbar sind, lade sie mit
gh imagehoch/posted sie, wenn verfügbar; wenn der Uploader nicht verfügbar ist, sage dies und füge den Screenshot-Pfad oder alternativen GitHub-Anhängernachweis ein, anstatt Bilder stillschweigend wegzulassen.
Beende den autonomen Modus nicht mit schmutzigen Dateien oder einem nicht gepushten lokalen Fix, es sei denn, es ist blockiert. Wenn blockiert, nenne den genauen Blocker, aktuellen Branch/Status, bereits gesammelte Nachweise und die nächste benötigte Entscheidung.
Autonome Arbeit ist weiterhin durch den Bereich begrenzt: aktuelles Repo standardmäßig; breite/alle Warteschlangen nur, wenn der Benutzer nach breit/alle/alles gefragt oder Besitzer/Organisationen genannt hat.
Vertrauenssignale
Füge für jedes Nicht-Maintainer-Element, das du zur Bearbeitung empfiehlst, Autoren-/Ersteller-Vertrauen hinzu. Für risikoarme Dependabot/Interne-Elemente reicht eine kurze Bot/Intern-Vertrauenszeile.
Bevorzuge den gebündelten Helfer:
skills/github-project-triage/scripts/github-activity.sh --repo <besitzer/repo> --global <login>
Fallback, wenn dieser Fähigkeits-Checkout den Helfer nicht enthält:
~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <besitzer/repo> --global <login>
Verwende auch github-author-context, wenn ein PR ein tieferes Vertrauensurteil benötigt, insbesondere für OpenClaw, sicherheitskritische Änderungen, breite PRs, neue Konten oder ungewöhnliches Autorenverhalten. Bevorzuge zuerst vorhandene Beitragenden-Notizen:
~/Projects/maintainers/scripts/clawtributors find github <login>
Die Vertrauensausgabe muss sachlich bleiben:
Vertrauen: @login; Konto 2021-04-03; Repo 2 PRs/1 Issue/0 Commits in 12 Monaten; GitHub 9 PRs/3 Issues/12 Reviews; Signal: bekannter Beitragender / neuer Vorbeifahrender / Bot / unbekannt.
Behandle Vertrauen nicht als Beweis. Es ändert die Überprüfungstiefe, nicht die Korrektheit.
Elementbewertung
Klassifiziere jedes Element:
bug: Erfordere Reproduktions-/Log-/fehlschlagenden Test-/aktuellen Main-Nachweis, wenn machbar; identifiziere die Ursache, bevor du eine Lösung/Zusammenführung empfiehlst.feature: Erfordere einen End-to-End-Testplan. Wenn die Live-Validierung einen Provider-Schlüssel, ein Konto, ein Gerät, einen Dienst, Modellzugriff oder eine kostenpflichtige API benötigt, sage genau, welche Anmeldeinformationen fehlen, bevor die Arbeit als abgeschlossen betrachtet werden kann.dependency: Erkläre die Paketgruppe, große/kleine Risiken, fehlschlagende Checks, Laufzeit-/Engine-Änderungen und ob eine Aufteilung erforderlich ist.security: Erhöhe die Priorität, erfordere sorgfältigen Code-Pfad-Nachweis, Tests und Vertrauen/Kontext; führe nicht allein aufgrund von Begründung zusammen.docs/internal: Geringeres Risiko, aber erkläre trotzdem die benutzersichtbare Relevanz und das Risiko von Veralterung/generiertem Aufwand.
Beurteile:
Passung: gut / gemischt / schlecht, mit einem Grund.Risiko: niedrig / mittel / hoch, mit Auswirkungsbereich.Nachweis: aktuelles CI, lokale Reproduktion, fehlschlagender Test, Live-E2E oder fehlender Nachweis.Blocker: CI-Genehmigung für Erstbeitragende, fehlschlagender Check, fehlender Schlüssel, unklare Produktrichtung, veralteter Branch, nicht vertrauenswürdiger/breiter Diff, keine Reproduktion, Konflikte.Nächstes: CI genehmigen, Test ausführen, Reproduktion anfordern, PR aufteilen, lokal patchen, nach Grün zusammenführen, mit Nachweis schließen oder verschieben.
Schnelle Warteschlangenkarte
Verwende dies nur, wenn der Bereich breit ist. Beginne mit Repo-Level-Warteschlangenkarten. Dies findet Repos mit offenen Issues und/oder PRs und gibt Zählungen.
PR-Warteschlange, primäre Triage-Reihenfolge:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort prs \
--json
Issue-Druck, zweiter Durchlauf, wenn Issues wichtig sind:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort issues \
--json
Verwende --forks und --archived nur, wenn der Benutzer "all", "everything" oder nach Archäologie fragt. Standardmäßiges Triage sollte Forks und archivierte Repos auslassen, es sei denn, ihre Warteschlangen sind spezifisch relevant.
Für eine kompakte Terminalansicht:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain
Nützliche jq-Zusammenfassung:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'
Wenn du eine PR-sortierte Warteschlange zusammenfasst, behalte die PR-Zahlen-Reihenfolge von RepoBar bei. Füge kein Repo mit niedrigerer PR-Anzahl ein, während ein Repo mit höherer PR-Anzahl aus demselben Besitzerbereich weggelassen wird. Repos mit null Issues und offenen PRs, zum Beispiel openclaw/crabbox, sind dennoch triage-relevant.
Detaildurchlauf
Nach einer breiten Warteschlangenkarte inspiziere nur die obersten Repos, es sei denn, der Benutzer möchte explizit erschöpfende Details.
repobar_cmd issues <besitzer/name> --limit 50 --json
repobar_cmd pulls <besitzer/name> --limit 50 --json
repobar_cmd ci <besitzer/name> --limit 20 --json
repobar_cmd activity <besitzer/name> --limit 20 --json
Für PRs, die zusammenführbar oder verdächtig aussehen, wechsle zu gh für den Maintainer-gerechten Status:
gh pr view <n> --repo <besitzer/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <besitzer/name> --patch
gh run list --repo <besitzer/name> --branch <branch> --limit 10
Für Issues, die möglicherweise bereits behoben sind, wechsle zu gh issue view, dann inspiziere die aktuelle Quelle, bevor du kommentierst oder schließt.
Für OpenClaw/ClawdBot-Warteschlangen, verwende den OpenClaw-Maintainer-Durchlauf, wenn nützlich:
- suche nach Duplikaten/verwandten Threads mit
gitcrawl, wenn verfügbar; - verwende den Aktivitätshelfer für die Identität des Erstellers/Autors;
- unterdrücke Top-Maintainer-Rauschen, es sei denn, der Benutzer fragt nach Maintainer-eigener Arbeit;
- bevorzuge externe/benutzergemeldete Bugs und PRs mit klarem Nachweis.
Lokale Querprüfung
Verwende dies, wenn die Aufgabe den lokalen Projektstatus, schmutzige Repos oder "was besitze ich hier" erwähnt.
repobar_ local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_ local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json
Führe keine destruktiven lokalen Aktionen aus (local reset, Branch-Löschungen, Checkout-Verschiebungen), es sei denn, der Benutzer bittet explizit darum.
Triage-Heuristiken
Priorisiere:
- PRs mit grüner oder fast grüner CI, kürzlicher Maintainer-Aktivität oder risikoarmen Abhängigkeits-/Dokumentations-/Teständerungen.
- Repos mit hohen offenen PR-Zahlen aber kürzlicher Aktivität, weil sie oft offensichtliche Bereinigung verbergen.
- Issues, die reproduzierbar sind, kürzlich gemeldet wurden oder Releases blockieren.
- Sicherheits-, Release-, Authentifizierungs-, Installations-, CI- und Datenverlustmeldungen