HomeCasa Prompts

Changelog y notas de versión a partir de la lista de commits

Convierte una lista de commits o PR en un changelog con formato Keep a Changelog, propuesta de versión SemVer, cambios incompatibles con guía de migración y notas legibles para usuarios. Pensado para ChatGPT, Claude, Gemini y Microsoft Copilot. Incluye 5 variables personalizables y se copia gratis en un clic.

Principiante · Texto · Pendiente de revisión editorial

Pensado para:

Prompt

Actúa como responsable de releases que redacta changelogs precisos y notas de versión comprensibles.

Contexto:
- Producto o librería: {{producto}}
- Versión anterior y rango de cambios: {{rango}}
- Lista de commits o PR fusionados:
```
{{commits}}
```
- Público de las notas: {{publico}}
- Formato de salida: {{formato}}

Entregables:
1. Clasificación de cada commit en: Añadido, Cambiado, Obsoleto, Eliminado, Corregido, Seguridad. Descarta los cambios internos sin efecto para el usuario (chore, ci, formato) y lístalos aparte.
2. Propuesta de número de versión según SemVer (mayor, menor o parche) con la justificación.
3. Entrada del changelog en el formato indicado, con fecha [COMPLETAR: fecha de publicación] y enlaces a los PR cuando aparezcan.
4. Sección destacada de cambios incompatibles: qué deja de funcionar, a quién afecta y guía de migración paso a paso con ejemplo de código antes y después.
5. Versión para el público indicado: 3-6 novedades explicadas por su beneficio, en lenguaje sencillo si son usuarios finales.
6. Lista de commits ambiguos que necesitan confirmación.

Restricciones:
- No inventes funcionalidades ni detalles que no se deduzcan de los commits. Si un mensaje es poco claro, pregúntame o márcalo como [COMPLETAR].
- Redacta cada línea desde el punto de vista de quien usa el producto, no del código interno.
- Si falta la versión anterior o el público, pregúntame antes.

Formato: Markdown listo para pegar en CHANGELOG.md o en la página de la release.

Cómo usarlo

Obtén la lista con git log v1.4.0..HEAD --oneline o desde los PR fusionados desde la última release. Revisa la propuesta de versión y la sección de cambios incompatibles antes de publicar.

Ejemplo de uso

Producto: librería JavaScript de validación de formularios · Rango: v2.3.1 hasta main · Público: desarrolladores · Formato: Keep a Changelog.

Resultado de ejemplo

Suponiendo un git log con, entre otros, un endpoint de notas de crédito, una corrección de redondeo del IVA y el renombrado de customer_id…

2. Versión propuesta

2.0.0 (major): el renombrado de un campo de la respuesta rompe a los clientes existentes, aunque el resto de cambios serían minor y patch.

3. Entrada de CHANGELOG

[2.0.0] – [COMPLETAR: fecha de publicación]

Added

  • Endpoint POST /credit-notes para emitir notas de crédito sobre una factura existente (#212).

Changed

  • BREAKING: el campo customer_id pasa a llamarse client_id en todas las respuestas (#219).

Fixed

  • El total con IVA ya no difiere en un céntimo del sumatorio de líneas en facturas con muchas líneas (#215).

4. Cambios incompatibles y migración

Afecta a: cualquier integración que lea customer_id.

Antes: const id = invoice.customer_id;

Después: const id = invoice.client_id;

6. Commits ambiguos

  • a3f9c1e wip validation — ¿cambia qué datos acepta la API? [COMPLETAR]
  • 7be20d4 update deps — ¿alguna actualización de seguridad que deba ir en Security?

Los cambios internos (chore, ci, formato) se han dejado fuera de las notas…

Datos clave

Categoría
Programación y desarrollo · Documentación
Tipo de resultado
Texto
Nivel
Principiante
Pensado para
ChatGPT, Claude, Gemini y Microsoft Copilot
Verificado en
Pendiente de verificación editorial
Variables
Producto o librería, Versión anterior y rango, Commits o PR, Público y Formato
Idioma
Español
Precio
Gratis, sin registro
Actualizado
07/11/2026

Preguntas frecuentes

¿Cuándo subo la versión mayor?

Según SemVer, cuando un cambio rompe la compatibilidad con la API pública. Las funcionalidades nuevas compatibles suben la menor y las correcciones, el parche.

¿Qué diferencia hay entre changelog y notas de versión?

El changelog es un registro técnico y completo de cambios. Las notas de versión seleccionan lo más relevante y lo explican por su beneficio para el público de esa release.

¿Para qué sirve este prompt?

Convierte una lista de commits o PR en un changelog con formato Keep a Changelog, propuesta de versión SemVer, cambios incompatibles con guía de migración y notas legibles para usuarios.

¿Con qué herramientas de IA funciona?

Está pensado para ChatGPT, Claude, Gemini y Microsoft Copilot. Todavía no lo hemos verificado en estas herramientas, por lo que los resultados pueden variar entre ellas.

¿Cómo personalizo el prompt?

Pulsa «Personalizar» y rellena las variables (Producto o librería, Versión anterior y rango, Commits o PR, Público y Formato). El texto se actualiza al instante y después puedes copiarlo con un clic. Los valores se guardan solo en tu navegador.

¿Necesito experiencia para usarlo?

No. Es un prompt de nivel principiante: basta con rellenar los datos y pegarlo en tu herramienta de IA.

¿Este prompt es gratis?

Sí. Todos los prompts de HomeCasa Prompts son gratuitos, sin registro ni suscripción. Puedes usarlos también en proyectos profesionales.

¿Puedo fiarme del resultado de la IA?

Úsalo como un borrador de calidad: revisa siempre datos, cifras y afirmaciones importantes antes de publicarlos o tomar decisiones.

Prompts relacionados