sentry-pr-code-review

À propos de sentry-pr-code-review

Un flux de travail pour examiner et corriger les problèmes que Seer by Sentry signale en tant que commentaires de revue de code sur les pull requests GitHub via sa fonctionnalité de prédiction de bugs. C'est l'outil approprié lorsque quelqu'un demande d'examiner ou de traiter les commentaires Sentry ou Seer sur une PR, pour résoudre ces résultats ou pour localiser les PR récentes qui portent encore des commentaires Sentry non résolus. Cette compétence fait partie d'un arbre de flux de travail Sentry plus large et n'est pas invoquable par le modèle de manière autonome.

Elle dépend de l'installation et de l'authentification du CLI gh, ainsi que de l'installation de l'application GitHub Seer by Sentry sur le dépôt. Le processus comporte quatre phases. La phase 1 récupère les commentaires de revue via l'API gh sur le point de terminaison des commentaires de PR, en filtrant pour le nom de connexion du bot seer-by-sentry[bot], explicitement pas sentry[bot] ou sentry-io[bot], et, lorsqu'aucun numéro de PR n'est fourni, scanne les PR ouvertes récentes pour compter les commentaires Seer. La phase 2 analyse chaque commentaire markdown pour la description du bug, une ligne de sévérité et de confiance, et les sections pliables d'analyse détaillée, de correction suggérée et d'invite pour l'agent IA. La phase 3 vérifie chaque problème en lisant le fichier à la ligne citée, en confirmant que le problème existe toujours, en jugeant s'il s'agit d'un problème réel ou d'un faux positif, et en implémentant une correction tout en pondérant les cas limites et le risque de régression. La phase 4 résume les résultats dans un tableau des éléments résolus par rapport aux éléments ignorés.

La documentation note que le format de commentaire analysé reflète la sortie actuelle de Seer plutôt qu'un contrat d'API stable, donc la structure réelle doit toujours être vérifiée. Elle couvre également les déclencheurs des revues Seer, notamment une PR passant à « Prête pour revue », de nouveaux commits sur une PR prête et un commentaire de revue Sentry manuel, tandis que les PR brouillons sont ignorés. Les conseils de dépannage traitent des commentaires manquants, des incompatibilités de nom de bot et des résultats partiels de l'API gh, et un tableau de référence liste les catégories courantes de problèmes telles que la sécurité des types, la gestion des erreurs, la validation et la configuration.

FAQ

Quelles sont les conditions préalables à l'utilisation de cette compétence ?

Le CLI gh doit être installé et authentifié, et le dépôt doit avoir l'application GitHub Seer by Sentry installée.

Quel nom de connexion de bot identifie les commentaires à corriger ?

Les commentaires proviennent de seer-by-sentry[bot] ; la compétence souligne qu'il ne s'agit pas de sentry[bot] ou sentry-io[bot].

Que se passe-t-il si je ne fournis pas de numéro de PR ?

Il liste les PR ouvertes récentes et compte les commentaires Seer sur chacune, signalant quelles PR portent des commentaires Seer non résolus.

Comment décide-t-il d'appliquer réellement une correction ?

Pour chaque problème, il lit le fichier à la ligne citée, confirme que le problème existe toujours dans le code actuel, évalue s'il s'agit d'un problème réel ou d'un faux positif, puis implémente une correction en tenant compte des cas limites et du risque de régression.

Quand Seer exécute-t-il une revue sur une pull request ?

Seer s'exécute automatiquement lorsqu'une PR est définie comme « Prête pour revue » ou qu'un commit est poussé pendant qu'elle est prête, et sur un commentaire de revue Sentry manuel ; les PR brouillons sont ignorés.