Gerador de Mensagens de Commit
Este arquivo é a única fonte da verdade; cada agente (Claude / opencode / codex) o referencia por meio de seus respectivos shims finos.
Fluxo
- Execute
git diff --stagedpara ver as alterações em staged; se estiver vazio, avise "adicione comgit add" e pare. - Gere a mensagem de acordo com as regras abaixo, exiba para o usuário confirmar, não faça commit diretamente; quando o usuário precisar escolher, dê as opções diretamente, não apenas pergunte.
- Execute
git commit -mapenas quando o usuário confirmar (por exemplo, responder "confirmado" ou "ok"). A menos que o usuário solicite explicitamente, não executegit push.
Regras
Leia git diff --staged e gere de acordo com o Conventional Commits, explicando o QUE (WHAT) e o PORQUÊ (WHY).
- Título
tipo(escopo): descrição, comprimento total ≤ 74 caracteres, sem ponto final no final, sem qualquer prefixo/aspas/bloco de código - tipo escolha o mais adequado:
featnova funcionalidade ·fixcorreção de bugrefactorrefatoração que não altera o comportamento externo (nem nova funcionalidade nem correção) ·perfotimização de performancedocsapenas documentação ·styleajustes de formatação que não afetam a semântica (espaços/formatação/ponto e vírgula etc.)testadição ou correção de testes ·buildalterações no sistema de build ou dependências externas ·ciconfiguração e scripts de CIchoreoutras tarefas que não mexem em src/test ·revertreversão de commit anterior
- escopo (opcional) nome do módulo afetado, de acordo com a convenção do repositório — em monorepo, use o nome do diretório app/package; se abranger vários ou não tiver certeza, omita diretamente
- Descrição deve estar em chinês: frase de ação curta que explique claramente "o que foi feito", sem escrever frases vazias como "modificou vários arquivos", "este commit", "esta modificação"; identificadores (nomes de funções/arquivos/pacotes) permaneçam em inglês
- Apenas linha única: em qualquer circunstância, a mensagem de commit tem apenas uma linha de título, sem corpo/rodapé; o WHY necessário deve ser encapsulado nesta única linha
- Breaking change use
tipo(escopo)!: descriçãocom!, mantendo linha única, sem usarBREAKING CHANGEno rodapé - Pontuação use pontuação meia-largura em inglês, não use largura inteira
,。:()
Estratégia de Geração
Antes de escrever, pense claramente "qual problema este conjunto de alterações resolve / qual é o fio condutor", depois escreva de acordo com o formato acima:
- Agarre o fio condutor: escreva apenas as informações essenciais para entender este commit, não empilhe nomes de arquivos/nomes de funções/nomes de configuração (a menos que eles sejam críticos por si só).
- Varra mudanças significativas: há alterações de lógica, contrato, build, portões de qualidade ou comportamento visível ao usuário — com base nisso, escolha o tipo correto e decida se usa
!para marcar breaking.
Disciplina de Conteúdo (De Onde Vem o WHAT)
Acima está o formato; abaixo trata da veracidade do conteúdo — a mensagem declara apenas fatos do código já confirmados, não adivinha intenções, não inventa com base em documentação:
- Priorize mudanças de comportamento em
src/test: docs servem apenas como contexto auxiliar, não use docs para inferir WHAT (a documentação frequentemente está adiantada/atrasada em relação ao código). - Contexto de diálogo tem prioridade sobre documentação: metas explicitamente mencionadas nos prompts recentes do usuário podem ser usadas para definir WHY e escolher uma redação mais precisa (por exemplo, "corrigir check/typecheck completo"); no entanto, WHAT/escopo ainda devem basear-se no diff staged — se o contexto mencionar algo que o diff não mostra, não escreva na mensagem; em caso de conflito, priorize o diff e peça confirmação.
- Diffs de exclusão / renomeação: quando não for possível confirmar o propósito pela relação de chamadas do código, declare objetivamente (
Excluir X/X renomeado para Y), não escreva causalidade forte como "substituir / migrar para / mudar para". - Múltiplos pontos de alteração com o mesmo objetivo (por exemplo, uma correção de qualidade de código/build) → forneça diretamente uma mensagem resumida; divisão em partes menores deve ser oferecida apenas como sugestão opcional anexa se melhorar significativamente a revisão/reversão, sem bloquear por padrão.
- Mistura clara de múltiplos objetivos independentes de funcionalidade/correção → forneça tudo de uma vez: uma mensagem resumida para cada unidade + uma mensagem resumida conservadora, permitindo que o usuário escolha diretamente entre dividir ou resumir; não deixe o resumo para a próxima rodada; apenas quando o WHAT geral não puder ser objetivamente resumido é que se lista apenas as unidades, sem forçar.
- Mudanças com pertencimento/intenção incertos (entradas paralelas, sem razão aparente para a alteração) → produza "Estes arquivos precisam de confirmação de pertencimento/intenção", em vez de forçar uma mensagem; quando incerto, evite palavras vagas como "organizar / ajustar", priorize pedir confirmação do usuário ou divisão.