sentry

Visión general de sentry skill

La skill sentry es una herramienta de observabilidad de solo lectura para investigar datos de Sentry con rapidez: issues, eventos, señales de salud e impacto probable en producción. Es ideal para quien quiere responder a “¿qué está fallando, dónde y qué tan grave es?” sin tener que ir haciendo clic manualmente por Sentry. Frente a un prompt genérico, sentry skill está ajustada para inspección desde CLI, así que resulta más fiable cuando necesitas datos actuales, consultas repetibles y salida estructurada.

Usa esta skill cuando ya sabes que necesitas información específica de Sentry y quieres una guía práctica de sentry para triage, no una visión general amplia de observabilidad. Encaja bien para personal de respuesta a incidentes, ingenieros que revisan regresiones y analistas que necesitan resúmenes breves y verificables a partir de datos en vivo de Sentry.

Lo que sentry skill hace bien

Permite investigar en modo de solo lectura mediante el comando sentry, con valores predeterminados pensados para un triage rápido: ventanas de tiempo recientes, filtrado con prioridad en producción y salida JSON para procesamiento posterior. La skill es especialmente útil cuando necesitas listar issues sin resolver, inspeccionar un issue concreto por short ID o extraer datos estructurados sin perder la gestión de paginación ni de autenticación.

Cuándo conviene usar esta skill

Elige sentry skill si tu tarea depende del estado en vivo de Sentry, necesitas consultas reproducibles o prevés iterar sobre filtros como entorno, proyecto, rango temporal o prioridad. También encaja bien cuando el usuario quiere un flujo de trabajo de sentry para observabilidad que se pueda reutilizar en automatización o en análisis con agentes.

Qué conviene saber antes de instalarla

Esta skill es de solo lectura. No crea issues, no cambia alertas ni modifica la configuración de los proyectos. Los bloqueos más habituales para adoptarla son la falta de autenticación, una selección poco clara de org/proyecto o intentar usarla con datos que no son de Sentry. Si necesitas acciones de escritura o paneles de control, esta no es la skill adecuada.

Cómo usar sentry skill

Instala y autentica

Instala sentry skill con npx skills add openai/skills --skill sentry. Si la CLI no está disponible todavía, instala primero Sentry CLI y después autentícate localmente con sentry auth login o SENTRY_AUTH_TOKEN. Comprueba el acceso con sentry auth status antes de pedir trabajo de investigación. No pegues tokens en el chat.

Dale a la skill la entrada correcta

Para usar sentry de la mejor manera, pide un objetivo de investigación concreto junto con un alcance. Las entradas sólidas nombran el síntoma, el entorno y la ventana temporal, por ejemplo: “Investiga el último pico de 5xx en producción de las últimas 24h y resume los principales issues sin resolver”. Si sabes cuál es el proyecto, inclúyelo; si no, deja que primero intente la detección automática. La CLI suele poder inferir org/proyecto a partir de DSN, código fuente, valores predeterminados de configuración y nombres de directorios.

Empieza por los archivos y comandos correctos

Lee primero SKILL.md y después revisa agents/openai.yaml para ver el comportamiento predeterminado y el encuadre del prompt. Usa sentry schema <resource> cuando necesites descubrir endpoints o campos disponibles. Para resultados legibles por máquina, pide siempre --json y combínalo con --fields para reducir ruido y hacer que los resúmenes sean más precisos.

Flujo de trabajo práctico para mejores resultados

Un buen flujo de trabajo de sentry guide es: confirmar la autenticación, verificar la org/proyecto de destino, ejecutar una consulta de listado estrecha y luego inspeccionar uno o dos detalles de issues antes de resumir. Por ejemplo, empieza con issues sin resolver en producción de las últimas 24h y luego afina por release, entorno o prioridad si la primera pasada es demasiado amplia. Esto mantiene el análisis anclado en datos actuales en lugar de sobreajustarlo a un único evento ruidoso.

Preguntas frecuentes sobre sentry skill

¿sentry skill necesita Sentry CLI?

Sí. sentry skill está pensada alrededor de la CLI sentry, no de un flujo de trabajo en navegador. Si falta la CLI, instálala y autentícate localmente primero. Esa preparación es lo que hace que la instalación de sentry valga la pena para una investigación repetible y de solo lectura.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede describir una consulta de Sentry, pero sentry skill añade una forma concreta de operar: expectativas de autenticación, convenciones de consulta predeterminadas, salida JSON y selección de campos. Eso reduce la improvisación y hace que el resultado sea más fácil de verificar o automatizar.

¿sentry skill es apta para principiantes?

Sí, si la persona usuaria puede explicar el problema con claridad. Los principiantes suelen obtener buenos resultados cuando indican “qué falló, cuándo y dónde” en lugar de intentar construir una consulta exacta de CLI. La skill se encarga de la mecánica de consulta; el usuario solo necesita definir el objetivo de la investigación.

¿Cuándo no debería usarla?

No uses sentry skill para editar la configuración de Sentry, cambiar políticas de alertas ni para cualquier flujo que requiera acceso de escritura. Tampoco es una buena opción si no tienes acceso a la org/proyecto relevante o si tu pregunta trata sobre logs de aplicación fuera de Sentry.

Cómo mejorar sentry skill

Aporta un contexto de investigación más preciso

sentry skill funciona mejor cuando especificas el entorno, el rango temporal y el síntoma que te importa. “Resume los errores recientes” es menos útil que “Encuentra los principales errores de producción sin resolver de las últimas 6h después del release 2.4.1”. Un mejor contexto mejora la priorización de issues, reduce los falsos positivos y ayuda al agente a elegir los filtros adecuados.

Pide salida estructurada

Si quieres un resultado útil de sentry para observabilidad, pide una tabla o un resumen en viñetas con short ID, título, severidad e impacto probable. Eso orienta el flujo hacia una salida accionable en lugar de una narración vaga. Si necesitas uso por máquina, solicita campos compatibles con --json para que la respuesta siga siendo compacta y fácil de parsear.

Itera afinando, no ampliando

Si la primera pasada devuelve demasiado ruido, acota por release, entorno o un short ID de issue concreto en lugar de pedir “todo”. Si la primera pasada se queda corta, amplía la ventana temporal antes de quitar filtros. El mejor uso de sentry suele venir de una consulta enfocada seguida de una sola refinación, no de una búsqueda gigante de una vez.