sentry-pr-code-review

Sobre sentry-pr-code-review

Um fluxo de trabalho para revisar e corrigir problemas que o Seer by Sentry sinaliza como comentários de revisão de código em pull requests do GitHub por meio de seu recurso de Previsão de Bugs. É a ferramenta adequada quando alguém solicita a revisão ou o tratamento de comentários do Sentry ou Seer em um PR, para resolver essas descobertas ou localizar PRs recentes que ainda contenham feedback não resolvido do Sentry. A habilidade faz parte de uma árvore de fluxo de trabalho mais ampla do Sentry e não pode ser invocada por modelos de forma independente.

Depende da instalação e autenticação do CLI do gh e da instalação do Aplicativo do GitHub Seer by Sentry no repositório. O processo possui quatro fases. A Fase 1 recupera comentários de revisão por meio da API do gh no endpoint de comentários do PR, filtrando pelo nome de login do bot seer-by-sentry[bot], excluindo explicitamente sentry[bot] ou sentry-io[bot] e, quando nenhum número de PR é fornecido, analisa os PRs abertos recentes para contar os comentários do Seer. A Fase 2 analisa cada comentário em markdown para a descrição do bug, uma linha de severidade e confiança, e as seções expansíveis Análise Detalhada, Sugestão de Correção e Prompt para Agente de IA. A Fase 3 verifica cada problema lendo o arquivo na linha citada, confirmando se o problema ainda existe, julgando se é real ou um falso positivo e implementando uma correção enquanto pondera casos extremos e risco de regressão. A Fase 4 resume os resultados em uma tabela de itens resolvidos versus ignorados.

A documentação observa que o formato de comentário analisado reflete a saída atual do Seer em vez de um contrato de API estável, portanto, a estrutura real deve sempre ser verificada. Ela também abrange quando as revisões do Seer são acionadas, incluindo um PR sendo movido para Pronto para Revisão, novos commits em um PR pronto e um comentário de revisão manual do Sentry, enquanto os PRs rascunhos são ignorados. As orientações de solução de problemas abordam comentários ausentes, incompatibilidade de nomes de bots e resultados parciais da API do gh, e uma tabela de referência lista categorias comuns de problemas, como segurança de tipos, tratamento de erros, validação e configuração.

Perguntas Frequentes

Quais são os pré-requisitos para usar esta habilidade?

O CLI do gh deve estar instalado e autenticado, e o repositório deve ter o Aplicativo do GitHub Seer by Sentry instalado.

Qual nome de login do bot identifica os comentários a serem corrigidos?

Os comentários vêm de seer-by-sentry[bot]; a habilidade enfatiza que não se trata de sentry[bot] ou sentry-io[bot].

O que acontece se eu não fornecer um número de PR?

Ele lista os PRs abertos recentes e conta os comentários do Seer em cada um, relatando quais PRs possuem feedback não resolvido do Seer.

Como ele decide se deve aplicar realmente uma correção?

Para cada problema, lê o arquivo na linha citada, confirma se o problema ainda existe no código atual, avalia se é um problema real ou um falso positivo e, em seguida, implementa uma correção considerando casos extremos e risco de regressão.

Quando o Seer executa uma revisão em um pull request?

O Seer é executado automaticamente quando um PR é definido como Pronto para Revisão ou um commit é enviado enquanto está pronto, e em um comentário de revisão manual do Sentry; os PRs rascunhos são ignorados.