GitHub PR Workflow

• Vous avez des modifications locales prêtes à livrer et souhaitez qu'une branche soit créée, des commits préparés et une PR ouverte avec une description structurée en un seul flux.
• Vous devez surveiller les exécutions de vérifications CI sur une PR ouverte et souhaitez que les journaux d'échecs remontent automatiquement sans surveiller l'interface GitHub.
• Vous voulez une boucle de correction automatique : détecter une vérification de lint ou de test en échec, appliquer un correctif, pousser, et ré-interroger jusqu'à ce que toutes les vérifications passent au vert.
• Vous êtes prêt à fusionner et souhaitez qu'une stratégie spécifique (squash, rebase ou commit de fusion) soit appliquée et que la branche source soit supprimée ensuite.

• Vous ne travaillez pas dans un dépôt git avec GitHub comme remote — cette compétence suppose cette configuration tout au long du processus.
• Vous n'avez pas le CLI gh authentifié ni de GitHub PAT disponible ; sans l'un d'eux, les appels API échoueront.
• Vous devez gérer des remotes GitLab, Bitbucket ou d'autres remotes non-GitHub — la compétence est spécifique à GitHub.

Crée automatiquement une branche de fonctionnalité avec un slug nommé de manière conventionnelle et prépare vos modifications avec un message de commit généré. Maintient un historique de commits propre sans vous obliger à rédiger les messages manuellement.

Pousse la branche vers l'origine et ouvre une pull request en utilisant un modèle de description intégré (references/pr-template.md). Prend en charge les demandes de relecteurs, l'attribution de labels et la liaison d'issues dans la même étape.

Interroge les vérifications GitHub via scripts/watch_ci.sh et affiche directement dans votre session les journaux de toute vérification en échec. Fini de naviguer dans l'interface Actions pour retrouver l'erreur.

Lorsqu'une vérification échoue, la compétence peut appliquer un correctif, pousser le nouveau commit et relancer l'interrogation des vérifications — en répétant le cycle jusqu'à ce que toutes les vérifications requises soient validées. Cela évite les allers-retours de commits lors de la gestion des erreurs de linting ou de formatage.

Prend en charge la fusion par squash, la fusion par rebase et les commits de fusion standard. Après la fusion, la branche source est supprimée afin de garder le dépôt distant bien organisé.

Utilise le CLI gh comme pilote principal lorsqu'il est authentifié. Si gh n'est pas disponible, references/api-fallback.md et les scripts basés sur curl prennent en charge toutes les opérations vers l'API REST GitHub en utilisant $GITHUB_TOKEN.

Un développeur dispose de modifications locales et demande : « Ouvre une PR intitulée 'Add rate limiting to /api/search' ciblant main. » La compétence crée la branche, prépare les commits, pousse les modifications et ouvre la PR avec une description — aucune commande git manuelle n'est nécessaire.

Après avoir ouvert une PR, un développeur demande : « Surveille les vérifications de la PR, et si le lint échoue, corrige et pousse à nouveau. » La compétence interroge les exécutions de vérification, détecte l'échec du lint, applique la correction, pousse les modifications, puis vérifie à nouveau jusqu'à ce que la suite soit au vert.

Lorsque la revue est approuvée, un développeur demande : "Squash-merger la PR #142 et supprimer la branche." La compétence effectue la fusion par squash et supprime la branche distante en une seule action.

Un développeur demande : « Vérifie ma branche — quels contrôles échouent et qui n'a pas encore approuvé ? » La compétence remonte le statut CI actuel et les approbations de réviseurs en attente depuis l'API GitHub PR Workflow.