Cómo generar un mensaje de commit de Git

Qué puedes generar

Este generador prepara un mensaje de commit de Git a partir de unos pocos datos opcionales. Puedes indicar el tipo de cambio, el ámbito afectado, el texto principal y si el cambio rompe compatibilidad. Si dejas alguno de esos campos vacío, el generador puede completar parte del formato mediante sus opciones integradas. El resultado sirve como texto para revisar y adaptar antes de usarlo en el flujo de trabajo de un repositorio.

Pasos para crear el mensaje

Introduce un tipo de commit si quieres orientar la categoría del cambio. Cuando el tipo proporcionado es reconocido, se utiliza; si no lo indicas, se selecciona uno al azar entre las opciones integradas.
Escribe un ámbito no vacío para señalar la parte afectada, por ejemplo api o documentación. El ámbito aparece entre paréntesis. Si lo dejas vacío, se selecciona uno al azar entre las opciones integradas.
Añade el mensaje principal si ya tienes claro qué cambio quieres describir. Un texto no vacío se conserva como contenido del mensaje.
Activa la opción de cambio incompatible cuando el cambio requiera una advertencia de este tipo. Si está activada, se añade una línea en blanco y una notificación de cambio incompatible.
Genera el resultado y revisa el texto completo. Si no has escrito el mensaje principal, se elige una plantilla y términos de las listas integradas para construirlo. Además, el resultado incluye una línea en blanco y tres líneas con viñetas fijas.
Copia o adapta el mensaje según las convenciones de tu repositorio. El generador prepara el texto, pero no se ha verificado que ejecute comandos de Git, modifique un repositorio o cree el commit.

Cómo interpretar el resultado

El texto final combina los elementos seleccionados y los separa con el formato que aplica el generador. Un ámbito escrito por ti debe aparecer entre paréntesis; un ámbito vacío puede producir un valor elegido por el propio generador. Del mismo modo, un mensaje introducido por ti conserva ese texto, mientras que un campo vacío da lugar a una construcción basada en plantillas y términos integrados.

Comprueba especialmente dos zonas: la primera línea, que refleja el tipo, el ámbito y el mensaje, y el contenido posterior, donde pueden aparecer la notificación de cambio incompatible y las tres viñetas fijas. Si el resultado no describe con precisión el cambio, edítalo antes de incorporarlo a tu proceso. El generador no garantiza que el texto sea correcto, completo, conforme a una convención concreta o adecuado para un repositorio determinado.

Ejemplo práctico

Estás preparando un cambio de validación en la API y quieres conservar tu descripción, marcar el ámbito y añadir un aviso de incompatibilidad.

Deja vacío el tipo, escribe api como ámbito, introduce ajusta la validación como mensaje y activa la opción de cambio incompatible antes de generar el texto.

El resultado tiene una primera línea con un tipo seleccionado, el ámbito api entre paréntesis y el texto ajusta la validación; después incluye una línea en blanco y tres líneas con viñetas fijas. Como el aviso de cambio incompatible está activado, también aparece una línea en blanco seguida de esa notificación.

Limitaciones

La capacidad revisada genera texto de commit; no establece que la herramienta ejecute comandos de Git, edite un repositorio ni cree el commit, y tampoco garantiza que el resultado sea adecuado para una convención o repositorio concretos.

Errores frecuentes

Si esperabas que apareciera tu descripción pero dejaste vacío el campo del mensaje, se generará texto a partir de plantillas y términos integrados. Escribe un mensaje no vacío y vuelve a generar el resultado.

Preguntas frecuentes

¿Puedo proporcionar mi propio texto para el commit?

Sí, si introduces un mensaje no vacío, ese texto se utiliza como mensaje principal. Si el campo queda vacío, se construye un mensaje mediante una plantilla y términos de las listas integradas.

¿Cómo se indica que el cambio rompe compatibilidad?

Si activas la opción de cambio incompatible, se añade una línea en blanco y una notificación específica al texto generado.

¿Qué ocurre si no escribo un ámbito?

El ámbito no vacío se coloca entre paréntesis. Cuando no introduces un ámbito, el generador selecciona uno al azar entre sus opciones integradas.

¿Qué contenido adicional puede aparecer en el resultado?

El resultado contiene una línea en blanco seguida de tres líneas con viñetas fijas, además del mensaje principal y de cualquier notificación de cambio incompatible que corresponda.