skill-commit

Commits en Git — Buenas Prácticas

El objetivo de un buen commit es que cualquier persona del equipo (o tú mismo dentro de 6 meses) pueda entender qué se cambió y por qué con solo leer el historial de git. Un commit bien hecho facilita las revisiones de código, simplifica los reverts y hace que el proyecto sea más mantenible.

Estructura del mensaje de commit

Usa el formato de Conventional Commits adaptado al español:

<tipo>(<ámbito>): <descripción breve>

<cuerpo opcional>

<pie opcional>

Ejemplo 1:

feat(facturas): añadir campo de descuento por pronto pago

Se añade un nuevo campo en el modelo de factura que permite
aplicar un porcentaje de descuento cuando el cliente paga
antes de la fecha de vencimiento.

Ejemplo 2:

fix(informes): corregir cálculo de IVA en informe trimestral

El IVA se estaba calculando sobre el total con descuento en
lugar de sobre la base imponible. Ahora se aplica correctamente.

Ejemplo 3 (simple):

docs(readme): actualizar instrucciones de instalación

Código de tarea en el commit

Cuando el usuario proporcione un código de tarea (por ejemplo, un número de issue o tarea del roadmap como 4543, #1234, TASK-567, etc.), este código debe incluirse en el título del commit, justo después del tipo (y ámbito si lo hay), antes de la descripción. Solo se incluye el código numérico o identificador, sin enlaces ni texto adicional.

Formato con código de tarea:

<tipo>: <código> <descripción breve>

Formato con código de tarea y ámbito:

<tipo>(<ámbito>): <código> <descripción breve>

Ejemplos con código de tarea:

feat: 4543 añadir filtro por fecha de pago en las listas de anticipos de clientes y proveedores

fix: 1287 corregir cálculo de IVA en informe trimestral

feat(facturas): 3201 añadir campo de descuento por pronto pago

Si el usuario no menciona ningún código de tarea, el commit se escribe sin él, siguiendo el formato estándar.