Escritor de Mensajes de Commit

El Problema

Escribir buenos mensajes de commit es tedioso, y bajo presion los desarrolladores recurren a “fix stuff” o “update code.” Mensajes de commit pobres hacen que el historial de git sea inutil para debugging, code reviews e incorporacion de nuevos miembros. El formato Conventional Commits agrega estructura pero requiere recordar la sintaxis exacta cada vez.

El Prompt

Eres un experto en mensajes de commit siguiendo la especificacion Conventional Commits.

Analiza el siguiente diff y genera un mensaje de commit:

DIFF:
[pega tu git diff aqui]

Reglas:
1. Usa el formato: type(scope): descripcion
2. Types: feat, fix, refactor, docs, style, test, chore, perf, ci, build
3. Scope: el modulo, componente o area de archivos afectada
4. Descripcion: modo imperativo, minusculas, sin punto final, menos de 72 caracteres
5. Agrega un body (separado por linea en blanco) si el cambio necesita explicacion
6. Agrega un footer BREAKING CHANGE si aplica

Proporciona:
- **Mensaje de commit**: El mensaje completo listo para pegar
- **Razonamiento del type**: Por que elegiste este type
- **Alternativa**: Un mensaje alternativo si el cambio es ambiguo

Ejemplo de Salida

Mensaje de commit:
fix(auth): prevenir race condition de refresh de token en requests concurrentes

Cuando multiples llamadas API se disparan simultaneamente tras la expiracion
del token, solo la primera solicitud de refresh procede. Las llamadas
subsecuentes esperan y reusan el token renovado.

Razonamiento del type: Es un "fix" porque resuelve un bug donde los usuarios
eran desconectados intermitentemente debido a llamadas duplicadas de refresh
token que se invalidaban mutuamente.

Alternativa:
refactor(auth): serializar requests concurrentes de refresh de token

Cuando Usar

Usa este skill despues de preparar tus cambios en staging y antes de hacer commit. Funciona mejor cuando pegas el diff real en lugar de describir los cambios de memoria. Especialmente util para commits grandes que tocan multiples archivos donde resumir la intencion es dificil.

Tips Pro

• Canaliza tu diff directamente — ejecuta git diff --staged y pega la salida completa para el mensaje mas preciso.
• Divide diffs grandes en commits logicos — si la IA sugiere dos types diferentes (ej. feat + fix), es una senal para separar en commits independientes.
• Incluye el numero de ticket — agrega “Ticket de referencia: JIRA-1234” a tu prompt y la IA lo agregara automaticamente en el footer.