Copilot PR Autopilot

Leve qualquer pull request do GitHub através de rodadas repetidas de revisão de código do Copilot até que o agente tenha feito seu trabalho — cada descoberta do Copilot tem uma resposta do agente (reconhecimento de correção, recusa com justificativa ou escalonamento explícito para o usuário). As threads abertas restantes, se houver, são escalonamentos deliberados para o proprietário da mesclagem humana — não são falhas de loop. Independente de repositório — funciona em qualquer repositório que tenha o Copilot Code Review ativado, executado a partir de uma máquina com a CLI gh instalada e autenticada (veja Pré-requisitos).

Quando Usar Esta Habilidade

• O usuário pede para "solicitar revisão do Copilot" ou "executar um loop de revisão do Copilot" em um PR.
• Um PR está funcionalmente completo e o usuário deseja uma passagem final de correção através de rodadas repetidas de revisão automatizada.
• Uma revisão anterior do Copilot no PR deixou threads abertas que precisam de triagem, correção, resposta e resolução.

Quando NÃO Usar Esta Habilidade

• O PR ainda está em fase de design ativo — espere até que a estrutura esteja estável; caso contrário, as descobertas mudarão de rodada para rodada.
• O usuário deseja feedback de um revisor humano, não do Copilot.

Pré-requisitos

• CLI gh instalada e autenticada contra o repositório de destino.
• PowerShell no PATH — Windows PowerShell 5.1+ (powershell.exe) ou PowerShell 7+ (pwsh). Ambos são testados.
• Copilot Code Review é o caso de uso principal (01-request-review.ps1 usa GraphQL requestReviewsByLogin para acionar o Copilot). NÃO é um requisito rígido — se 01-request-review.ps1 falhar porque o Copilot não está ativado no repositório/conta, o agente ainda pode levar threads de revisão existentes (humanas, advanced-security, etc.) à conclusão executando os passos 3–8 uma vez como uma única iteração; apenas pule o gatilho + espera. Não há detecção automática para "Copilot indisponível" — o agente toma essa decisão após a falha do gatilho (o script não pode dizer de forma confiável "Copilot desativado" de "Copilot ativado, mas ainda não acionado" apenas pelo estado da API).

Permissões: quem pode executar o loop completo

O piloto automático multi-rodada completo (passos 1 → 9 → 1) precisa de permissão de Triagem ou Gravação no repositório de destino, porque a única API pública do GitHub para adicionar o bot do Copilot como revisor (requestReviewsByLogin) é restrita por essa permissão. Verificado contra a superfície REST + GraphQL pública no histórico de commits deste PR — não há caminho de API pública para revisores de bot sem permissão de gravação.

No modo de iteração única, o booleano de convergência do loop é Converged: true se e somente se OpenThreadsAwaitingReply == 0 (o lado do agente está concluído). O reacionamento do lado do mantenedor então impulsiona quaisquer rodadas adicionais.

Cada script carrega scripts/_lib.ps1 que executa Assert-GhReady ao carregar: se gh estiver faltando OU gh auth status falhar, o script para antes de qualquer trabalho com uma única mensagem de erro acionável nomeando o comando de instalação e gh auth login. O agente deve exibir essa mensagem ao usuário verbatim e parar o loop — não tente novamente ou contorne-a.

Fluxo de Trabalho Passo a Passo

O loop: passos 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9, depois retorne ao passo 1 se Converged: false. Repita a rodada 1→9 até que o passo 9 retorne Converged: true; somente então execute o passo 10 uma vez e chame task_complete. Em toda 10ª rodada, o pai executa o gate de recapitulação de limite de rodada antes de retornar — recapitule todas as rodadas anteriores e pare se o loop saiu do escopo original do PR.

Cada rodada executa os passos 1–9; o passo 10 é uma limpeza única após a convergência. O agente pai coordena; cada passo do subagente é executado em um contexto novo com um orçamento limitado. Protocolo transversal (limitação de tempo, extensão, fallback de iteração única): orchestration.md.

1. Solicitar revisão (pai) — veja 01-request-review.md
2. Aguardar revisão (subagente, limite de 20 minutos) — veja 02-wait.md

…