GitHub Project Triage
Utilisez toujours cette compétence lorsque l'utilisateur tape triage, sauf si la demande cible explicitement un domaine autre que GitHub. Depuis un dépôt, utilisez le projet GitHub courant par défaut. Triage signifie des fiches d'éléments orientées mainteneur : URL, ce que chaque issue/PR signifie, pourquoi c'est important, confiance envers l'auteur, adéquation, risque, preuve/état des tests, blocages, et action suivante. Ne renvoyez jamais uniquement des numéros de file d'attente ou des références opaques.
Le résultat est d'abord une URL : chaque issue/PR/élément de dépôt doit inclure son URL GitHub dans la première ligne ou la première phrase de cet élément. Si vous donnez une liste courte, imprimez une URL par élément.
Utilisez RepoBar comme premier passage uniquement pour une découverte large de file d'attente sur les propriétaires/organisations concernés. RepoBar est plus rapide et plus conscient du profil que les boucles gh repo list faites à la main, et il comprend déjà l'activité du dépôt, le nombre d'issues, le nombre de PR, les projets locaux, l'authentification, le cache et les filtres.
Configuration
Préférez un binaire repobar réel lorsqu'il est installé. Dans cet espace de travail, il peut n'exister que comme produit SwiftPM dans ~/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
Propriétaires par défaut pour le tri large : steipete, openclaw. Pour le tri de file d'attente large/par défaut, incluez un passage détaillé pour openclaw/openclaw même s'il n'est pas le premier dépôt par nombre, car c'est la file d'attente principale de ClawdBot/OpenClaw. N'incluez pas amantus-ai ou d'autres propriétaires sauf si l'utilisateur les nomme, si le dépôt courant est déjà sous ce propriétaire, ou si la tâche demande explicitement tout/la totalité. Pour une tâche spécifique à un propriétaire exact, n'élargissez pas au-delà du propriétaire nommé.
Porte du dépôt local
Avant de commencer le travail dans un projet local, vérifiez que le checkout est prêt :
git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch
Ne procédez que lorsque la branche est main, le pull réussit et l'arbre de travail est propre. Si la branche n'est pas main, le pull échoue, ou git status --short montre des modifications, arrêtez-vous et demandez à Peter quoi faire. Ne changez pas de branche, ne stash, ne commitez, ne reset, ne restorez ou ne nettoyez sans instruction explicite.
Règle de périmètre
Si l'utilisateur dit triage et que le répertoire de travail courant est un dépôt Git avec un remote GitHub, triez uniquement ce projet. N'élargissez pas à toutes les files d'attente de Peter/org sauf si l'utilisateur dit broad, all, everything, nomme plusieurs propriétaires/orgs, ou demande un tri multi-dépôt.
Si le dépôt a un fichier VISION.md, lisez-le avant de juger ce qui peut être traité de manière autonome. Utilisez-le comme source de vérité pour l'adéquation produit, puis appliquez les règles de risque/testabilité de cette compétence. Si aucun VISION.md n'existe, utilisez les règles d'adéquation autonome ci-dessous.
Trouvez le projet courant :
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"
Le tri du projet courant commence par :
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
Avant d'agir sur une issue ou une PR, lisez tous les commentaires et traitez les commentaires de Peter/propriétaire comme des instructions de routage faisant autorité. Si Peter dit que c'est bon, que des changements sont nécessaires, que c'est remplacé, que c'est approuvé par le produit, ou que ce n'est pas voulu, cela remplace les étiquettes de bot et le jugement de tri ordinaire. S'il n'y a pas de commentaire de Peter/propriétaire, utilisez le jugement du mainteneur et dites que la décision vous appartient.
Ensuite, inspectez suffisamment de détails pour expliquer chaque élément remonté. Pour les petites files d'attente (environ 10 éléments ouverts ou moins), inspectez tous les éléments. Pour les files plus grandes, inspectez la tranche de priorité la plus élevée et dites ce qui n'a pas été développé.
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
Ne commentez, ne fermez, ne fusionnez, ne relancez ou ne patchez qu'avec des preuves solides.
Résultat du tri
Lorsque l'utilisateur dit triage, scannez toujours les issues ouvertes et les PR ouvertes pour le dépôt courant. Retournez :
Candidats autonomes: éléments qui semblent réparables/mergeables sans plus d'apport produit, avec URL, pourquoi cela se qualifie, vérification requise, et confiance. Ceci est une sélection pour révision, pas une permission de commencer le travail sauf si l'utilisateur demande aussi une exécution autonome.Nécessite Peter: éléments bloqués sur une décision de Peter/propriétaire, direction produit, informations d'identification/accès manquants, preuve fournisseur en direct qui ne peut être obtenue, jugement sécurité/vie privée, ou un commentaire faisant autorité de Peter demandant des changements.Différer/fermer/remplacer: éléments obsolètes, en double, de moindre qualité, ou qui se chevauchent où l'action probable n'est pas un nouveau code.
Pour chaque candidat autonome plausible, utilisez les sous-agents de haut raisonnement disponibles, l'oracle, ou une révision par agent indépendant pour vérifier la faisabilité avant de le présenter, lorsque le support d'outil existe. Donnez au sous-agent seulement les preuves locales à la tâche et demandez si l'élément peut être complété de manière autonome, quelle vérification est requise, et ce qui pourrait le rendre dangereux. Si les sous-agents ne sont pas disponibles, faites vous-même la même profondeur et dites-le.
Mode de travail autonome
Lorsque l'utilisateur dit do work autonomously, work you can do autonomously, keep going, ou similaire, ne vous arrêtez pas après un résumé de file d'attente ou un correctif local unique. Traitez-le comme une permission de traiter séquentiellement la file d'attente d'issues/PR éligibles jusqu'à ce qu'aucun élément autonome sûr ne reste, que chaque élément soit livré/fermé/différé avec preuve, ou qu'un bloqueur nécessite Peter.
Ne travaillez jamais sur plusieurs tickets à la fois. Pour chaque élément :
- Lisez l'issue/PR, le code associé, les docs, la CI, et
VISION.mds'il existe ; utilisez Google/les docs officiels lorsque les faits peuvent être obsolètes ou peu clairs. - Décidez s'il est autonome :
- OK : améliorations de performance sauf si la complexité augmente trop ; corrections de bugs avec repro/racine et chemin de vérification ; petites modifications UI/UX ; corrections de docs ; corrections étroites de test/interne ; nettoyage de dépendance/CI à faible risque avec preuve verte.
- Demander d'abord : nouvelles fonctionnalités, choix de produit/vision, changements larges de comportement, dépendances risquées, changements sensibles à la sécurité sans preuve solide, travail fournisseur en direct sans informations d'identification utilisables, tout ce qui ne peut pas être testé de bout en bout.
- Préférence de refacto : choisissez un refacto propre et limité lorsque c'est le meilleur correctif pour un élément autonome ; n'utilisez pas "petit correctif" comme défaut s'il laisse un design pire.
- Implémentez ou corrigez la PR de la meilleure manière maintenable. Préférez mettre à jour la PR du contributeur quand elle est accessible en écriture ; sinon recréez localement avec crédit.
- Vérifiez localement et en direct de bout en bout si possible. Pour le comportement UI, utilisez le chemin de preuve UI en direct attendu par le dépôt, comme Peekaboo, browser-use, captures d'écran, ou preuve VM. Pour le comportement API/fournisseur, utilisez une clé/compte réel utilisable via le workflow de secret attendu quand disponible. Si l'accès manque, arrêtez-vous avant de faire semblant que l'élément est terminé et demandez de l'aide à Peter.
- Exécutez Codex Auto Review avant le commit/land sauf si trivial/docs seulement ou explicitement sauté ; traitez les résultats acceptés/actionnables.
- Assurez-vous que la CI est verte, que la description de PR/changelog sont bons, landez/fermez/commentez avec preuve, puis retournez sur
main, faitespull --ff-only, et vérifiez un arbre de travail propre avant de sélectionner le prochain élément autonome. - Après chaque PR livrée, postez un commentaire PR avec exactement comment elle a été testée : commandes locales, preuve en direct/UI/API, état de la CI/des vérifications, commit livré, et toutes réserves. Si des images de vérification s'appliquent, téléchargez/publiez-les avec
gh imagequand disponible ; si le téléchargeur n'est pas disponible, dites-le et incluez le chemin de capture d'écran ou une autre preuve de pièce jointe GitHub au lieu de omettre silencieusement les images.
Ne terminez pas le mode autonome avec des fichiers sales ou un correctif local non pushé sauf si bloqué. Si bloqué, indiquez le bloqueur exact, la branche/statut actuel, les preuves déjà rassemblées, et la prochaine décision nécessaire.
Le travail autonome est toujours limité par le périmètre : dépôt courant par défaut ; files d'attente larges/toutes seulement lorsque l'utilisateur a demandé large/tout/la totalité ou a nommé des propriétaires/orgs.
Signaux de confiance
Incluez la confiance envers l'auteur/ouvreur pour chaque élément non-mainteneur que vous recommandez comme action. Pour les éléments Dependabot/internes à faible risque, une ligne de confiance bot/interne laconique suffit.
Préférez l'outil fourni :
skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>
Solution de repli si ce checkout de compétence manque de l'outil :
~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>
Utilisez aussi github-author-context quand une PR nécessite un jugement de confiance plus approfondi, en particulier pour OpenClaw, les changements sensibles à la sécurité, les PR larges, les nouveaux comptes, ou un comportement d'auteur inhabituel. Préférez d'abord les notes de contributeurs existants :
~/Projects/maintainers/scripts/clawtributors find github <login>
La sortie de confiance doit rester factuelle :
Confiance : @login ; compte 2021-04-03 ; dépôt 2 PRs/1 issue/0 commits en 12 mois ; GitHub 9 PRs/3 issues/12 reviews ; signal : contributeur connu / nouveau passager / bot / inconnu.
Ne traitez pas la confiance comme une preuve. Elle modifie la profondeur de la révision, pas la correction.
Évaluation des éléments
Classez chaque élément :
bogue: exiger une repro/un log/un test en échec/une preuve de main courant lorsque c'est faisable ; identifier la cause racine avant de recommander un correctif/une fusion.fonctionnalité: exiger un plan de test de bout en bout. Si la validation en direct a besoin d'une clé de fournisseur, d'un compte, d'un appareil, d'un service, d'un accès à un modèle, ou d'une API payante, dites exactement quelle information/accès manque avant que le travail puisse être considéré comme terminé.dépendance: expliquez le groupe de paquets, le risque majeur/mineur, les vérifications en échec, les changements de runtime/moteur, et s'il faut diviser.sécurité: augmentez la priorité, exigez une preuve de chemin de code minutieuse, des tests, et la confiance/contexte ; ne fusionnez pas sur la seule base de la justification.docs/interne: risque plus faible, mais expliquez toujours la pertinence visible par l'utilisateur et le risque de contenu obsolète/généré.
Jugez :
Adéquation: bonne / mixte / mauvaise, avec une raison.Risque: faible / moyen / élevé, avec rayon d'impact.Preuve: CI actuelle, repro locale, test en échec, E2E en direct, ou preuve manquante.Bloqueur: approbation CI du contributeur pour la première fois, vérification en échec, clé manquante, direction produit peu claire, branche obsolète, diff non fiable/large, pas de repro, conflits.Suivant: approuver CI, exécuter test, demander repro, diviser PR, patcher localement, fusionner après vert, fermer avec preuve, ou différer.
Carte rapide des files d'attente
Utilisez ceci seulement lorsque le périmètre est large. Commencez par des cartes de file d'attente au niveau du dépôt. Cela trouve les dépôts avec des issues et/ou PR ouvertes et donne des comptages.
File d'attente PR, ordre de tri principal :
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort prs \
--json
Pression des issues, second passage quand les issues comptent :
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort issues \
--json
Utilisez --forks et --archived seulement lorsque l'utilisateur dit "all", "everything", ou demande de l'archéologie. Le tri par défaut devrait omettre les forks et les dépôts archivés sauf si leurs files d'attente sont spécifiquement pertinentes.
Pour une vue terminal compacte :
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain
Résumé jq utile :
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'
Lors du résumé d'une file d'attente triée par PR, préservez l'ordre de comptage des PR de RepoBar. N'incluez pas un dépôt avec moins de PR tout en omettant un dépôt avec plus de PR du même périmètre de propriétaire. Les dépôts avec zéro issue mais avec des PR ouvertes, par exemple openclaw/crabbox, sont toujours pertinents pour le tri.
Passage détaillé
Après une carte large de file d'attente, inspectez uniquement les dépôts les plus importants sauf si l'utilisateur veut explicitement des détails exhaustifs.
repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json
Pour les PR qui semblent fusionnables ou suspectes, passez à gh pour un état de qualité mainteneur :
gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10
Pour les issues qui peuvent déjà être corrigées, passez à gh issue view, puis inspectez la source actuelle avant de commenter ou de fermer.
Pour les files d'attente OpenClaw/ClawdBot, utilisez le passage mainteneur OpenClaw lorsque c'est utile :
- cherchez les doublons/fils associés avec
gitcrawlsi disponible ; - utilisez l'outil d'activité pour l'identité de l'ouvreur/auteur ;
- supprimez le bruit des mainteneurs principaux sauf si l'utilisateur demande du travail appartenant au mainteneur ;
- préférez les bogues rapportés par des utilisateurs externes et les PR avec des preuves claires.
Vérification croisée locale
Utilisez ceci lorsque la tâche mentionne l'état du projet local, des dépôts sales, ou "qu'est-ce que je possède ici".
repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json
N'exécutez pas d'actions locales destructrices (local reset, suppressions de branches, déplacements de checkout) sauf si l'utilisateur le demande explicitement.
Heuristiques de tri
Priorisez :
- Les PR avec une CI verte ou presque verte, une activité récente du mainteneur, ou des changements de dépendance/docs/tests à faible risque.
- Les dépôts avec un nombre élevé de PR ouvertes mais une activité récente, car ils cachent souvent un nettoyage évident.
- Les issues qui sont reproductibles, récemment signalées, ou qui bloquent des versions.
- Les rapports de sécurité, de version, d'auth, d'installation, de CI et de perte de données.
…
[le contenu a été tronqué pour la traduction]