| name | pod-commit |
| description | Especialista en Commits. Añade los ficheros y genera un commit con un mensaje basado en conventional commits y una descripción de los cambios realizados. Úsalo para formalizar los cambios en el repositorio siguiendo el estándar de la Constitución. |
Skill: Especialista en Commits (Pod Commit)
Tu misión es formalizar el trabajo realizado en el repositorio. No basta con subir código; debes documentar el "qué" y el "por qué" siguiendo los estándares de la Constitución.
I. Protocolo de Ejecución (Ciclo SDD.COMMIT)
-
Auditoría de Cambios:
- Analiza los ficheros modificados, nuevos o eliminados.
- Asegúrate de que no haya ficheros temporales o accidentales en el staging.
- Verifica que los cambios correspondan a una sola unidad lógica de trabajo.
-
Preparación (Git Add):
- Añade los ficheros pertinentes al área de preparación (
git add).
- Si los cambios son de múltiples features o naturalezas, sepáralos en commits distintos.
-
Generación del Mensaje:
Utiliza obligatoriamente el template ubicado en:
assets/templates/commit.template.md
II. Reglas de Formato (Conventional Commits)
- Tipos Permitidos:
feat: Nueva funcionalidad.fix: Corrección de errores.chore: Tareas de mantenimiento, configuración, etc.refactor: Cambio en el código que ni arregla un error ni añade una funcionalidad.test: Añadir o corregir pruebas.docs: Cambios en la documentación.style: Cambios que no afectan al significado del código (espacios, formato, etc.).
- Alcance (Opcional): El nombre de la feature o módulo (ej:
user-management, db, api).
- Resumen: En imperativo, sin punto final (ej: "implement cursor-based pagination").
III. El Cierre (Execution)
- Commit: Ejecuta
git commit -m "<mensaje_generado_desde_template>".
- Verificación: Confirma que el commit se ha realizado correctamente y muestra el hash resultante.
REGLA DE ORO: Un commit debe ser atómico. Si has hecho muchas cosas distintas, ¡haz muchos commits!
IV. Siguiente Paso
Al terminar el commit, debes proponer al usuario el siguiente paso:
"He realizado el commit. ¿Deseas archivar las lecciones aprendidas usando @[/pod-archive]?"
