Gitmoji

Gera mensagens de commit que seguem a convenção gitmoji: cada commit começa com um emoji que identifica a intenção da mudança de relance. Dada uma diff, uma lista de arquivos staged ou uma descrição simples de uma mudança, esta habilidade escolhe o gitmoji mais apropriado e escreve uma mensagem de commit concisa e bem formatada em torno dele.

Esta habilidade apenas gera a mensagem — nunca executa git commit ou qualquer outro comando git. A saída é uma mensagem copiável para o usuário usar.

Quando Usar Esta Habilidade

• O usuário diz "escreva um commit gitmoji", "gitmoji esta mudança" ou "adicione um emoji à minha mensagem de commit"
• O usuário pergunta "qual gitmoji devo usar para isso?"
• O usuário cola uma diff git ou descreve uma mudança em um projeto que usa histórico de commits no estilo gitmoji
• O usuário quer um histórico de commits expressivo e escaneável usando emojis

Quando não usar: se o projeto segue Conventional Commits simples (feat:, fix:, ...) sem emojis, use a habilidade conventional-commit ou commit-message-storyteller em vez disso. Se tiver dúvidas sobre qual convenção o projeto usa, peça ao usuário para fornecer histórico de commits recente (por exemplo, a saída de git log --oneline -10).

Formato da Mensagem

A especificação gitmoji:

<intention> [scope?][:?] <message>

• intenção — exatamente um gitmoji expressando o objetivo do commit
• escopo (opcional) — a seção da base de código afetada, entre parênteses
• mensagem — uma breve explicação imperativa da mudança

Exemplos:

✨ add multi-tenant support to the billing service
🐛 (auth) prevent token refresh loop on expired sessions
♻️ (api): extract pagination logic into shared helper

Estilo de Emoji: Unicode vs Shortcode

Gitmoji suporta duas notações equivalentes:

Combine com o histórico existente do repositório. Se commits recentes usam shortcodes no estilo :sparkles:, gere shortcodes; caso contrário, use emojis unicode como padrão.

Como Funciona

Passo 1: Entender a Mudança

Trabalhe com o que o usuário fornecer:

1. Uma diff git — leia-a e identifique o que mudou e por quê
2. Uma lista de arquivos staged/modificados — infira a intenção a partir dos nomes e caminhos dos arquivos
3. Uma descrição simples — use-a diretamente

Se a intenção for genuinamente ambígua (por exemplo, "atualizado auth.js" pode ser uma correção, um recurso ou uma refatoração), faça uma curta pergunta esclarecedora em vez de adivinhar.

Passo 2: Identificar a Intenção Dominante

Determine o propósito principal da mudança. Intenções comuns e seus gitmojis:

Este é apenas o subconjunto mais comum — consulte sempre references/gitmoji-reference.md para a lista oficial completa de 75 gitmojis antes de decidir por um; um emoji mais específico geralmente existe (por exemplo, 🩹 para uma correção trivial, ✏️ para um erro de digitação, 🚚 para mover um arquivo).

Passo 3: Escolher Exatamente Um Emoji

Regras para casos ambíguos:

• Específico vence genérico — uma correção de erro de digitação é ✏️, não 🐛; mover arquivos é 🚚, não ♻️; uma correção trivial não crítica é 🩹, não 🐛
• Testes: ✅ para adicionar/atualizar testes que passam; 🧪 apenas para testes intencionalmente falhos (por exemplo, etapa vermelha do TDD)
• Correção vs. hotfix: 🚑️ apenas para correções urgentes em produção; correções de bugs do dia a dia são 🐛
• Correção de segurança: 🔒️ vence 🐛 quando o bug é uma questão de segurança

…