Conventional Commits Skill para OpenClaw

OpenClaw Conventional Commits Skill — Descripción General

El skill de Conventional Commits incorpora mensajes de commit estructurados y conformes a la especificación en tu flujo de trabajo con OpenClaw. En lugar de escribir mensajes de commit desde cero o intentar recordar la especificación de Conventional Commits, simplemente pide a tu agente OpenClaw que genere o valide mensajes basados en tus cambios preparados.

Conventional Commits es una convención ligera sobre los mensajes de commit que proporciona un historial claro y legible por máquinas. Impulsa changelogs automáticos, versionado semántico y herramientas de publicación en miles de proyectos open source y empresariales. Con este skill de OpenClaw, obtienes todos esos beneficios sin la carga cognitiva.

Flujo de trabajo típico:

1. Prepara tus cambios con git add.
2. Pide a OpenClaw que escriba un mensaje de commit.
3. El agente analiza el diff, determina el tipo correcto (feat, fix, docs, etc.) y propone un mensaje correctamente formateado — listo para confirmar.

Requisitos Previos para el Conventional Commits Skill

Antes de instalar el skill de Conventional Commits, asegúrate de tener:

• OpenClaw instalado y ejecutándose (v1.0+)
• Git instalado (v2.20+) — descarga oficial
• Un repositorio de proyecto inicializado con git init
• clawhub CLI instalado para gestión de skills

Verifica tu configuración:

# Verificar versión de OpenClaw
openclaw --version

# Verificar versión de Git
git --version

# Confirmar que estás dentro de un repositorio Git
git status

Cómo Instalar el Conventional Commits Skill

Instala el skill de Conventional Commits con un solo comando:

npx clawhub@latest install conventional-commits

Para verificar la instalación:

clawhub list

Deberías ver conventional-commits en la lista de skills instalados. El skill funciona inmediatamente — no se requieren claves API ni servicios externos.

Configuración del Conventional Commits Skill

Este skill requiere una configuración mínima. Lee tus cambios Git preparados y formatea los mensajes según la especificación Conventional Commits. Sin embargo, puedes personalizar su comportamiento para adaptarlo a las convenciones de tu equipo.

Tipos de Commit

El skill reconoce los tipos estándar de Conventional Commits:

| Tipo | Cuándo Usarlo | |------|--------------| | feat | Una nueva funcionalidad para el usuario | | fix | Una corrección de error | | docs | Cambios solo en documentación | | style | Formato, punto y coma faltantes (sin cambio lógico) | | refactor | Reestructuración de código sin funcionalidad ni corrección | | perf | Mejoras de rendimiento | | test | Añadir o actualizar pruebas | | chore | Proceso de build, actualizaciones de dependencias, herramientas | | ci | Cambios en configuración CI/CD |

Commits con Alcance

El skill soporta mensajes de commit con alcance para monorepos y proyectos grandes:

feat(auth): add OAuth2 login flow
fix(api): handle null response from payment endpoint
docs(readme): update installation instructions

Puedes definir alcances permitidos en la configuración de tu proyecto para mantener la consistencia entre colaboradores.

Ejemplos de Uso del Conventional Commits Skill

1. Generar un Mensaje de Commit desde Cambios Preparados

Tú: "Escribe un mensaje de commit para mis cambios preparados."

El agente inspecciona git diff --staged, identifica que añadiste un nuevo endpoint API y devuelve:

feat(api): add user profile endpoint

Implement GET /api/users/:id/profile with authentication
middleware and response caching.

Puedes aceptar, editar o pedir al agente que regenere con un tono o alcance diferente.

2. Validar un Mensaje de Commit Existente

Tú: "Comprueba si este mensaje de commit sigue la convención: 'Updated the login page'"

El agente analiza el mensaje y responde con retroalimentación específica:

• Falta el prefijo de tipo — debería comenzar con feat:, fix: u otro tipo válido
• Usa tiempo pasado ("Updated") — la convención recomienda modo imperativo ("update")
• Corrección sugerida: fix(auth): update login page layout

3. Validar Commits Recientes en Lote

Tú: "Valida los últimos 10 mensajes de commit en esta rama."

El agente revisa tu historial reciente y marca cualquier commit que no siga la convención, proporcionando alternativas corregidas para cada uno. Esto es útil antes de fusionar una rama de funcionalidad en main.

4. Generar un Commit de Cambio Disruptivo

Tú: "Confirma esto como un cambio disruptivo — eliminamos la API v1."

El agente formatea un commit de cambio disruptivo apropiado:

feat(api)!: remove deprecated v1 endpoints

BREAKING CHANGE: All /api/v1/* routes have been removed.
Consumers must migrate to /api/v2/* before upgrading.

Se incluyen tanto el sufijo ! como el footer BREAKING CHANGE, asegurando compatibilidad con herramientas como semantic-release y standard-version.

Seguridad y Mejores Prácticas

El skill de Conventional Commits es uno de los más seguros del ecosistema OpenClaw — opera puramente en formateo y validación de texto, sin llamadas API externas ni operaciones de escritura más allá de tu repositorio Git local.

Sigue estas directrices para la mejor experiencia:

• Revisa antes de confirmar. Siempre lee el mensaje generado antes de aceptarlo. El agente infiere la intención desde los diffs, pero tú conoces mejor el contexto.
• Usa alcances consistentes. Define una lista de alcances permitidos para tu proyecto y compártela con tu equipo para prevenir la dispersión de alcances.
• Combina con validación CI. Herramientas como commitlint pueden forzar Conventional Commits en tu pipeline CI, capturando cualquier commit manual que omita el skill.
• Habilita hooks pre-commit. Usa husky o lefthook para ejecutar la validación de mensajes de commit automáticamente.

Solución de Errores Comunes

"Not a git repository"

El skill requiere que estés dentro de un directorio inicializado con Git.

# Inicializar un nuevo repositorio
git init

# O navegar a tu proyecto existente
cd /path/to/your/project

"No staged changes found"

El skill necesita cambios preparados para generar un mensaje de commit significativo.

# Preparar archivos específicos
git add src/feature.ts

# O preparar todos los cambios
git add -A

"Unable to determine commit type"

Puede ocurrir cuando el diff es muy grande o toca muchos archivos no relacionados. Intenta preparar conjuntos de cambios más pequeños y enfocados, o especifica el tipo manualmente:

Tú: "Escribe un mensaje de commit de tipo refactor para estos cambios."