changelog-generatorConvierte un git log, lista de commits o notas de lanzamiento en un changelog pulido orientado al usuario. Usa cuando estés escribiendo notas de versión, generando una entrada en CHANGELOG.md o documentando qué cambió en una versión. Produce una sección de changelog estructurada con encabezado de versión, cambios categorizados y notas de migración. Para una…
Independent GitHub snapshot · Automated classification · Original documentation governs
Convierte commits raw de git, un resumen de diff o notas de lanzamiento de desarrolladores en una entrada de changelog pulida — categorizada, orientada al usuario y siguiendo las convenciones de Keep a Changelog.
Pregunta por estas si no se proporcionan:
git log --oneline, mensajes de commit raw o una descripción de qué cambió)Sigue el formato de Keep a Changelog:
[Solo incluir si hay cambios disruptivos]
Guía de skill — no incluyas la siguiente sección en el changelog entregado:
Lenguaje: Escribe para el lector, no para quien hizo commit. "Add dark mode support" no "implement ThemeProvider with dark palette variant".
Cambios disruptivos: Siempre destácalos primero con ⚠️. Incluye una ruta de migración.
Correcciones de bugs: Describe qué estaba roto, no qué fue cambiado. "Fix crash when user has no profile picture" no "null-check avatar URL before rendering".
Granularidad: Agrupa commits relacionados en una línea. No listes cada micro-commit por separado.
Tono: Voz activa, modo imperativo. "Add", "Fix", "Remove" — no "Added", "Fixed", "Removed".
Secciones vacías: Omite cualquier sección sin entradas. No incluyas bloques ### Fixed vacíos.
Este skill viene con archivos de soporte — úsalos cuando estén disponibles:
references/user-translation.md — Commit-to-Changelog Translation: Writing for the People Affected. Aplícalo mientras produces la salida; contiene la calibración y decisiones de criterio que el resumen del método anterior comprime.templates/release-entry.md — una versión rellenable del entregable con las puertas de calidad inline. Ofrécela cuando el usuario quiera trabajar el documento él mismo en lugar de tenerlo generado.Puntúa cualquier salida de este skill antes de entregarla; 32+ es calidad de envío.
| Dimensión | 0 | 5 | 10 |
|---|---|---|---|
| Traducción orientada al lector | Las entradas replantean mensajes de commit, con identificadores internos y detalles de implementación | Mayormente orientadas al usuario, pero algunas entradas filtran internals o describen el patch en lugar de qué estaba roto | Cada entrada describe el cambio desde la perspectiva del lector — qué cambió para ellos, nunca cómo fue refactorizado el código |
| Manejo de cambios disruptivos | Los cambios disruptivos están enterrados en medio de la lista o falta una ruta de migración | Señalados en la parte superior, pero la guía de migración es vaga ("actualiza tu código") | En la parte superior con ⚠️, cada uno con una acción de migración específica que el usuario puede ejecutar |
| Curación y agrupación | Cada micro-commit listado; commits solo para interno incluidos | Algo de agrupación, pero commits relacionados aún aparecen como entradas separadas o ruido se filtra | Commits relacionados agrupados en entradas únicas; commits solo para interno excluidos; nada que un usuario no pueda observar |
| Disciplina de formato | Encabezado de versión/fecha incorrecto o faltante; verbos en pasado; secciones vacías dejadas | Encabezado correcto pero errores en tiempo verbal o secciones vacías persisten | Convenciones de Keep a Changelog en toda la sección — encabezado correcto, modo imperativo, solo secciones pobladas |