- Inicio
- Plantillas
- Plantilla de descripción de pull request para cambios escritos por IA
Plantilla de descripción de pull request para cambios escritos por IA
Última actualización
Una plantilla de pull request para cambios que escribió un agente de IA: la tarea, la herramienta, qué se verificó y qué no, y dónde deberían mirar primero los revisores.
Guarda el bloque de abajo como
.github/pull_request_template.md(GitHub) o como archivo Markdown en.gitlab/merge_request_templates/(GitLab). Borra las secciones que tu equipo no use, y esta nota.
## What this changes
<!-- One or two sentences a reviewer can check the diff against. -->
## Why
<!-- The issue, ticket or decision this comes from. -->
Closes #
## How it was made
- [ ] Written by a person
- [ ] Written with an AI assistant (completion or chat)
- [ ] Written by a coding agent
Tool and model:
Task given to the tool (paste it, or link to it):
## What was verified
- [ ] Tests ran on this exact commit: <!-- link to the run -->
- [ ] New tests fail without this change
- [ ] No tests were deleted, skipped or loosened (or the reason is below)
- [ ] Checked by hand: <!-- what, and how -->
## What was NOT verified
<!-- Be specific. "Not run against production-sized data", "No browser test for Safari". Write "Nothing" only if that's true. -->
## Where to look first
<!-- The files or lines where a mistake would be expensive: money, auth, permissions, personal data, migrations. -->
## Out of scope
<!-- Anything the tool changed that the task didn't ask for, and why it stays. Empty is best. -->
## Risk and rollback
- Risk: low / medium / high, because
- Rollback: revert this commit / feature flag / other:
- Needs a migration or config change: yes / no
## Reviewer
- [ ] I read the task and the test results before the code
- [ ] I'm not the person who gave the tool its task
Cómo rellenarla
What this changes. Escríbelo para que un revisor pueda ponerlo al lado del diff. Si el resumen y el diff no coinciden, uno de los dos está mal, y conviene saberlo antes de leer nada más.
How it was made. Marca una casilla y nombra la herramienta y el modelo. Los revisores leen de otra forma el código escrito por agentes: el riesgo está menos en la sintaxis y más en el alcance, las suposiciones y las pruebas. Pega la tarea. Es la especificación real de lo que construyó el agente.
What was verified. Cada casilla marcada necesita una evidencia detrás, idealmente un enlace a la ejecución de pruebas de este commit. Una ejecución anterior al último push no cuenta. Si marcaste «New tests fail without this change», lo comprobaste revirtiendo la corrección y ejecutándolas.
What was NOT verified. Es la sección más útil y la que más a menudo se deja vacía. Los agentes describen su propio trabajo como completo. Una persona que rellena esta sección es el control sobre eso.
Where to look first. Señala los pocos sitios donde un error cuesta dinero o confianza de verdad. Un revisor con poco tiempo debería dedicarlo ahí.
Out of scope. Los agentes arreglan cosas que ven por el camino. Enuméralas aquí o, mejor, llévalas a su propio pull request.
Reviewer. Dos casillas para la persona que aprueba. La segunda existe porque la persona que escribió la tarea es, en la práctica, la autora del cambio.
Preguntas frecuentes
¿Dónde pongo esta plantilla de pull request?
En GitHub, guárdala como .github/pull_request_template.md. En GitLab, guárdala como archivo Markdown en .gitlab/merge_request_templates/ y elígela cuando abras el merge request.
¿Por qué preguntar qué no se verificó?
Porque un revisor no puede ver lo que no ocurrió. Una línea que dice que la migración no se ejecutó contra una copia de producción le dice exactamente dónde mirar, y al autor le cuesta diez segundos.
¿Debería rellenarla el propio agente de IA?
Puede redactarla, pero una persona la comprueba antes de pedir la revisión. La sección de verificación, en particular, es una afirmación, y las afirmaciones sobre pruebas necesitan detrás la ejecución de pruebas que las respalde.
Cómo citar
AI CodeOps (2026). Plantilla de descripción de pull request para cambios escritos por IA. https://aicodeops.dev/templates/ai-pr-description
Esta página y sus descargas tienen licencia CC BY 4.0: cópialas y adáptalas para tu equipo, y enlaza a esta página cuando publiques tu versión.
Relacionado
- Cómo revisar código escrito por un agente de IA
- Checklist para revisar código de IA: 25 comprobaciones para pull requests
- Aprobaciones y políticas
- Revisión de código con IA que bloquea las malas fusiones
- PR de Next.js: tres revisiones, tus pruebas y una comprobación de publicación en la CI
- Servicio en Python: control de SBOM y licencias
- Todas las plantillas