Git Commit Guard para Openclaw

Una habilidad de flujo de trabajo git-first protectora para agentes de IA que garantiza la integridad del repositorio a través de una inspección rigurosa previa al trabajo, validación en varias etapas y commits estructurados.

ontheway23333
v1.0.0
Mar 19, 2026
0
801
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install git-commit-guard

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar git-commit-guard usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Git Commit Guard?

Git Commit Guard es una extensión especializada dentro del ecosistema de Openclaw Skills diseñada para imponer una metodología disciplinada y git-first para los agentes de codificación de IA. Evita el error común de que los agentes de IA sobrescriban el trabajo no guardado o contaminen los repositorios con cambios no verificados. Al priorizar la salud del worktree, la habilidad garantiza que cada tarea de codificación, desde la depuración hasta la implementación de funciones, comience con una comprensión clara del estado actual del repositorio.

Esta habilidad es particularmente valiosa para los desarrolladores que trabajan en entornos multilingües o para aquellos que prefieren historiales de versiones con un alto contexto. Obliga a los agentes a inspeccionar dirty worktrees, inferir los comandos de validación correctos del entorno local y documentar todos los cambios utilizando mensajes de commit detallados en chino. Este enfoque mantiene un historial de proyecto de alta calidad y auditable, al tiempo que minimiza el riesgo de regresión o pérdida de código.

Casos de uso de Git Commit Guard

  • Gestión de dirty worktrees inspeccionando los cambios existentes antes de que un agente de IA comience nuevas tareas de desarrollo.
  • Aplicación de estándares rigurosos de pruebas y linting antes de que cualquier código sea confirmado en el repositorio.
  • Estandarización del historial del proyecto con mensajes de commit en chino de gran detalle que expliquen el 'porqué' detrás de la implementación.
  • Protección del trabajo existente del usuario al evitar comandos de git destructivos o sobrescrituras silenciosas.
  • Proporción de una entrega limpia al final de una sesión de IA con un estado totalmente validado y confirmado.

Cómo funciona Git Commit Guard

  1. El agente ejecuta git status al comienzo del turno para determinar si el repositorio está limpio o sucio.
  2. Si está sucio, el agente realiza un análisis profundo utilizando git diff y lectura de archivos para resumir los cambios e intenciones existentes.
  3. La habilidad identifica suites de pruebas, linters o herramientas de construcción existentes dentro del repositorio para establecer una línea base de validación.
  4. Antes de que comience el nuevo trabajo, los cambios intencionales existentes se confirman para garantizar una base limpia para la siguiente fase lógica.
  5. Durante el desarrollo, los cambios se aíslan y validan utilizando un estándar de verificación escalonado (primero pruebas dirigidas, luego revisiones más amplias).
  6. Al finalizar, se realiza una última pasada de validación y se genera un commit completo siguiendo la política de commits en chino.

Configuración de Git Commit Guard

Para integrar este flujo de trabajo en su entorno de agente de IA utilizando Openclaw Skills, asegúrese de que su repositorio local esté inicializado y su configuración apunte a las plantillas de commit estándar.

# Asegúrese de estar en un repositorio git
git init

# La habilidad hará referencia automáticamente a su plantilla si se encuentra en:
# references/commit-template.md

# Verifique el estado para ver la habilidad en acción
git status --short --branch

Esquema de datos y taxonomía de Git Commit Guard

La habilidad organiza sus operaciones en torno a los metadatos estándar de Git y una estructura de plantilla específica para la documentación:

Tipo de dato Fuente/Ubicación Propósito
Worktree State git status Determina la lógica de inicialización (limpio vs sucio).
Diff Logs git diff --stat Se utiliza para resumir la intención y el impacto de los cambios.
Commit Template references/commit-template.md Proporciona el plano estructural para los mensajes de commit en chino.
Validation Output CLI local (npm, pytest, etc.) Registra el éxito/fallo de los pasos de verificación antes de confirmar.
Commit History .git/logs Almacena los hashes auditables finales y las descripciones detalladas en chino.

Funciones avanzadas de Git Commit Guard

  • Validación en varias etapas: Escala automáticamente de pruebas unitarias dirigidas a pruebas de humo de sistema completo según el alcance del cambio.
  • Preservación auditable de cambios del usuario: Identifica y confirma explícitamente los cambios de usuario preexistentes antes de la intervención de la IA para mantener un rastro de auditoría claro.
  • Inferencia de verificación inteligente: Detecta dinámicamente si se debe usar linting, type-checking o compilación según el contenido del repositorio.
  • Localización al chino: Impone una política estricta de commits en idioma chino para equipos que requieren documentación estandarizada en ese idioma.
  • Informe de riesgo residual: Resume exactamente qué fue y qué no fue probado en la respuesta del turno final para una mejor supervisión del desarrollador.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*