Generación Automatizada de Notas de Publicación de GitHub mediante Comparación con IA - Flujo de trabajo de n8n

• Equipos de Desarrollo de Software


• Ingenieros DevOps que buscan automatizar lanzamientos


• Redactores Técnicos que necesiten borradores de documentación automatizados


• Usuarios que implementen soluciones de flujo de trabajo personalizadas de n8n


• Cualquiera que busque generar changelogs precisos y categorizados rápidamente.

Este sofisticado flujo de trabajo de n8n resuelve el problema crucial, aunque a menudo manual, de compilar changelogs precisos tras un lanzamiento de software. Al aprovechar la API de GitHub e integrar modelos avanzados de lenguaje (a través del nodo de n8n de OpenRouter/LangChain), esta plantilla de n8n rastrea automáticamente las diferencias entre dos etiquetas Git publicadas. Cuando el activador de n8n detecta un nuevo evento de lanzamiento, el flujo de trabajo recupera eficientemente los commits detallados y los archivos modificados. Estos datos brutos se introducen en una serie de agentes de IA que categorizan los cambios en características, correcciones de errores y mejoras. El resultado final es una nota de publicación limpia, apta para SEO y formateada en Markdown, lista para su publicación inmediata, acelerando drásticamente el proceso de documentación para cualquier equipo de desarrollo que utilice n8n.

1. Activación del Flujo de Trabajo de n8n: La automatización comienza con el activador de n8n Github Trigger, configurado para escuchar específicamente los nuevos eventos de release (publicación) dentro del repositorio de GitHub especificado.


2. Identificación de Detalles de la Publicación: Una combinación de pasos de nodo de n8n de Código y Establecer (Fetch the latest release body y Set Repo & Owner) extrae el propietario del repositorio, el nombre y la etiqueta actual de la carga útil del webhook, estandarizando las variables para los nodos posteriores.


3. Obtención de las Etiquetas de Comparación: Un nodo de n8n de GitHub subsiguiente, Get the last two releases, recupera el historial de lanzamientos reciente. Luego, el nodo de n8n de Código Get the last two release tags ejecuta una lógica crítica para identificar correctamente la currentTag (etiqueta actual) y la previousTag (etiqueta anterior) necesarias para la comparación.


4. Ejecución del 'Diff' (Diferencias): Un nodo de n8n de HTTP Request llama al punto final vital de la API de Comparación de GitHub (usando la URL .../compare/{{previousTag}}...{{currentTag}}). Esta solicitud API recupera el 'diff' detallado completo, incluyendo mensajes de commit y parches de archivos.


5. Preprocesamiento de Datos: El nodo de n8n de Código Confirm diff procesa esta compleja carga útil de 'diff' en formato JSON. Simplifica los datos de commits y archivos, determina si se produjeron cambios reales (hasChanges) y crea una estructura JSON limpia optimizada para el consumo de la IA.


6. Resumen y Generación por IA: El 'diff' limpio se pasa a las etapas de IA:

1. Importar la Plantilla de n8n: Copia el JSON proporcionado e impórtalo en tu instancia de n8n usando la función 'Nuevo' -> 'Importar desde JSON'.


2. Configurar las Credenciales de GitHub: Debes configurar una credencial OAuth2 de GitHub. Esta credencial necesita acceso de lectura a las publicaciones de tu repositorio y debe vincularse al Github Trigger, al nodo de n8n de GitHub Get the last two releases y al nodo de solicitud HTTP de n8n Fetch release details from last two releases.


3. Configurar las Credenciales de OpenRouter: Configura una clave API de OpenRouter y vincúlala a las instancias de nodo de n8n OpenRouter Chat Model y OpenRouter Chat Model1, asegurando que la IA pueda procesar las solicitudes.


4. Configurar el Activador (Trigger): En el activador de n8n Github Trigger, especifica el Propietario del Repositorio y el Nombre del Repositorio correctos para el proyecto que deseas automatizar.


5. Activar y Probar: Guarda el flujo de trabajo de n8n, actívalo y provoca un nuevo lanzamiento en tu repositorio de GitHub de destino para probar la automatización de extremo a extremo.

Github Trigger (activador de n8n): Configura un webhook para iniciar el flujo de trabajo de n8n específicamente cuando se publica un nuevo evento de release en el repositorio de GitHub configurado.
Get the last two releases (nodo de n8n de GitHub): Ejecuta una operación release: getAll, limitada a las dos publicaciones más recientes, esencial para establecer la ventana de comparación.
Get the last two release tags (nodo de n8n de Código): Contiene lógica personalizada de JavaScript para extraer y validar de forma segura la currentTag y la previousTag a partir de las publicaciones obtenidas.
Fetch release details from last two releases (nodo de n8n de HTTP Request): Realiza la llamada crítica a la API del punto final Compare de GitHub, utilizando expresiones dinámicas para incluir el propietario, el repositorio y las dos etiquetas de comparación, recuperando el 'diff' completo del código.
Confirm diff (nodo de n8n de Código): Limpia y simplifica la gran carga útil del 'diff' de GitHub, reestructurando los datos de commits y cambios de archivos en un formato óptimamente consumible por el nodo subsiguiente de n8n de Agente LangChain de IA.
Summarize release differences (nodo de n8n de Agente LangChain): Utiliza un prompt potente y la conexión OpenRouter para analizar los datos estructurados del 'diff', agrupando los cambios técnicos en secciones de resumen fáciles de entender para el usuario (p. ej., Características, Correcciones de errores).

• Generate latest release notes (nodo de n8n de Agente LangChain): El nodo de IA final de n8n, responsable de generar las notas de publicación completas en Markdown, formateadas correctamente, utilizando el resumen categorizado y las etiquetas de versión específicas.