steipete/github-project-triage

Tri des issues/PR GitHub : files d'attente, CI, blocages, risques, preuves, actions suivantes.

Qu'est-ce que github-project-triage ?

Cette compétence permet un tri (triage) avancé des issues et pull requests GitHub, orienté vers les mainteneurs. Elle analyse les files d'attente en fonction de la CI, des risques, des preuves (tests, reproductibilité), des blocages et des actions suivantes. L'outil RepoBar est utilisé pour une découverte rapide des dépôts, tandis que les commandes `gh` fournissent des détails granulaires. La compétence évalue la confiance envers l'auteur, classe chaque élément (bogue, fonctionnalité, dépendance, sécurité, documentation) selon des critères de pertinence, de risque et de preuve, et propose des actions concrètes (CI, test, relecture, fermeture). Elle prend en charge un mode de travail autonome séquentiel, où elle implémente, vérifie et fusionne les correctifs de manière indépendante, à condition que les preuves soient suffisantes et que le périmètre soit respecté. Le projet actuel est trié par défaut, mais un balayage large des files d'attente est possible sur demande.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-project-triage

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. Lisez l'issue/PR, le code associé, les docs, la CI, et VISION.md s'il existe ; utilisez Google/les docs officiels lorsque les faits peuvent être obsolètes ou peu clairs.
  2. 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.
  3. 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.
  4. 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.
  5. Exécutez Codex Auto Review avant le commit/land sauf si trivial/docs seulement ou explicitement sauté ; traitez les résultats acceptés/actionnables.
  6. Assurez-vous que la CI est verte, que la description de PR/changelog sont bons, landez/fermez/commentez avec preuve, puis retournez sur main, faites pull --ff-only, et vérifiez un arbre de travail propre avant de sélectionner le prochain élément autonome.
  7. 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 image quand 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 gitcrawl si 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]

Individual skills in this repo

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

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills associés