🚀 CommitZen

Helper inteligente para mensagens de commit com IA

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%
✓ Copiado para a área de transferência!