sentry-pr-code-review

Acerca de sentry-pr-code-review

Un flujo de trabajo para revisar y corregir problemas que Seer por Sentry marca como comentarios de revisión de código en las solicitudes de extracción (pull requests) de GitHub a través de su función de Predicción de errores. Es la herramienta adecuada cuando alguien solicita revisar o abordar los comentarios de Sentry o Seer en una solicitud de extracción, para resolver esos hallazgos o para localizar solicitudes de extracción recientes que aún contienen comentarios no resueltos de Sentry. La habilidad forma parte de un árbol de flujos de trabajo más amplio de Sentry y no es invocable por el modelo por sí misma.

Depende de que la CLI de gh esté instalada y autenticada, así como de que la aplicación de GitHub Seer por Sentry esté instalada en el repositorio. El proceso tiene cuatro fases. La fase 1 obtiene los comentarios de revisión mediante la API de gh en el punto final de comentarios de la solicitud de extracción, filtrando por el nombre de inicio de sesión del bot seer-by-sentry[bot], excluyendo explícitamente sentry[bot] o sentry-io[bot], y, cuando no se proporciona un número de solicitud de extracción, escanea las solicitudes de extracción abiertas recientes para contar los comentarios de Seer. La fase 2 analiza cada comentario en formato markdown para extraer la descripción del error, una línea de gravedad y confianza, y las secciones colapsables de Análisis detallado, Solución sugerida y Solicitud para el agente de IA. La fase 3 verifica cada problema leyendo el archivo en la línea citada, confirmando que el problema aún existe, juzgando si es real o un falso positivo, e implementando una solución mientras sopesa los casos extremos y el riesgo de regresión. La fase 4 resume los resultados en una tabla de elementos resueltos frente a omitidos.

La documentación señala que el formato de comentario analizado refleja la salida actual de Seer en lugar de un contrato de API estable, por lo que la estructura real siempre debe verificarse. También cubre cuándo se activan las revisiones de Seer, incluyendo una solicitud de extracción que pasa a Estado listo para revisión, nuevos commits en una solicitud de extracción lista y un comentario manual de revisión de Sentry, mientras que las solicitudes de extracción en borrador se omiten. La guía de solución de problemas aborda comentarios faltantes, discrepancias en el nombre del bot y resultados parciales de la API de gh, y una tabla de referencia enumera categorías comunes de problemas como seguridad de tipos, manejo de errores, validación y configuración.

Preguntas frecuentes

¿Cuáles son los requisitos previos para utilizar esta habilidad?

Debe estar instalada y autenticada la CLI de gh, y el repositorio debe tener instalada la aplicación de GitHub Seer por Sentry.

¿Qué nombre de inicio de sesión del bot identifica los comentarios que deben corregirse?

Los comentarios provienen de seer-by-sentry[bot]; la habilidad enfatiza que no se trata de sentry[bot] ni de sentry-io[bot].

¿Qué sucede si no proporciono un número de solicitud de extracción?

Enumera las solicitudes de extracción abiertas recientes y cuenta los comentarios de Seer en cada una, informando qué solicitudes de extracción tienen comentarios no resueltos de Seer.

¿Cómo decide si aplicar realmente una solución?

Para cada problema, lee el archivo en la línea citada, confirma que el problema aún existe en el código actual, evalúa si se trata de un problema real o un falso positivo y, a continuación, implementa una solución considerando los casos extremos y el riesgo de regresión.

¿Cuándo ejecuta Seer una revisión en una solicitud de extracción?

Seer se ejecuta automáticamente cuando una solicitud de extracción se establece como Lista para revisión o se envía un commit mientras está lista, y mediante un comentario manual de revisión de Sentry; las solicitudes de extracción en borrador se omiten.