Git

• Tarefas de repositório: Qualquer tarefa que envolva um repositório Git — criar branches, preparar alterações, fazer commits, push ou abrir pull requests.
• Colaboração em equipe: Quando a integridade do histórico é importante e você precisa de fluxos com feature branches, workflows de hotfix ou higiene de commits prontos para PR aplicados automaticamente.
• Depuração de histórico: Quando você precisa rastrear regressões com git bisect, recuperar commits perdidos via git reflog ou desfazer alterações com segurança.
• Resolução de conflitos: Quando merges ou rebases geram conflitos e o agente precisa de uma abordagem estruturada e verificada para resolvê-los.

• Controle de versão não-Git: Se o projeto utiliza Mercurial, SVN ou outro VCS, os comandos desta skill não serão aplicáveis.
• Tarefas de análise somente leitura: Se o agente apenas precisa ler o código-fonte sem interagir com o Git de forma alguma, a skill adiciona uma sobrecarga desnecessária.

A skill aplica o uso de --force-with-lease em vez de --force para evitar sobrescrever o trabalho de colegas de equipe, e proíbe force-push em branches compartilhadas como main/master. Uma lista de verificação de segurança integrada deve ser satisfeita antes de qualquer operação destrutiva, como reset --hard ou rebase.

Inclui fluxos passo a passo para cenários de Feature Branch e Hotfix, incluindo quando fazer squash de commits, como sincronizar com git fetch --all --prune e como criar tags de releases. Projetado para se adaptar tanto a equipes com desenvolvimento baseado em trunk quanto a equipes que utilizam o estilo gitflow.

Após editar os arquivos com conflitos, a skill verifica se não restam marcadores de conflito usando grep, confirma que o código compila corretamente e oferece uma saída de emergência via git merge --abort quando um merge se torna muito complexo. O rebase é sugerido como alternativa quando os merges ficam confusos.

Aborda o uso de git reflog para recuperar commits perdidos (por até ~90 dias), restaurar branches excluídas por SHA e desfazer commits sem perder o trabalho usando git reset --soft. Também inclui um fluxo completo de git bisect para identificar com precisão os commits que introduziram regressões.

A skill exige o formato de mensagem de commit tipo(escopo): descrição com a primeira linha abaixo de 72 caracteres, utilizando tipos padrão (feat, fix, docs, refactor, etc.). Isso mantém o histórico legível e compatível com ferramentas automatizadas de geração de changelog.

Documenta e protege contra erros frequentes no Git: estado de HEAD desanexado, problemas de sensibilidade a maiúsculas/minúsculas entre macOS/Windows e CI Linux, erros de clonagem de submódulos, conflitos no stash-pop e commit de arquivos grandes ou segredos. Use git add -p para staging parcial granular.

Um agente estrutura uma nova funcionalidade, cria um branch a partir do main, realiza commits incrementais com mensagens convencionais, faz rebase sobre o main mais recente antes de enviar, consolida commits de correção com squash e abre um branch pronto para PR — tudo sem intervenção manual no Git.

Quando um bug em produção é encontrado, o agente faz checkout de um branch hotfix/ a partir do main, aplica a correção, faz merge tanto no main quanto no develop, adiciona a tag da release e remove o branch — seguindo com precisão o fluxo de hotfix documentado.

O agente executa git bisect para realizar uma busca binária no histórico de commits, marcando commits como bons ou ruins com base nos resultados de testes automatizados, até identificar exatamente o commit que introduziu um bug.

Durante um rebase de feature de longa duração, o agente resolve conflitos arquivo por arquivo, verifica se nenhum marcador <<</>>> permanece, confirma que o build passa e continua o rebase — ou o interrompe de forma limpa se o conflito for complexo demais.