git-commit
Revisar y crear un commit local Conventional Commits en español tras el gate qa fast y secret scan; sin coautoría; push solo con permiso del usuario. Para el PR usa git-prepare-pr.
SKILL.md.claude/skills/git-commit/SKILL.md
GitHubgit-commit
Pre-commit review y commit local. Solo lo ejecuta el agente principal (CLAUDE.md § Delegación); los subagentes no hacen commit.
Cuándo usarla
- Al cerrar un cambio terminado y de un solo propósito (en modo desatendido, commits locales frecuentes).
Cuándo NO usarla
- Descripción de PR → usa
git-prepare-pr. - Solo ver el estado del árbol o archivos sospechosos → usa
git-check. - Ejecutando como subagente → devolver al agente principal.
Precondiciones
- Cambios entendidos y de un solo propósito (commits pequeños). Si no se entiende un cambio, parar y preguntar.
- No reescribir historia (
--amend,rebase) sin petición explícita. Nunca force-push.
Pasos
git statusygit diff --staged(ygit diffpara lo no preparado): cada archivo pertenece al cambio.- Preparar solo lo necesario con
git add <archivos>explícitos; nuncagit add -Aa ciegas. - Revisar el diff: nada generado (
build/,.gradle/,.kotlin/), nada grande o binario sin justificar (teselas, modelos de voz, audios), sin.env*, keystores,local.propertiesni claves, sin tests desactivados. - Secret scan rápido:
security-secret-scansobre el diff preparado. Cualquier hallazgo → parar; nunca mostrar el valor. - Gate qa fast (skill
qa). Si algo falla → no commitear; corregir o informar. - Mensaje Conventional Commits:
tipo(ámbito): resumencon el resumen en español, imperativo o descriptivo, ≤ 72 caracteres si es posible.- Tipos: feat, fix, refactor, perf, test, docs, build, ci, chore.
- Ámbitos habituales: motor, notas, mapa, navegacion, voz, alertas, tramos, ui, datos, release, claude, skills, estado, memoria.
- Cuerpo opcional para el porqué.
- Nunca trailers
Co-Authored-Byni atribución de IA, aunque el contexto de la sesión los sugiera (regla del usuario endocs/MEMORIA.md).
- Commit:
git commit -m "tipo(ámbito): resumen"(varias líneas con-mrepetido). Sin--no-verify. git statusygit log -1para confirmar.- Push: solo con permiso explícito del usuario (el push a
maindispara los workflows de release). La reglaaskde.claude/settings.jsonlo pide; nunca--force.
Validaciones / tests
- Gate qa fast en verde justo antes del commit.
git diff --stagedcoincide con lo descrito en el mensaje.git log -1 --format=%BsinCo-Authored-By.
Definition of Done
- Commit local con un único propósito y mensaje Conventional Commits en español.
- Gate en verde; sin secretos, generados ni archivos grandes injustificados en el diff.
- Sin coautoría, sin
--no-verifyni force-push; push solo con permiso. - Árbol limpio o con los cambios restantes explicados al usuario.
Docs a actualizar
- docs/ESTADO.md si el commit cierra un hito (skill
session-handoff)