Generador de Mensajes de Commit
Este archivo es la única fuente de verdad; cada agente (Claude / opencode / codex) lo referencia a través de su propio shim delgado.
Flujo
- Ejecuta
git diff --stagedpara ver los cambios preparados; si no hay cambios, muestra el mensaje «Primero hazgit add» y detente. - Según las reglas a continuación, genera un mensaje, muéstralo al usuario para confirmación; no lo confirmes directamente. Si el usuario necesita elegir, ofrécele directamente opciones de mensajes, no solo preguntes.
- Solo cuando el usuario confirme (por ejemplo, respondiendo «confirmar» u «ok») ejecuta
git commit -m. A menos que el usuario lo solicite explícitamente, no hagasgit push.
Reglas
Lee git diff --staged y genera un mensaje siguiendo Conventional Commits, explicando claramente el QUÉ y el PORQUÉ.
- Título:
type(scope): descripción, longitud total ≤ 74 caracteres, sin punto final, sin prefijos, comillas o bloques de código. - type: Elige el más acertado:
featNueva funcionalidad ·fixCorrección de erroresrefactorRefactorización que no cambia el comportamiento externo (ni nueva funcionalidad ni corrección) ·perfOptimización de rendimientodocsSolo documentación ·styleAjustes de formato que no afectan la semántica (espacios en blanco/formato/punto y coma, etc.)testAñadir o corregir pruebas ·buildCambios en el sistema de construcción o dependencias externas ·ciConfiguración y scripts de CIchoreOtros cambios misceláneos que no tocansrc/test·revertRevertir un commit anterior
- scope (opcional): Nombre del módulo afectado, según las convenciones de este repositorio. Para monorepos, usa el nombre del directorio de la app/package; si abarca varios o no estás seguro, omítelo.
- La descripción debe estar en chino: Una frase verbo-objeto que explique claramente «qué se hizo». No escribas frases vacías como «se modificaron varios archivos», «este commit», «esta modificación». Los identificadores (nombres de funciones/archivos/paquetes) deben mantenerse en inglés.
- Solo una línea: En cualquier caso, el mensaje de commit tendrá solo una línea de título; no escribas cuerpo ni footer. Si es necesario, incluye el PORQUÉ en esa misma línea.
- Breaking change: Usa
type(scope)!: descripcióncon!, manteniendo una sola línea, no uses el footerBREAKING CHANGE. - Puntuación: Usa puntuación en inglés de ancho medio, no en ancho completo como
,。:().
Estrategia de Generación
Antes de escribir, piensa bien «¿qué problema resuelve este conjunto de cambios? / ¿cuál es la línea principal?» y luego escribe según el formato anterior:
- Céntrate en la línea principal: Escribe solo la información necesaria para entender este commit; no enumeres nombres de archivo/función/configuración (a menos que sea clave).
- Escanea cambios significativos: ¿Hay cambios en lógica, contratos, construcción, puertas de calidad o comportamiento visible para el usuario? Según esto, elige el tipo correcto y decide si usar
!para marcar un breaking change.
Disciplina de Contenido (De dónde viene el QUÉ)
Lo anterior es sobre formato; lo siguiente trata sobre veracidad del contenido: El mensaje solo debe contener hechos de código confirmados, no adivinar intenciones ni basarse en documentación para suponer:
- Basarse principalmente en cambios de comportamiento en
src/test: Los docs solo sirven como contexto auxiliar; no uses los docs para inferir el QUÉ (la documentación suele estar por delante o por detrás del código). - El contexto conversacional es mejor que los documentos: Los objetivos declarados explícitamente en el prompt reciente del usuario pueden usarse para determinar el PORQUÉ y elegir una redacción más precisa (por ejemplo, «corregir la verificación completa/typecheck»); pero el QUÉ y el scope todavía se basan en el diff preparado. Lo que el contexto menciona pero el diff no refleja no debe escribirse en el mensaje; si hay conflicto, el diff es la autoridad y se debe pedir confirmación.
- Diffs de eliminación/renombrado: Si no se puede confirmar el propósito a partir de las relaciones de llamada del código, solo declara objetivamente (
Eliminar X/Renombrar X a Y), no uses relaciones causales fuertes como «reemplazar / migrar a / cambiar a». - Múltiples cambios con un mismo objetivo (por ejemplo, una corrección de calidad/construcción del código): Da directamente un mensaje resumido. La división solo se ofrece como sugerencia opcional adjunta si mejora significativamente la revisión/reversión; no es un bloqueo por defecto.
- Múltiples objetivos independientes claramente mezclados (funcionalidades/correcciones separadas): Ofrece todo de una vez: los mensajes divididos por unidad + un mensaje resumido conservador, para que el usuario elija entre dividir o resumir. No dejes el resumen para la siguiente ronda. Solo si no se puede resumir objetivamente el QUÉ global, enumera solo las unidades.
- Cambios de origen dudoso o intención no clara (mezcla paralela, no se sabe por qué se modificaron): Emite «Estos archivos necesitan confirmación de origen/intención» en lugar de forzar un mensaje. Cuando no estés seguro, evita palabras vagas como «ordenar / ajustar» y prioriza pedir confirmación al usuario o dividir.