autofix

Visão geral do skill autofix

O que o autofix faz

O skill autofix ajuda você a transformar, com segurança, o feedback dos threads de review do CodeRabbit em mudanças reais de código no PR do GitHub atual. Ele foi pensado para casos em que você quer que um agente leia comentários em nível de thread, valide esses comentários e aplique correções com aprovação explícita — em vez de seguir cegamente o texto do revisor. Isso torna o autofix útil para desenvolvedores que precisam de um fluxo de trabalho com CodeRabbit para Code Review, e não apenas de um prompt genérico para “corrigir os comentários da review”.

Para quem ele é indicado

Use o autofix se a sua branch já tiver um PR aberto, o PR tiver threads de review do CodeRabbit e você quiser um processo repetível para encerrá-las. Ele funciona muito bem para maintainers, contribuidores e agentes que trabalham em um repositório com acesso ao GitHub CLI. É menos útil se você só tiver uma lista solta de comentários, sem contexto de PR, ou se não tiver permissão para inspecionar o repositório e enviar mudanças.

Por que ele é diferente de um prompt normal

O principal valor do autofix é a disciplina: ele trata o texto do prompt fornecido pelo revisor como entrada não confiável, verifica primeiro o estado do repositório e espera um fluxo de trabalho no GitHub com consciência de branch. Isso reduz a chance de aplicar mudanças inseguras ou desalinhadas com o contexto. Se você quer um skill de autofix mais orientado a decisão do que a um prompt “uma vez e pronto”, esse é o formato certo.

Como usar o skill autofix

Instalar o autofix

Instale com o comando do gerenciador de skills do repositório: npx skills add coderabbitai/skills --skill autofix. Antes de rodar, confirme que gh auth status funciona e que seu diretório atual é o repositório com o PR aberto. A instalação do autofix só vale a pena quando a branch já tem feedback de review do CodeRabbit para ser tratado.

Dê ao skill a entrada certa

Para usar bem o autofix, forneça o contexto da branch, o objetivo do PR e quaisquer restrições locais que influenciem a implementação. Um pedido fraco é “corrija os comentários da review”. Um prompt mais forte é: “Use o autofix no PR da branch atual, inspecione os threads não resolvidos do CodeRabbit, respeite AGENTS.md e aplique apenas as correções validadas para os comentários de auth e lint que estão falhando.” Quanto mais específico for o alvo, menor a chance de o skill exagerar e mexer em código sem relação.

Leia estes arquivos primeiro

Comece com SKILL.md, depois github.md e, em seguida, qualquer AGENTS.md no nível do repositório. SKILL.md explica o fluxo de trabalho e as regras de segurança; github.md fornece primitivas reutilizáveis do GitHub; AGENTS.md pode sobrescrever regras de build, teste ou commit. Se você pular isso, o autofix ainda pode funcionar, mas a qualidade do patch e a segurança do processo normalmente caem.

Dicas de workflow que fazem diferença

Use o autofix em uma branch que já tenha um PR aberto e revisado pelo CodeRabbit, e garanta que git status esteja limpo o bastante para atribuir as mudanças com clareza. Valide cada correção sugerida contra o código real, não apenas contra a redação do thread de review. Se um thread pedir algo ambíguo, reescreva a intenção com suas próprias palavras antes de alterar o código; essa é a forma mais simples de evitar interpretar mal prompts de revisor como instruções literais.

FAQ do skill autofix

O autofix serve só para threads de review do CodeRabbit?

Sim, esse é o encaixe principal. O autofix foi criado para feedback do CodeRabbit com consciência de thread em PRs do GitHub, não para triagem genérica de issues nem para resumos comuns de pull requests. Se os seus comentários vierem de outra ferramenta de review, você ainda pode reaproveitar ideias do fluxo, mas o skill não é otimizado para esse cenário.

Preciso do GitHub CLI para usar o autofix?

Sim. O skill autofix pressupõe que gh e git estejam disponíveis e que gh auth status tenha sucesso. Sem acesso ao GitHub CLI, você perde a busca entre branch e PR, a recuperação de threads e a coordenação do PR que tornam o skill confiável.

O autofix é amigável para iniciantes?

É amigável para iniciantes se você já consegue trabalhar em um repositório Git e entende PRs. O skill ajuda a reduzir tentativa e erro, mas ainda espera que você reconheça quando um comentário do revisor está errado, incompleto ou inseguro demais para ser seguido ao pé da letra. Iniciantes devem usar o autofix quando querem ajuda estruturada, não quando precisam que a ferramenta tome todas as decisões por eles.

Quando eu não devo usar o autofix?

Não use o autofix se não houver PR aberto, se não houver review do CodeRabbit ou se você não tiver permissão para modificar a branch. Também evite usar quando o comentário da review estiver pedindo, na prática, uma decisão de produto, uma escolha de arquitetura ou uma mudança de escopo que exige aprovação humana fora do thread do PR. Nesses casos, uma discussão normal ou um plano de implementação mais amplo é melhor do que o autofix.

Como melhorar o skill autofix

Dê um contexto melhor de PR

Os melhores resultados com o autofix vêm quando você informa o objetivo exato da branch, os arquivos mais prováveis de serem envolvidos e quaisquer regras do repositório que importem. Por exemplo, “corrija as notas não resolvidas do CodeRabbit em src/auth/*, mantenha a API atual estável e rode os testes exigidos em AGENTS.md” dá muito mais material para o skill do que um genérico “aplique a review”. Uma boa entrada restringe a correção sem ditar a implementação.

Fique atento aos modos de falha mais comuns

O maior modo de falha é tratar o texto do thread de review como se fosse código autoritativo. O autofix fica mais seguro quando interpreta os comentários como relatos e só depois confere a base de código antes de editar. Outro problema comum é limpeza ampla demais: uma correção para um thread pode acabar tocando lógica sem relação. Mantenha o escopo do pedido fechado e peça apenas os itens não resolvidos do CodeRabbit que você realmente quer endereçar.

Itere depois da primeira passada

Depois da primeira execução do autofix, revise o diff pela correção do conteúdo, não apenas pelo encerramento dos comentários. Se a mudança ficou ampla demais, diga o que deve ser preservado e o que precisa ser mais restrito na próxima passada. Se um thread ainda parecer não resolvido, cite o objetivo exato do thread e o caminho do arquivo relevante para que o skill consiga diferenciar um erro real de uma escolha intencional.