Commit sem Enrolação

Quando Usar

Use esta habilidade quando precisar reescrever mensagens de commit para que soem como se um engenheiro cuidadoso as tivesse escrito. Remove enrolação de IA/marketing ("solução abrangente", "implementação robusta", "aproveitar", "melhorar", "perfeitamente", "Este commit..."). Mantém o formato Conventional Commits. Assunto ≤72 caracteres (meta ≤50),...

Propósito

Gere ou reescreva mensagens de commit para que soem como se um engenheiro real as tivesse escrito no final de um dia real. Formato Conventional Commits. Direto, específico, sem inglês de modelo. Porquê em vez de o quê.

Gatilho

/unslop-commit, /commit, "escreva um commit", "mensagem de commit", "humanize este commit", "desenrole este commit". Aciona automaticamente quando o usuário tem alterações preparadas e pede uma mensagem de commit.

Regras

Linha de assunto

• Formato: <type>(<scope>): <imperative summary>
• Escopo opcional. Tipos: feat, fix, chore, refactor, docs, test, perf, build, ci, revert.
• Modo imperativo: add, fix, move, remove — não added, fixes, fixing.
• ≤50 caracteres quando possível. Limite rígido de 72.
• Sem ponto final.
• Minúsculas após :, a menos que o projeto use maiúsculas.

Corpo (apenas quando o assunto não puder carregar)

• Adicione para: "porquê" não óbvio, alterações que quebram compatibilidade, migrações, contexto de segurança, integridade de dados.
• Quebre em 72 caracteres. Use marcadores - para dois ou mais pontos independentes. Parágrafo único para um pensamento.
• Termine com referências: Closes #42, Refs #17. Não use BREAKING CHANGE: a menos que seja realmente uma quebra de compatibilidade — e então escreva-a.

Nunca inclua

• Prefixo de modelo: "Este commit...", "Esta alteração...", "Nós estamos...", "Eu tenho..."
• Verbos de marketing: abrangente, robusto, melhorar, aproveitar, perfeito, holístico
• Advérbios de preenchimento: apenas, realmente, basicamente, simplesmente, de fato
• Repetir o nome do arquivo quando o escopo já o nomeia
• "Conforme solicitado por..." (use Co-authored-by: se precisar de atribuição)
• Atribuição de IA, a menos que o projeto exija
• Emoji, a menos que a convenção do projeto diga o contrário

Clareza automática (sempre inclua o corpo)

• Alterações que quebram compatibilidade
• Correções de segurança
• Migrações de dados
• Reversões (cite o commit revertido)

Exemplos

Ruim → bom (assunto enrolado, sem corpo)

• Ruim: feat: implement a comprehensive, robust solution for user profile retrieval with enhanced error handling
• Bom: feat(api): return profile fields the mobile client actually needs

Ruim → bom (corpo vago)

Ruim:

fix: fixed the bug

This commit addresses an issue where the application was not working correctly
in some edge cases. We've improved the logic to handle these scenarios.

Bom:

fix(checkout): ignore stale cart id from localStorage

Stale cart ids came from tabs that hadn't refreshed after a deploy. Server
now treats unknown ids as empty cart instead of 500.

Closes #842

Alteração que quebra compatibilidade

feat(api)!: rename /v1/orders to /v1/customer-orders

The old route stays in place until the next major release but logs a
deprecation warning. Internal services have been migrated.

BREAKING CHANGE: third-party integrations using /v1/orders directly need
to switch to /v1/customer-orders by 2026-07-01.

Closes #1290

Limites

• Produza apenas a mensagem, em um único bloco delimitado, pronto para colar.
• Não execute git commit, prepare ou altere.
• Se a alteração for genuinamente trivial (docs(readme): fix typo), mantenha-a trivial. Não adicione preenchimento.
• Nunca invente contexto que o usuário não forneceu. Se o "porquê" não estiver claro, pergunte ou omita o corpo.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua origem e ao contexto do projeto local.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.