- Inicio
- Plantillas
- PR de Next.js: tres revisiones, tus pruebas y una comprobación de publicación en la CI
PR de Next.js: tres revisiones, tus pruebas y una comprobación de publicación en la CI
Última actualización
Un cambio de Next.js revisado por Parallel Review en corrección, seguridad y cobertura de pruebas, probado con tus propias pruebas y comprobado de nuevo desde la CI antes de fusionar.
Un route handler que acepta datos del navegador merece más de un par de ojos. Esta plantilla ejecuta tres revisiones específicas sobre un cambio de Next.js, ejecuta tus propias pruebas sobre el código que se escribió y deja que tu CI vuelva a hacer la misma pregunta antes de fusionar.
Qué agentes se ejecutan
| Paso | Agente |
|---|---|
| Correctness review | Reviewer |
| Security review | Security Auditor |
| Test coverage review | Tester |
| Merge findings | Architect |
El Architect fusiona las tres revisiones en una sola lista. Después, la pasada de código escribe el cambio, y el paso verify ejecuta el script de pruebas de tu package.json, con el gestor de paquetes que indica tu lockfile, en un sandbox sin conexión. La salida de Vitest y de Jest se desglosa en totales.
Controles que se aplican
- Hallazgos. Una revisión de hallazgos lee el diff real, con las tres revisiones como contexto. Los hallazgos abiertos de gravedad alta o crítica bloquean el pull request hasta que se pasan por triaje.
- Pruebas sobre esta versión. Las pruebas fallidas bloquean. Editar el cambio después de ejecutarse sus pruebas lo marca como no probado.
- Aprobación. La persona que empezó la sesión no puede emitir el voto de aprobación mientras otra persona del espacio de trabajo pueda aprobar.
Vuelve a comprobarlo desde la CI
La consola abre el pull request en una rama llamada codeops/run-<id>. En GitHub Actions, añade un paso al workflow que se ejecuta en los pull requests, con una clave de API del espacio de trabajo guardada como secreto:
- name: AI CodeOps release check
if: startsWith(github.head_ref, 'codeops/run-')
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $AICODEOPS_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\",\"blockOnInFlight\":true}" \
| jq -e '.allowed == true'
El endpoint responde 200 tanto si el cambio está permitido como si no, así que el paso lee allowed. blockOnInFlight deniega mientras alguna sesión detrás del pull request siga en ejecución. Usa el host en el que abres la consola. Todos los campos están en la página de la API.
Siguiente paso
Cuando esto se supere y se fusione, la plantilla de despliegue controlado en staging cubre el camino hasta producción. Para el código que ningún pull request toca, programa una inspección semanal del código base.
Preguntas frecuentes
¿Las tres revisiones se ejecutan a la vez?
No. Se ejecutan una tras otra, y cada una lee lo que escribieron las anteriores. Parallel describe cómo se reparte el trabajo.
¿El paso de CI denegará los pull requests escritos a mano?
Sí, un pull request sin ninguna sesión detrás recibe No workflow runs found. Por eso el paso solo se ejecuta en las ramas codeops/run-.
Relacionado
- Revisión de código con IA que bloquea las malas fusiones
- Revisiones multiagente
- La API
- App de Next.js: despliegue controlado en staging y después producción
- Plantilla de descripción de pull request para cambios escritos por IA
- Plantilla de postmortem de incidente para un cambio escrito por IA
- Todas las plantillas