Revisar automáticamente cada propuesta de cambios en GitHub

A quién le sirve. Equipos pequeños de desarrollo que quieren una primera revisión automática de cada propuesta de cambios antes de que la mire una persona.

Qué hicieron

Un nodo GitHub Trigger de n8n (un bloque que se activa con un evento) se dispara cuando se abre una propuesta de cambios (pull request). Un nodo de solicitud HTTP consulta la API de GitHub para obtener los archivos de la propuesta, y un nodo de código une el nombre y las diferencias de cada archivo en un mensaje que presenta al modelo como un desarrollador iOS sénior. El agente funciona con un modelo de chat de OpenAI y lee, como herramienta, una hoja de Google con las buenas prácticas de Swift del equipo. Después, nodos de GitHub publican el comentario y añaden la etiqueta ReviewedByAI.

Cómo salió

En una propuesta de prueba que añadía compatibilidad con la criptomoneda iota, el agente publicó un comentario y aplicó la etiqueta. Era un único comentario general, no comentarios línea a línea. Las revisiones solían ser demasiado largas y podían pasar por alto los problemas de fondo.

Conviene saber

Comprueba la salida de cada nodo según lo montas. Para comentar línea a línea habría que recorrer las diferencias de cada archivo con sus números de línea, algo que el autor deja como siguiente paso y no construyó.

Qué necesitas

• Una cuenta de n8n, una herramienta para encadenar pasos automáticos, en la nube o instalada por ti
• Un token de acceso a GitHub (una clave) con permiso sobre tu repositorio
• Una clave de API de un proveedor de IA, como OpenAI
• Opcional: una hoja de Google con las buenas prácticas de tu equipo

Cómo hacerlo tú, paso a paso

1. Prepara las credenciales: el token de GitHub y la clave de API del proveedor de IA. Guárdalas en n8n.
2. Si quieres que el revisor conozca tus normas, escribe las buenas prácticas del equipo en una hoja de Google.
3. En n8n crea un flujo que se active cuando se abra una propuesta de cambios nueva en tu repositorio (un GitHub Trigger).
4. Añade una solicitud a la API de GitHub para obtener los archivos y las diferencias de esa propuesta.
5. Añade un bloque que una el nombre y las diferencias de cada archivo en un mensaje para el modelo, presentándolo como un desarrollador sénior de tu tecnología.
6. Conecta el agente de IA, con la hoja de buenas prácticas como herramienta, y añade pasos de GitHub que publiquen el comentario y una etiqueta como ReviewedByAI.
7. Prueba con una propuesta de prueba y comprueba la salida de cada bloque antes de activar el flujo.

Construye en n8n un flujo que se active cuando se abra una propuesta de cambios (pull request) nueva en mi repositorio de GitHub [propietario/repositorio]. Debe descargar las diferencias, pedir a un modelo de IA que las revise en busca de errores, legibilidad y pruebas que falten, y publicar la revisión como comentario y añadir una etiqueta como [nombres de etiquetas]. Habrás terminado cuando una propuesta de prueba reciba un comentario de revisión útil. Antes de publicar nada en GitHub, enséñame el comentario y la etiqueta y espera mi aprobación.

Consejos

• Comprueba la salida de cada bloque según lo montas, no solo al final.
• Las revisiones salen largas y pueden pasar por alto los problemas de fondo. Pide que se centren en lo serio y que sean breves.
• Empieza con un comentario general. Para comentar línea a línea hay que recorrer las diferencias de cada archivo con sus números de línea, algo que el autor dejó como siguiente paso.

Preguntas frecuentes

Fuentes

• @anirbanmukherjee1311 en Medium ↗
• rishabhrai02 en Medium ↗
• @lakhera2015 en DEV ↗

En el directorio desde el 3 de octubre de 2026.