Ir al contenido principal
Español— Elegir un idioma
Menú

Revisión de código automatizada

Lección 11 de 20 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Mejora la calidad del código con revisiones de IA
  2. Ejecutar una revisión en una PR
  3. Dirigir las revisiones a un dominio concreto
  4. Automatizar revisiones en GitHub
  5. Autorrevisión antes de abrir la PR
  6. Establece tus estándares en AGENTS.md
  7. Puntos clave

Actualizado el 3 de noviembre de 2026 según las páginas Code Review y Use Codex in GitHub de la documentación de Codex y la ayuda de la CLI versión 0.166.0: las revisiones se activan mediante @codex review o con la revisión automática habilitada en la configuración; localmente, mediante codex review --uncommitted o /review; la sección de AGENTS.md se titula ## Code Review Rules. Se han eliminado el comando de extensión “Codex: Review Changes” y la URL codex.openai.com, y el ejemplo de informe se presenta como una ilustración. Fuentes: Code review · Use Codex in GitHub.

Mejora la calidad del código con revisiones de IA

En la mayoría de los equipos, la revisión de código se ha convertido en el cuello de botella del pipeline de entrega: las solicitudes de extracción (pull requests) se acumulan porque los revisores cualificados están ocupados escribiendo código ellos mismos. Codex no sustituye a los revisores humanos; se encarga del primer pase: detecta despistes obvios, desviaciones de la arquitectura existente y casos límite no probados. Cuando un desarrollador abre finalmente la PR, ya no necesita señalar pruebas faltantes en rutas de error; puede centrar su atención en decisiones que requieren juicio de negocio.

Ejecutar una revisión en una PR

En GitHub, el enfoque más directo es mencionar a Codex en un comentario de la solicitud de extracción: @codex review. Codex reacciona (👀) y publica su revisión en la PR. En la aplicación de escritorio, el módulo Code Review muestra la descripción de la PR, los archivos modificados, los comentarios y las verificaciones, lo que te permite consultar a Codex sobre el cambio. En ambos casos, la calidad del informe depende de la precisión de la solicitud: nombra las áreas que debe cubrir.

"Revisa la PR #142. Comprueba:
- Coherencia con la arquitectura existente
- Posibles problemas de seguridad
- Cobertura de pruebas
- Calidad del código TypeScript
- Casos límite no gestionados"

Codex analiza el diff, pero también lee el contexto de los archivos modificados, no solo las líneas cambiadas, y luego entrega un informe estructurado. Aquí tienes un ejemplo del tipo de informe que podrías esperar para una PR que añade notificaciones:

## Revisión de la PR #142 — Adición del sistema de notificaciones

### Seguridad
⚠️ src/api/routes/notifications.ts:34
  El parámetro userId proviene del cuerpo de la solicitud sin 
  validación. Un usuario podría enviar notificaciones en nombre de 
  otro. Usa req.user.id desde el middleware de autenticación.

### Arquitectura
✅ El servicio sigue el mismo patrón que otros servicios
⚠️ El archivo notification.service.ts ya tiene 200 líneas.
  Considera separar los canales (correo electrónico, webhook) en 
  archivos distintos.

### Pruebas
❌ No hay prueba para cuando el servicio de correo electrónico no 
   esté disponible (tiempo de agotado/error de red)
⚠️ Las pruebas simulan la BD pero no el servicio de correo electrónico

### Calidad del código
💡 La función sendBatch podría usar Promise.allSettled 
   en lugar de Promise.all para evitar fallos si una 
   notificación de 50 falla.

Presta atención a la naturaleza de los comentarios más que a su formato. La vulnerabilidad de userId es exactamente lo que un revisor apresurado pasa por alto un viernes por la tarde: el código se compila, las pruebas pasan, pero cualquier usuario puede escribir en nombre de otro. La sugerencia de Promise.allSettled refleja una comprensión del comportamiento esperado: un envío por lotes no debería fallar porque una dirección de cincuento rebote, no es la aplicación mecánica de una regla de estilo.

