Una herramienta de validación especializada para archivos .pre-commit-config.yaml que aplica 23 reglas distintas en estructura, hooks y mejores prácticas.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install pre-commit-config-validator
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <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 pre-commit-config-validator 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 Pre-Commit Config Validator?
El Pre-Commit Config Validator es una herramienta de nivel profesional diseñada para verificar la integridad y el cumplimiento de los archivos .pre-commit-config.yaml. Actúa como un guardián para sus Git hooks, asegurando que cada entrada del repositorio, definición de hook y script local esté configurado correctamente antes de entrar en producción. Al utilizar esta skill de la biblioteca Openclaw Skills, los desarrolladores pueden evitar pipelines de CI rotos y mantener un entorno estandarizado para el desarrollo local.
Más allá de la verificación de sintaxis básica, este validador implementa una inspección profunda de los esquemas de hooks, incluyendo la validación de valores de staging, entornos de lenguaje y fijación de versiones (pinning). Es una utilidad esencial para los equipos que buscan un mantenimiento de base de código de alta calidad y una gobernanza automatizada de su ciclo de vida de desarrollo a través de Openclaw Skills.
Casos de uso de Pre-Commit Config Validator
- Validación automatizada de archivos .pre-commit-config.yaml dentro de pipelines de CI/CD para evitar despliegues de configuraciones erróneas.
- Auditoría de grandes monorepos para asegurar IDs de hooks y versiones de repositorios consistentes.
- Solución de problemas de definiciones de hooks locales para entradas faltantes o entornos de lenguaje no soportados.
- Migración de configuraciones de pre-commit heredadas para seguir las mejores prácticas y estándares de seguridad modernos.
Cómo funciona Pre-Commit Config Validator
- El usuario proporciona uno o más archivos de configuración YAML como entrada para el script de validación.
- El validador analiza la sintaxis YAML para asegurar la integridad básica del archivo y el cumplimiento estructural.
- Aplica sistemáticamente 23 reglas predefinidas divididas en categorías como Estructura, Entradas de Repositorio y Definiciones de Hooks.
- La herramienta evalúa las revisiones del repositorio, asegurando que se identifiquen las ramas flotantes y se recomienden patrones semver.
- Se genera un informe completo en el formato solicitado (texto, JSON o resumen), proporcionando diagnósticos procesables para cualquier problema identificado.
Configuración de Pre-Commit Config Validator
Para comenzar a usar esta skill de Openclaw Skills, asegúrese de tener Python 3 instalado y el script validador disponible en su ruta local. Use los siguientes comandos para validar su configuración:
# Standard validation of the local config
python3 scripts/precommit_validator.py validate .pre-commit-config.yaml
# Run only best practices linting
python3 scripts/precommit_validator.py lint .pre-commit-config.yaml
# Use strict mode to fail on warnings
python3 scripts/precommit_validator.py validate .pre-commit-config.yaml --strict
Esquema de datos y taxonomía de Pre-Commit Config Validator
El validador organiza sus hallazgos en cinco categorías de reglas distintas, proporcionando una taxonomía clara para los diagnósticos:
| Categoría | Recuento de Reglas | Área de Enfoque |
|---|---|---|
| Estructura (S) | 5 | Sintaxis YAML, keys de nivel superior y keys raíz requeridas. |
| Repositorio (R) | 6 | URLs de repositorios, pinning de rev (SHA/tag) e integridad de la lista de hooks. |
| Hooks (H) | 6 | IDs de hooks, etapas válidas, listas de argumentos y dependencias adicionales. |
| Local (L) | 3 | Requisitos para tipos de repositorios locales, incluyendo entry points y lenguajes. |
| Mejores Prácticas (B) | 4 | URLs duplicadas, uso de meta-hooks y coincidencia de patrones semver. |
Funciones avanzadas de Pre-Commit Config Validator
- Soporte para múltiples archivos: Valide varios archivos de configuración en una sola ejecución de comando para estructuras de proyectos complejos.
- Salida legible por máquina: Genere arrays de diagnóstico JSON para integrar resultados con herramientas de monitoreo de terceros o tableros personalizados.
- Filtrado basado en reglas: Apunte a dominios de validación específicos, como metadatos de repositorios o definiciones de hooks, de forma independiente.
- Aplicación estricta: Configure códigos de salida para tratar las advertencias como errores, asegurando que su flujo de trabajo de Openclaw Skills cumpla con los más altos estándares.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Codebase Migration Planner
Una herramienta estratégica para planificar, estimar y realizar un seguimiento de migraciones de código base a gran escala, desde actualizaciones de framework hasta transiciones de lenguaje.
API Changelog Generator
Una potente utilidad para comparar especificaciones OpenAPI y generar registros de cambios y guías de migración listos para el consumidor.
Ollama Task Orchestrator
Un motor de ejecución remota para gestionar colas de tareas de Ollama y generación de código automatizada a través de SSH.
Dockerignore Linter
Una herramienta de auditoría integral diseñada para validar archivos .dockerignore en busca de errores de sintaxis, fugas de seguridad e hinchazón del contexto de construcción.
ArgoCD Deployment Analyzer
Una herramienta de diagnóstico integral para identificar el drift de sincronización, diagnosticar fallos de implementación y auditar la seguridad de las aplicaciones gestionadas por ArgoCD.
DevContainer Validator
Un validador CLI basado en Python para archivos devcontainer.json que comprueba errores estructurales, riesgos de seguridad y mejores prácticas de configuración.
Presentado*
