CommunityEscrita e Ediçãogithub.com

Push

Skill para commit e push de alterações no branch atual com mensagens de commit guiadas por diff e change-log.

O que é Push?

Este skill automatiza o fluxo de commit e push para o branch atualmente checkout, seguindo regras seguras e convenções de mensagens de commit. Ele detecta o branch atual, faz pull com `--ff-only`, inspeciona o diff, deriva a mensagem de commit a partir do `docs/change-log.md` ou da área alterada mais relevante, e realiza o push. Suporta plataformas como Claude Code, Codex e CLIs similares, e é útil para desenvolvedores que desejam padronizar commits e evitar forças ou verificações desabilitadas. O skill falha de forma ruidosa se qualquer etapa falhar, garantindo transparência no processo.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add giostriquer/agent-workshop

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Push faz?

Faça commit e push das alterações para o branch atual.

Este skill não é restrito a um branch específico — ele sempre opera no branch atualmente checkout. Adapte a linha de trailer no passo 8 abaixo conforme a preferência de atribuição de commit do seu projeto.

Início rápido

  1. Detecte o branch atual com git branch --show-current.
  2. Se não houver nome de branch atual, pare e exiba o erro.
  3. Faça pull do origin/<branch-atual> mais recente com git pull --ff-only origin <branch-atual>. Se falhar, pare e exiba o erro.
  4. Inspecione o diff antes de stagiar.
  5. Prefira a atualização mais recente e significativa em docs/change-log.md como fonte da mensagem de commit quando relevante.
  6. Se nenhuma atualização no change-log for a verdadeira fonte da alteração, derive a mensagem da área primária alterada no diff.
  7. Stagie todas as alterações com git add -A.
  8. Faça commit com uma mensagem multilinha e acrescente o trailer padrão do projeto (geralmente uma linha Co-Authored-By: ou atribuição similar; específica do projeto).
  9. Faça push com git push origin <branch-atual>.
  10. Reporte o branch, o hash do commit e o assunto em uma frase.

Diretrizes para mensagens de commit

Use um assunto conciso no estilo convencional, como:

  • docs: para documentação ou atualizações de rota
  • feat: para novas capacidades, sistemas ou conteúdo
  • fix: para correções de comportamento
  • refactor: para alterações estruturais sem alteração significativa de comportamento
  • test: para adições ou revisões significativas de superfície de testes
  • chore: para trabalho de manutenção que não se encaixa melhor em outro lugar

Para o corpo:

  • resuma as áreas alteradas mais significativas
  • prefira 1 linha por alteração principal
  • mantenha-se fiel ao diff real

Ao usar docs/change-log.md como fonte:

  • prefira a seção ou entrada mais recente e significativa que realmente descreva a alteração central
  • não force uma mensagem derivada do change-log quando a atualização do log for incidental

Quando não usar o change-log como fonte:

  • derive o assunto da área alterada mais importante no diff
  • se o diff for ambíguo demais para resumir com confiança, peça ao usuário a mensagem de commit em vez de adivinhar

Regras

  • Sempre use o branch atualmente checkout.
  • Nunca use --force ou --force-with-lease.
  • Nunca use --no-verify.
  • Falhe ruidosamente: se um passo falhar, pare e exiba o erro.

Habilidades Relacionadas