Por qué está escrito así
Al redactar la descripción de un PR, la mayoría de la gente solo describe qué cambió. Sin embargo, la lista de archivos y el diff ya están a la vista. Lo que el revisor realmente no puede deducir es por qué se eligió esa solución concreta; sin esa explicación, la revisión suele empezar con un "¿por qué hiciste esto así?" y se pierde un día entero.
Definir el rol como "un desarrollador que ahorra tiempo al revisor" sirve para controlar la extensión. Sin esto, la IA genera un párrafo por cada archivo modificado, algo que nadie lee por completo. La línea de contexto que indica que "no conoce el contexto y lo ve por primera vez" elimina la jerga interna y las omisiones.
Los cinco subtítulos del formato son la columna vertebral de este prompt. En especial, "Puntos clave para el revisor" y "Fuera de alcance en este PR" son fundamentales. El primero enfoca la revisión y el segundo previene preguntas repetitivas como "¿por qué no arreglaste esto otro?". Por esta misma razón se limita la cantidad de líneas en cada sección.
La instrucción de no inventar datos es crucial al generar descripciones de PR con IA. Los modelos suelen añadir datos verosímiles pero falsos sobre rendimiento o números de issues, y el revisor los tomará como ciertos. En cambio, habilitar la sección "Dudas pendientes para el autor" canaliza cualquier incertidumbre sin inventar.
Solicitar el método de prueba como variable al inicio responde a la típica pregunta del revisor: "¿has probado esto?". Indicar claramente cómo se verificó permite al revisor replicar los pasos o señalar posibles casos no cubiertos.
¿Términos desconocidos? Consulta Aha AI: role-prompting, context-window
Comparado con un mal ejemplo
Escribe una descripción de PR para esto
(Pegar lista de archivos modificados)
Generará una simple lista que parafrasea los nombres de archivo. Leerlo aporta lo mismo que mirar el diff y, al no haber contexto, el revisor acabará preguntando por chat. Al no señalar dónde concentrar la atención, la revisión puede limitarse a corregir erratas o a una aprobación rápida sin análisis real.
Variaciones
Para correcciones urgentes (hotfix)
Escribe una descripción breve para un Pull Request a partir de las notas siguientes. Incluye únicamente y en este orden: un resumen de una frase, el motivo de la urgencia en dos líneas, el método de prueba y cómo revertir el cambio (rollback). No agregues nada más. El método de prueba es: {{método de prueba}}
""" {{contenido del trabajo}} """
Ideal para incidencias donde urge desplegar y documentar después. Incluir "cómo revertir el cambio" es lo más importante en despliegues críticos.
Cuando tienes dudas para el revisor
Identifica en el siguiente contenido las decisiones técnicas sobre las que no estoy seguro y conviértelas en 3 preguntas concretas para el revisor. Para cada pregunta, añade una línea con la alternativa considerada y el motivo por el que elegí la opción actual. No decidas la respuesta por mí.
""" {{contenido del trabajo}} """
Útil cuando se abre un PR con dudas de arquitectura o diseño. Plantear las preguntas en la descripción orienta la revisión directamente a resolverlas.
Prompts relacionados
Última actualización 2026-09-02 · ¿Has visto un error? Avísanos