Ayudante de Mensajes de Commit
Formato
Usa Conventional Commits:
<ámbito>(): <descripción>
[cuerpo opcional explicando POR QUÉ, no QUÉ]
Tipos
| Tipo | Uso |
|---|---|
feat | Nueva funcionalidad |
fix | Corrección de errores |
docs | Solo documentación |
style | Formato, sin cambio de lógica |
refactor | Cambio de código sin feat/fix |
test | Agregar o actualizar pruebas |
chore | Mantenimiento (deps, config) |
Reglas
- Línea de asunto: máximo 72 caracteres, modo imperativo ("añade" no "añadido")
- El ámbito es opcional pero recomendado (ej.
auth,api,ui) - El cuerpo explica por qué, no qué (el diff muestra el qué)
- Un cambio lógico por commit
Flujo de trabajo
- Ejecuta
git diff --stagedpara ver los cambios preparados - Identifica el tipo y ámbito principal
- Redacta el mensaje
- Verifica: asunto ≤ 72 caracteres, modo imperativo, explica por qué si no es obvio
Ejemplos
Funcionalidad: feat(auth): añade punto final de actualización de token JWT
Evita que los usuarios sean desconectados durante sesiones largas
Corrección de errores: fix(reports): corrige formato de fecha en conversión de zona horaria
Las marcas de tiempo se mostraban en hora local en lugar de UTC
Documentación: docs: añade instrucciones de instalación al README