debate-review

Quando Usar

• Você tem um PR do GitHub ou MR do GitLab que precisa de uma revisão completa antes de ser mesclado.
• Você quer um debate entre dois modelos (revisor principal vs. revisor de debate) para identificar pontos cegos antes de postar comentários inline.

Dois modelos argumentam antes que qualquer coisa seja postada. Um revisor principal encontra problemas. Um revisor de debate tenta derrubá-los e pode adicionar os seus próprios. O revisor principal então toma a decisão final, e uma revisão com comentários inline é enviada para o PR ou MR. Ela é postada a partir da conta gh, glab ou az do usuário como uma revisão de não aprovação ou comentário. Ela nunca aprova e nunca solicita alterações.

Você é o orquestrador. Você executa um comando e repassa o resultado. Você não revisa o diff sozinho e não mexe no PR.

Executar

node "<skill-dir>/scripts/review-pr.mjs" --local [--base <ref>]
node "<skill-dir>/scripts/review-pr.mjs" <pr-url | number> [--dry-run]

• Se o usuário quiser uma revisão e não houver URL de PR/MR, execute --local do repositório (ou --repo-dir). Não invente um URL. Repasse o stdout. --local nunca fala com um forge e rejeita caminhos Git não-UTF-8 em vez de decodificá-los com perda.
• <pr-url> é um URL de /pull/N do GitHub, /-/merge_requests/N do GitLab ou /_git/<repo>/pullrequest/N do Azure DevOps (dev.azure.com ou o legado *.visualstudio.com). Um número simples resolve contra o origin do diretório atual, incluindo URLs HTTPS do Azure DevOps e remotos ssh.dev.azure.com:v3/.
• --dry-run exibe uma revisão de PR ao vivo em vez de postá-la. Não combina com --local.
• O Azure DevOps precisa de az logado (az login) com acesso ao projeto. Nenhuma extensão é necessária, o script fala com a API REST através de az rest. Uma revisão lá é N threads de comentários inline mais uma thread de resumo fechada, já que o Azure DevOps não tem um objeto de revisão único; os blocos de alerta são renderizados como citações simples, que ainda podem ser lidas.
• Os revisores são duas filas de delegate-skills, review-main e review-debate. Se alguma estiver faltando, o script informa. Adicione-as com delegate-setup. Escolha dois implementadores diferentes, pois o debate só vale a pena quando o segundo modelo não compartilha os pontos cegos do primeiro (principal claude ou grok, debate codex com alto esforço é um bom par). Para um uso único, passe --main <implementer> ou --debate <implementer>. Apenas implementadores cuja fila tenha --read-only são aceitos. Essas duas filas pertencem ao revisor. Não aponte-as para uma fila que você usa para outro trabalho, como uma fila de plan-debate.
• O código de saída 3 significa que este sha de cabeça já tem uma debate-review. Reexecute com --force para postar novamente.
• Uma execução leva minutos, pois são duas ou três sessões de implementador uma após a outra. Execute em segundo plano e reporte o URL impresso quando terminar. Não faça polling apertado.

Todas as flags: --help. Contratos: references/schema.md. O que é postado: references/comment-format.md. O revisor faz um briefing ao vivo em assets/prompts/ e o script os preenche; você não precisa lê-los.

Após Postar

Cada comentário postado carrega um marcador <!-- debate-review:<id> status=... -->. babysit-pr lida com as rodadas do GitHub e GitLab (verificar, corrigir bloqueadores, responder, resolver). Ele ainda não consegue coletar dados do Azure DevOps, então repasse as descobertas do Azure diretamente para o usuário. Não aja sobre as descobertas você mesmo, a menos que solicitado.

Artefatos

~/.cache/debate-review/<owner>__<repo>/<N>/<head>/ contém run.json (todos os três documentos, tempos, o que foi postado) mais main/, debate/ e final/, cada um com o brief enviado e a fila do result.json. --local escreve sob ~/.cache/debate-review/local/<repo>/<branch>/<head>/ em vez disso.

Limitações

• Requer delegate-skills com filas review-main e review-debate e gh/glab autenticado.
• Importação apenas de documentação — helpers executáveis (scripts/) não incluídos; veja o upstream para o runtime completo. Posta apenas uma única revisão COMMENT.

Adaptado de amElnagdy/review-skills (MIT) — apenas documentação, runtime não incluído.