Babysitting de Codex
Monitore um PR do GitHub e lide com novos feedbacks de revisão até que uma condição de parada seja atendida.
Invocação
O primeiro argumento é a URL do PR. Um segundo argumento opcional é o intervalo de polling em minutos.
O intervalo padrão é 5. Rejeite valores não positivos.
Exemplos:
codex-babysitting https://github.com/org/repo/pull/123
codex-babysitting https://github.com/org/repo/pull/123 10
codex-babysitting https://github.com/org/repo/pull/123 10 min
Início
- Analise a URL do PR e confirme que o checkout atual é o branch head do PR.
- Crie ou reutilize uma automação de heartbeat para esta execução. Inclua:
- URL do PR
- caminho do checkout
- intervalo de polling
- condições de parada
- regra de que push/resposta/resolução precisa de confirmação explícita do usuário, a menos que permissão permanente já tenha sido concedida
- Identifique a identidade autenticada do Codex usada no PR.
- Carregue threads de revisão abertas, comentários do PR, estados de revisão e reações.
- Rastreie o ID estável e o timestamp da última atualização de cada item acionável.
- Antes de cada varredura, pare imediatamente se o Codex já tiver adicionado uma reação de joinha (
+1) no PR.
Loop de varredura
Em cada varredura, busque os mesmos dados do PR e compare IDs/timestamps. Processe apenas feedbacks recém-alterados.
Para cada item acionável, leia a thread completa, o código alterado e os testes relevantes, em seguida classifique:
- Correção: defeito/regressão/problema de segurança/violação clara de padrão do projeto real.
- Esperado: o comportamento atual é intencional e já justificado pelo código/testes/requisitos.
- Irrealista: caso extremo teórico ou improvável com impacto fraco para o usuário e nenhuma evidência concreta.
- Superdefensivo: pede proteções especulativas que adicionam complexidade/ruído sem valor proporcional.
- Precisa de Direção: solicitação pouco clara/conflitante/que expande o escopo e não pode ser decidida com segurança a partir do contexto do PR.
Portão de mudança significativa
Implemente uma correção apenas quando o feedback passar por este portão:
- Gatilho crível: reproduzível agora, ou um caminho de produção plausível fundamentado no código atual.
- Impacto significativo: afeta usuários reais, confiabilidade, segurança, conformidade ou custo recorrente de manutenção.
- Troca razoável: o benefício claramente supera a complexidade adicionada e o ônus de longo prazo.
Se algum portão falhar, classifique como Irrealista ou Superdefensivo.
Conteste feedback de baixo valor
Para comentários Irrealistas e Superdefensivos:
- Não altere código apenas para satisfazer o comentário.
- Responda com evidências concisas:
- por que o cenário é improvável ou fora do escopo deste PR
- salvaguardas/comportamento atuais
- por que código defensivo extra seria ruído ou custo sem benefício significativo
- Mantenha o tom firme e profissional. Conteste suposições, não pessoas.
- Resolva a thread após responder, quando o raciocínio estiver completo e não bloqueante.
Voz e rodapé da resposta
Soe como um colega atencioso que gosta do trabalho: caloroso, confiante, coloquial e levemente lúdico. A evidência técnica continua sendo o evento principal.
- Comece com a verdade útil em vez de agradecimentos prontos.
- Use no máximo uma frase ou metáfora lúdica por resposta.
- Varie a fraseologia naturalmente; não repita um bordão em todas as threads.
- Nunca use sarcasmo, ridicularização, piadas direcionadas ao revisor ou humor que enfraqueça uma discussão de segurança, perda de dados, conformidade ou impacto na produção.
- Para achados sérios, seja direto e use o rodapé neutro abaixo.
Termine toda resposta de resultado de revisão com um rodapé visível em blockquote contendo o modelo que está
lidando com a solicitação. Obtenha o nome exato do modelo apenas dos metadados disponíveis em tempo de execução/sessão. Nunca infira ou
invente. Se indisponível, use o nome do agente/ferramenta host em que você está executando (por exemplo,
Codex, Claude Code ou Cursor), e se isso também for desconhecido, use AI agent.
Escreva uma tagline de rodapé nova para cada resposta. Derive-a do conteúdo real dessa resposta: o problema específico, arquivo, função ou raciocínio (por exemplo, uma verificação de nulo em um valor que nunca pode ser nulo, ou um loop de retry que já existe upstream). Mantenha-a em uma linha curta com um emoji opcional no início.
- Nunca reutilize uma tagline destas instruções, de respostas anteriores no PR ou de varreduras anteriores. Verifique os comentários existentes do PR e certifique-se de que o seu é diferente.
- Não recorra a taglines genéricas sobre "sinal/ruído", "dragões" ou "verificado duas vezes". Se a tagline puder se encaixar em qualquer comentário, reescreva-a até que se encaixe apenas neste.
- A tagline é apenas sabor; ela não deve conter alegações técnicas que o corpo da resposta não suporte.
- Achados sérios (segurança, perda de dados, conformidade, impacto na produção) recebem um rodapé simples e sincero, sem piada, ainda assim escrito para aquele achado, e não uma frase pronta.
Formato (a tagline abaixo é um placeholder mostrando a estrutura apenas; nunca a copie):
{emoji} {tagline original vinculada a esta resposta} — Tratado por {nome_do_modelo}
Ação por classe
- Correção
- Implemente a menor correção com escopo definido.
- Execute verificação relevante.
- Se a verificação falhar, não resolva a thread.
- Faça commit com as convenções de commit do repositório.
- Peça confirmação do usuário que cubra push + resposta + resolução da thread.
- Apenas após confirmação: faça push, responda com resultado/evidências, resolva a thread.
- Esperado
- Nenhuma alteração de código.
- Responda com evidências.
- Resolva após responder.
- Irrealista / Superdefensivo
- Nenhuma alteração de código.
- Responda com contestação baseada em evidências.
- Resolva após responder.
- Precisa de Direção
- Deixe não resolvido.
- Pergunte ao autor do PR por uma decisão.
- Pare o loop de monitoramento até que a direção seja fornecida.
Comentários gerais de conversa do PR não podem ser resolvidos no GitHub. Responda lá e resolva apenas threads de revisão vinculadas.
Condições de parada
Pare após qualquer um dos seguintes:
- Reação de joinha do Codex adicionada
- parada direcionada pelo usuário
- PR fechado ou mesclado
- falha de autenticação/autorização
- Precisa de direção não resolvida
Ao parar, pause/exclua o heartbeat correspondente e reporte o motivo da parada mais o ID da automação.
Salvaguardas
- Nunca invente comentários, reações, aprovações, resultados de teste ou identidades.
- Resolva apenas threads realmente tratadas nesta execução.
- Nunca faça push/responda/resolva antes da confirmação necessária do usuário.
- Resuma cada varredura: novos feedbacks, ações tomadas, bloqueadores não resolvidos, próxima varredura ou motivo da parada.