Formatador de Commit Git para Openclaw

Um utilitário inteligente que transforma diffs do git ou descrições de texto em mensagens de Commit Convencional padronizadas em segundos.

wipal
v1.0.0
Mar 8, 2026
0
1k
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install git-commit-formatter

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<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 git-commit-formatter 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 é Formatador de Commit Git?

O Formatador de Commit Git é uma ferramenta especializada projetada para automatizar a criação de mensagens de commit de alta qualidade e padronizadas. Ao aderir estritamente à especificação Conventional Commits v1.0.0, ele garante que o histórico do seu projeto permaneça limpo, profissional e fácil de navegar. Esta ferramenta é um componente central do ecossistema Openclaw Skills, ajudando desenvolvedores a manter 100% de consistência em fluxos de trabalho de controle de versão em toda a equipe.

Esteja você lidando com mudanças complexas de código ou simples atualizações de documentação, esta habilidade analisa o contexto do seu trabalho para sugerir o tipo, escopo e linha de assunto mais apropriados. Ela elimina a adivinhação e a fadiga mental associadas à formatação manual, permitindo que você se concentre na implementação técnica enquanto o agente cuida da documentação do seu progresso.

Casos de uso do Formatador de Commit Git

  • Converter saídas brutas de git diff em mensagens de commit formatadas durante um ciclo de desenvolvimento rápido.
  • Padronizar o histórico de commits para projetos de código aberto para permitir a geração automática de changelogs.
  • Resolver inconsistências nos estilos de commit da equipe, fornecendo uma única fonte de verdade para a estrutura da mensagem.
  • Documentar mudanças disruptivas (breaking changes) e refatorações de múltiplos módulos com descrições claras no modo imperativo.

Como o Formatador de Commit Git funciona

  1. O usuário fornece uma entrada que pode ser uma saída bruta de Git diff ou uma descrição manual em texto das mudanças.
  2. A habilidade analisa a entrada para extrair informações importantes, como arquivos modificados, lógica adicionada ou linhas excluídas.
  3. Determina o tipo de commit correto (feat, fix, docs, style, refactor, test ou chore) com base na lógica de palavras-chave e padrões de mudança.
  4. Um escopo opcional é identificado se as mudanças forem localizadas em um módulo ou caminho de arquivo específico em kebab-case.
  5. Uma linha de assunto concisa é gerada usando o modo imperativo, garantindo que permaneça abaixo do limite de 50 caracteres.
  6. Para mudanças complexas, um corpo é construído com um limite de 72 caracteres por linha para explicar o 'porquê' por trás da modificação.
  7. A mensagem final é validada contra uma lista de verificação rigorosa antes de ser apresentada ao usuário.

Configuração do Formatador de Commit Git

Para integrar esta ferramenta ao seu fluxo de trabalho Openclaw Skills, certifique-se de que a habilidade esteja ativa na configuração do seu workspace.

# Verifique se a habilidade está presente no seu diretório de skills
ls /data/workspace/skills/git-commit-formatter

# Para habilitar a ativação automática sem avisos manuais, atualize sua whitelist
nano /data/workspace/whitelist.yml

Adicione git-commit-formatter à lista skills_allowed_auto_add dentro do arquivo YAML para otimizar seu processo de desenvolvimento.

Esquema de Dados e Taxonomia de Formatador de Commit Git

A habilidade organiza os metadados do commit com base na seguinte taxonomia para garantir a compatibilidade com analisadores git padrão:

Componente Requisito Regras de Validação
Tipo Obrigatório Deve ser um de: feat, fix, docs, style, refactor, test, chore
Escopo Opcional Deve ser em minúsculas e usar formatação kebab-case
Assunto Obrigatório Máx 50 caracteres, modo imperativo, sem ponto final
Corpo Opcional Linha em branco após o assunto, máx 72 caracteres por linha
Rodapé Opcional Usado para etiquetas BREAKING CHANGE ou referenciar números de Issue/PR

Recursos avançados do Formatador de Commit Git

  • Análise Inteligente de Entrada: Distingue automaticamente entre blocos de Git diff e descrições em linguagem natural.
  • Integração Automática com Whitelist: Suporta implantação contínua via whitelist do sistema para configuração sem atrito.
  • Detecção de Mudanças Disruptivas: Identifica modificações de alto impacto e estrutura automaticamente o rodapé BREAKING CHANGE.
  • Manuseio de Mudanças Multi-Lógicas: Oferece recomendações para dividir commits excessivamente grandes em múltiplas unidades lógicas para melhor revisão de código.
  • Formatação Otimizada para Terminal: Garante que todo o texto gerado adira ao limite de largura de 72 caracteres para renderização perfeita em ambientes CLI.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*