Cómo usarlo
Pídele a Codex que revise las fuentes donde ya aparecen errores: alertas de Sentry, incidencias de Linear, Issues de GitHub, verificaciones de PR, registros de despliegue, tickets de soporte e hilos de Slack. Empieza con una revisión manual, ajusta el informe en el chat y luego programa la revisión para que se repita.
Usa un solo chat de Codex para todo el proceso de clasificación de errores:
- Ejecuta una revisión bajo demanda para obtener una lista preliminar.
- Revisa la lista y deja tus comentarios en ese mismo chat.
- Desde ese chat, programa una tarea para clasificar los errores.
- Opcional: cuando confíes en el informe, pídele a Codex que prepare borradores de incidencias de Linear, actualizaciones para Slack, comentarios de GitHub o notas de traspaso.
Antes de empezar, instala los complementos que necesita Codex, como los de Sentry, Slack, Linear o GitHub. En el prompt inicial, reemplaza la lista de complementos entre corchetes por menciones reales de los complementos con @. Luego reemplaza cada fuente entre corchetes por el lugar exacto donde buscar: un proyecto de Sentry o la URL de una alerta, un canal o hilo de Slack, un equipo, una vista o una consulta de Linear, un repositorio de GitHub, una consulta de Issues de GitHub o una verificación de PR, un enlace a un despliegue, un archivo de registro, una cola de soporte o un panel.
Fase 1: ejecuta la revisión
Inicia Codex desde el repositorio al que corresponden los errores cuando sea útil contar con contexto local, como pruebas, herramientas del repositorio, verificaciones de compilación o fallas de CI. También puedes ejecutar la revisión desde cualquier repositorio si puedes acceder a las fuentes mediante complementos, conectores, servidores MCP, enlaces, datos exportados, registros pegados en el chat o archivos adjuntos.
Ejecuta primero el prompt inicial que aparece arriba. Conserva solo los complementos y las fuentes que forman parte de la revisión.
Por ejemplo, al completar el prompt, puedes indicar los complementos y especificar qué colas, canales o repositorios quieres revisar.
Antes de automatizar la revisión, asegúrate de que valga la pena leer el informe todos los días.
En un primer informe útil:
- Los errores más relevantes están ordenados por prioridad, de P0 a P3.
- Los reportes duplicados se agrupan bajo un mismo error.
- Cada error incluye enlaces a la evidencia o citas breves.
- Las suposiciones se distinguen de los hechos observados.
- Para cada error se recomienda brevemente qué hacer a continuación.
Ajusta el informe en el mismo chat antes de programar la revisión. Puedes pedirle a Codex que:
- Revise una fuente más antes de ordenar la lista por prioridad.
- Omita las alertas repetitivas que el equipo ya conoce.
- Muestre solo los errores P0 y P1.
- Agrupe los reportes de Slack, las alertas de Sentry y las fallas de GitHub cuando apunten al mismo error.
- Muestre solo el enlace más útil para cada error.
- Agregue evidencia suficiente para que otra persona pueda reproducir el problema o derivarlo a quien corresponda.
Fase 3: automatiza la revisión
Cuando el informe bajo demanda te resulte útil, sigue en el mismo chat y programa desde allí una tarea para clasificar los errores. Codex puede usar los ajustes que hiciste en el chat para redactar el prompt de la tarea recurrente.
Programa la clasificación de errores
Fase 4: dirige el seguimiento al equipo correspondiente
Cuando el informe programado te resulte útil, decide dónde dar seguimiento a los errores. Codex puede preparar una actualización de Slack para un canal del equipo, redactar incidencias de Linear para los errores que quieras seguir, redactar comentarios de GitHub para un PR con verificaciones fallidas o preparar una nota de traspaso para quien esté de guardia.