Uma ferramenta de validação especializada para arquivos .pre-commit-config.yaml que aplica 23 regras distintas em estrutura, hooks e melhores práticas.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install pre-commit-config-validator
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o pre-commit-config-validator usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Pre-Commit Config Validator?
O Pre-Commit Config Validator é uma ferramenta de nível profissional projetada para verificar a integridade e a conformidade dos arquivos .pre-commit-config.yaml. Ele atua como um guardião para seus Git hooks, garantindo que cada entrada de repositório, definição de hook e script local seja configurado corretamente antes de entrar em produção. Ao utilizar esta skill da biblioteca Openclaw Skills, os desenvolvedores podem evitar pipelines de CI quebrados e manter um ambiente padronizado para o desenvolvimento local.
Além da verificação de sintaxe básica, este validador implementa uma inspeção profunda dos schemas de hook, incluindo a validação de valores de staging, ambientes de linguagem e fixação de versão (pinning). É um utilitário essencial para equipes que buscam manutenção de base de código de alta qualidade e governança automatizada de seu ciclo de vida de desenvolvimento por meio do Openclaw Skills.
Casos de uso do Pre-Commit Config Validator
- Validação automatizada de arquivos .pre-commit-config.yaml dentro de pipelines de CI/CD para evitar implantações de configuração incorreta.
- Auditoria de grandes monorepos para garantir IDs de hook e versões de repositório consistentes.
- Solução de problemas de definições de hook locais para entradas ausentes ou ambientes de linguagem não suportados.
- Migração de configurações legadas de pre-commit para seguir as modernas melhores práticas e padrões de segurança.
Como o Pre-Commit Config Validator funciona
- O usuário fornece um ou mais arquivos de configuração YAML como entrada para o script de validação.
- O validador analisa a sintaxe YAML para garantir a integridade básica do arquivo e a conformidade estrutural.
- Ele aplica sistematicamente 23 regras predefinidas divididas em categorias como Estrutura, Entradas de Repositório e Definições de Hook.
- A ferramenta avalia revisões de repositório, garantindo que branches flutuantes sejam identificados e padrões semver sejam recomendados.
- Um relatório abrangente é gerado no formato solicitado (texto, JSON ou resumo), fornecendo diagnósticos acionáveis para quaisquer problemas identificados.
Configuração do Pre-Commit Config Validator
Para começar a usar esta skill da Openclaw Skills, certifique-se de ter o Python 3 instalado e o script validador disponível em seu caminho local. Use os seguintes comandos para validar sua configuração:
# 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 Dados e Taxonomia de Pre-Commit Config Validator
O validador organiza suas descobertas em cinco categorias de regras distintas, fornecendo uma taxonomia clara para diagnósticos:
| Categoria | Contagem de Regras | Área de Foco |
|---|---|---|
| Estrutura (S) | 5 | Sintaxe YAML, keys de nível superior e keys raiz obrigatórias. |
| Repositório (R) | 6 | URLs de repositório, pinning de rev (SHA/tag) e integridade da lista de hooks. |
| Hooks (H) | 6 | IDs de hook, estágios válidos, listas de argumentos e dependências adicionais. |
| Local (L) | 3 | Requisitos para tipos de repositório local, incluindo entry points e linguagens. |
| Melhores Práticas (B) | 4 | URLs duplicadas, uso de meta-hook e correspondência de padrão semver. |
Recursos avançados do Pre-Commit Config Validator
- Suporte a múltiplos arquivos: Valide vários arquivos de configuração em uma única execução de comando para estruturas de projeto complexas.
- Saída legível por máquina: Gere arrays de diagnóstico JSON para integrar resultados com ferramentas de monitoramento de terceiros ou dashboards personalizados.
- Filtragem baseada em regras: Alvo de domínios de validação específicos, como metadados de repositório ou definições de hook, de forma independente.
- Execução rigorosa: Configure códigos de saída para tratar avisos como erros, garantindo que seu fluxo de trabalho do Openclaw Skills siga os mais altos padrões.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Codebase Migration Planner
Uma ferramenta estratégica para planejar, estimar e acompanhar migrações de codebase em larga escala, desde upgrades de framework até transições de linguagem.
API Changelog Generator
Um utilitário poderoso para comparar especificações OpenAPI e gerar changelogs e guias de migração prontos para o consumidor.
Ollama Task Orchestrator
Um mecanismo de execução remota para gerenciar filas de tarefas Ollama e geração de código automatizada via SSH.
Dockerignore Linter
Uma ferramenta de auditoria abrangente projetada para validar arquivos .dockerignore em busca de erros de sintaxe, vazamentos de segurança e inchaço do contexto de build.
ArgoCD Deployment Analyzer
Uma ferramenta de diagnóstico abrangente para identificar drift de sincronização, diagnosticar falhas de implantação e auditar a segurança de aplicações gerenciadas pelo ArgoCD.
DevContainer Validator
Um validador CLI em Python para arquivos devcontainer.json que verifica erros estruturais, riscos de segurança e melhores práticas de configuração.
Apresentou*