Dirigir las revisiones a un dominio concreto

Las revisiones generales diluyen la atención abarcando cinco temas a la vez. Al preparar una versión sensible para producción, solicita en su lugar un pase especializado sobre un alcance reducido. Para seguridad, la instrucción sería así:

"Revisión de seguridad en los archivos modificados en 
src/api/ en los últimos 5 commits. Busca:
- Inyecciones SQL
- Posibles XSS  
- Autenticación faltante
- Datos sensibles expuestos
- Permisos no comprobados"

Codex conoce patrones comunes de vulnerabilidad y puede detectarlos en tu código, incluso cuando están ocultos tras una capa de abstracción personalizada. El mismo principio se aplica al rendimiento, salvo que buscas síntomas muy distintos: no un fallo, sino una consulta que se ejecuta cien veces cuando con una bastaría:

"Analiza el rendimiento de src/services/report.service.ts.
Identifica:
- Consultas a la base de datos N+1
- Bucles que podrían paralelizarse
- Datos cargados pero no utilizados
- Cálculos que podrían almacenarse en caché"

Automatizar revisiones en GitHub

Una vez establecida la práctica en el equipo, hazla sistemática en lugar de depender de la memoria individual. La documentación de Codex describe la configuración de la siguiente manera:

  1. Conecta tu repositorio de GitHub a Codex (necesitas permisos de push o de administrador en su configuración).
  2. Abre la configuración de revisión de código.
  3. Selecciona el repositorio y, a continuación, habilita Automatic review en Review code.

Todos pueden también habilitar la revisión automática para sus propias PR en sus preferencias personales y elegir cuándo se activa (Review trigger), sin tener que escribir @codex review. Esta revisión en la nube no requiere crear un entorno de Codex Cloud. Los comentarios aparecen directamente en la PR de GitHub, en el mismo lugar que los comentarios de los revisores humanos, un detalle que impulsa la adopción: una observación que obliga a la gente a abrir otra herramienta no se leerá. La revisión de solicitudes de fusión de GitLab también existe, en vista previa.

Autorrevisión antes de abrir la PR

El mejor momento para solucionar un problema es antes de que nadie más lo vea. Desde el IDE o la CLI, una autorrevisión sobre cambios no confirmados lleva segundos y te ahorra un ciclo completo de revisión:

# Desde la CLI, no interactiva: revisar cambios no confirmados
codex review --uncommitted

# O revisar una rama frente a main
codex review --base main

En una sesión interactiva, el comando /review hace lo mismo en tu árbol de trabajo; en la aplicación de escritorio, Code Review también ofrece revisar los cambios locales.

Pruébalo en tu próxima rama antes de hacer push: verás que la mitad de los comentarios que sueles recibir de tus compañeros ya están resueltos y la conversación de la revisión comienza en un nivel más interesante.

Establece tus estándares en AGENTS.md

Una revisión solo tiene valor si aplica los criterios de tu equipo, no los de algún proyecto imaginario. Codex busca archivos AGENTS.md en el repositorio y sigue sus reglas de revisión: añade una sección ## Code Review Rules al archivo más cercano al código relevante, con subtítulos ### para agrupar las comprobaciones.

## Code Review Rules

### API
- Cada ruta de API debe verificar la autenticación
- Los datos de usuario deben validarse con Zod
- Sin TypeScript any (usa unknown + type guard)
- Los errores deben registrarse con contexto
- Las funciones de más de 50 líneas deben dividirse
- Los comentarios TODO deben tener un ticket asociado

Codex aplica estos estándares a cada revisión, con una coherencia que ningún revisor humano mantiene a lo largo de trescientas solicitudes de extracción consecutivas.

Puntos clave

  • Codex realiza una revisión de primer pase para filtrar problemas obvios
  • Las revisiones pueden especializarse: seguridad, rendimiento, arquitectura
  • La integración con GitHub permite revisiones automáticas en cada PR
  • Usa la revisión antes de crear la PR para ahorrar tiempo
  • Documenta tus estándares en AGENTS.md para revisiones coherentes