Helper inteligente para mensagens de commit com IA
1
🧩 Dados do Commit
Preencha as informações do seu commit
2
📝 Prompt Alternativo (Detalhado)
Versão com checklist obrigatório
Use este prompt para análises mais profundas e detalhadas:
"Analise este arquivo e gere um commit no padrão Commitizen para as alterações abaixo.
Você DEVE explicar absolutamente TUDO em nível máximo de detalhe.
NÃO omita nenhuma mudança, mesmo que pareça pequena ou técnica.
FORMATO DO COMMIT
Cabeçalho:
Use `tipo(escopo): descrição curta`, clara e precisa.
Corpo do Commit:
Explique detalhadamente TODAS as mudanças, cobrindo obrigatoriamente:
CHECKLIST OBRIGATÓRIO (NÃO PULE ITENS):
- O que foi criado
- O que foi alterado
- O que foi removido
- Por que cada mudança foi feita
- Como o comportamento anterior funcionava
- Como o comportamento novo funciona
- Quais telas foram impactadas
- Quais endpoints foram impactados
- Quais validações foram impactadas
- Quais regras de negócio foram alteradas
- Quais serviços, hooks, helpers ou módulos foram afetados
- Quais riscos ou efeitos colaterais existem
- Se houve impacto em performance, UX ou dados
- Exemplos práticos do antes e depois, quando possível
- Incluia tambem hashtags com CONTEXTO e outras palavras chave para facilicar a busca e identificação do commit
Breaking Change:
Se QUALQUER mudança quebrar compatibilidade, crie a seção:
BREAKING CHANGE:
Explique exatamente:
- O que quebrou
- Por que quebrou
- O que precisa ser ajustado para adaptar
Tom de voz:
Linguagem natural, clara e humana
Sem formalidade excessiva
Sem uso de travessões (—)
Resumo para QA (OBRIGATÓRIO):
Após o commit, crie um resumo separado para QA explicando TUDO em alto nível de clareza.
Formatação:
Gere tudo como TEXTO PURO
Coloque dentro de BLOCOS DE CÓDIGO Markdown"
1
Gerar o arquivo de mudanças
Exporte as alterações do seu repositório
No terminal do seu projeto, use o comando para exportar o que foi alterado:
Terminal
git diff > alteracoes.txt
💡 Dica: Se já deu git add, use: git diff --cached > alteracoes.txt
2
Copiar o conteúdo
Prepare o arquivo para envio
Abra o arquivo alteracoes.txt criado na pasta raiz do projeto.
Selecione tudo (Ctrl+A) e copie (Ctrl+C) o texto gerado.
⚠️ Importante: Certifique-se de que o arquivo não está vazio e contém todas as mudanças que você deseja documentar.
3
Enviar para a IA
Cole o prompt e anexe o arquivo
Volte para a aba "Gerador de Prompt", preencha os dados do commit e clique em "Gerar Prompt Completo".
Cole o prompt gerado na nossa conversa e anexe o conteúdo do arquivo alteracoes.txt que você copiou.
💡 Dica: Você pode usar o botão "Copiar Prompt" para facilitar o processo.
4
Receber e aplicar o commit
Use a mensagem gerada
Eu vou analisar o arquivo e gerar uma mensagem de commit completa no padrão Commitizen.
Copie a mensagem gerada e use no seu repositório:
Terminal
git commit -m "tipo(escopo): descrição"
📋 O que você vai receber:
Cabeçalho: No padrão tipo(escopo): detalhado
Corpo: Explicação completa de todas as mudanças
Breaking Change: Seção clara se houver incompatibilidades
Resumo QA: Documento separado para o time de testes
Texto Puro: Pronto para copiar e colar
📚 Tipos de Commit Commitizen
feat
Nova funcionalidade
fix
Correção de bug
docs
Documentação
style
Formatação/Estilo
refactor
Refatoração
perf
Performance
test
Testes
chore
Tarefas gerais
✨ Exemplos de Commits
Exemplo 1: Nova Funcionalidade
feat(autenticação): adicionar login com autenticação de dois fatores
Implementada autenticação de dois fatores (2FA) usando TOTP:
- Adicionado gerador de código QR na tela de configuração
- Criado serviço de validação de tokens TOTP
- Integrado com o fluxo de login existente
- Adicionadas telas de backup codes
Impacto:
- Telas afetadas: Login, Configurações de Segurança
- Endpoints: POST /auth/2fa/enable, POST /auth/2fa/verify
- Performance: +50ms no tempo de login (aceitável)
Testes necessários:
- Fluxo de habilitação do 2FA
- Validação de códigos expirados
- Recuperação com backup codes
Exemplo 2: Correção de Bug
fix(pagamento): corrigir cálculo de juros em parcelas
Problema:
O cálculo de juros estava usando a taxa anual diretamente, sem converter para mensal.
Solução:
- Aplicada conversão correta: taxa_mensal = (1 + taxa_anual)^(1/12) - 1
- Adicionados testes para validar cálculos
- Verificado com casos de uso reais
Impacto:
- Valores de parcelas agora corretos
- Afeta clientes com financiamentos pendentes
- Recomenda-se recalcular parcelas existentes
BREAKING CHANGE: Parcelas recalculadas podem ter valores diferentes
Exemplo 3: Refatoração
refactor(api): migrar endpoints de REST para GraphQL
Refatoração completa da API:
- Migrados 45 endpoints REST para GraphQL
- Implementado schema GraphQL com validações
- Criados resolvers otimizados com DataLoader
- Mantida compatibilidade com versão anterior
Endpoints afetados:
- /api/users/* → query/mutation users
- /api/products/* → query/mutation products
- /api/orders/* → query/mutation orders
Performance:
- Redução de 60% em requisições de rede
- Tempo de resposta 40% mais rápido
Testes:
- Todos os endpoints testados
- Cobertura de testes: 95%