pr-triage

Par mkurman · zorai

À utiliser lorsque l'utilisateur souhaite un résumé de la file d'attente de révision des pull requests, une vérification matinale des PR, un scan des PR obsolètes, ou un résumé de triage GitHub prêt à l'emploi livré dans le chat.

npx skills add https://github.com/mkurman/zorai --skill pr-triage

Triage des PR

Utilisez cette skill pour produire un résumé concis et actionnable du triage des pull requests à partir du plugin GitHub.

Quand l'utiliser

  • Revue technique en début de journée
  • Vérification à la demande de la file d'attente des PR
  • Digest de statut programmé
  • Analyse des goulots d'étranglement de révision
  • Suivi des PR obsolètes

Entrées nécessaires

  • Plugin GitHub configuré avec un token
  • propriétaire du repository
  • nom du repository
  • cible de livraison optionnelle : Slack, Telegram ou Discord

Schéma de récupération

  1. Récupérez l'aperçu du repository quand le contexte de branche ou de repo importe.
  2. Récupérez les pull requests ouvertes.
  3. Si nécessaire, récupérez les issues ouvertes pour le contexte bloquant.
  4. Concentrez-vous sur l'état des PR actionnable, pas sur la sortie brute complète.

Appels GitHub principaux :

{"plugin_name": "github", "endpoint_name": "get_repo", "params": {"owner": "OWNER", "repo": "REPO"}}
{"plugin_name": "github", "endpoint_name": "list_pull_requests", "params": {"owner": "OWNER", "repo": "REPO"}}

Exemple de filtre optionnel :

{"plugin_name": "github", "endpoint_name": "list_pull_requests", "params": {"owner": "OWNER", "repo": "REPO", "state": "open", "per_page": 20}}

Contexte bloquant optionnel :

{"plugin_name": "github", "endpoint_name": "list_issues", "params": {"owner": "OWNER", "repo": "REPO", "state": "open", "per_page": 20}}

Catégories de triage

Résumez les PR dans ces catégories quand c'est possible :

  • needs-review — PR ouvertes probablement en attente d'attention du relecteur
  • needs-merge — PR qui semblent prêtes à être intégrées
  • blocked — PR avec des blocages évidents, état obsolète ou contexte de dépendance non résolu
  • stale — PR assez anciennes ou assez silencieuses pour nécessiter un suivi

Si les données disponibles du plugin sont limitées, indiquez ce qui est déduit par rapport à ce qui est confirmé.

Format du résumé

Gardez le résumé court et opérationnel :

  • nom du repo
  • nombre de PR ouvertes
  • éléments actionables principaux par catégorie
  • PR stales notables
  • prochaines actions claires

Exemple de structure :

Triage des PR — OWNER/REPO

PR ouvertes : 7
À revoir : 3
À fusionner : 1
Bloquées : 2
Obsolètes : 1

Actions prioritaires :
- #123 Add X — à revoir
- #118 Fix Y — probablement prêt à fusionner
- #111 Refactor Z — bloqué par des vérifications échouées ou suivi manquant

Livraison

Pour une livraison en chat, envoyez le résumé final concis via l'un de :

  • send_slack_message
  • send_telegram_message
  • send_discord_message

Livrez uniquement après que le résumé soit propre et lisible par un humain.

Compatibilité avec les routines

Cette skill est compatible avec les routines.

Fenêtres de déclenchement typiques :

  • début de journée de travail
  • avant le standup
  • revue de fin d'après-midi
  • remise de fin de journée

Gestion des erreurs

  • Si le plugin GitHub n'est pas configuré, indiquez que le token GitHub manque.
  • Si les coordonnées du repo manquent, demandez le propriétaire/repo.
  • Si la sortie du plugin est insuffisante, fournissez un triage au mieux et étiquetez explicitement les incertitudes.

Skills similaires