codex-bug

Codex Bug

Visão Geral

Diagnostique um relatório de bug do GitHub no Codex e decida a próxima ação: verificar em relação às fontes, solicitar mais informações ou explicar por que não é um bug.

Fluxo de Trabalho

1. Confirme a entrada

• Exija uma URL de issue do GitHub que aponte para github.com/openai/codex/issues/….
• Se a URL estiver ausente ou não for do repositório correto, peça ao usuário o link correto.

2. Acesso à rede

• Sempre acesse o issue pela rede imediatamente, mesmo se você achar que o acesso está bloqueado ou indisponível.
• Prefira a API do GitHub em vez de páginas HTML, pois o HTML é ruidoso:
  • Issue: https://api.github.com/repos/openai/codex/issues/<número>
  • Comentários: https://api.github.com/repos/openai/codex/issues/<número>/comments
• Se o ambiente exigir aprovação explícita, solicite-a sob demanda por meio da ferramenta e continue sem mais solicitações ao usuário.
• Somente se a tentativa de rede falhar após solicitar aprovação, explique o que você pode fazer offline (por exemplo, rascunhar um modelo de resposta) e pergunte como proceder.

3. Leia o issue

• Use as respostas da API do GitHub (issue + comentários) como fonte da verdade, em vez de raspar a página HTML do issue.
• Extraia: título, corpo, passos de reprodução, esperado vs. real, ambiente, logs e quaisquer anexos.
• Observe se o relatório já inclui logs ou detalhes da sessão.
• Se o relatório incluir um ID de thread, mencione-o no resumo e use-o para consultar os logs e detalhes da sessão, se você tiver acesso a eles.

4. Resuma o bug antes de investigar

• Antes de inspecionar código, documentação ou logs em profundidade, escreva um breve resumo do relatório com suas próprias palavras.
• Inclua o comportamento relatado, comportamento esperado, passos de reprodução, ambiente e quais evidências já estão anexadas ou ausentes.

5. Decida o curso de ação

• Verificar com fontes quando o relatório for específico e provavelmente reproduzível. Inspecione os arquivos relevantes do Codex (ou mencione os arquivos a inspecionar se o acesso estiver indisponível).
• Solicitar mais informações quando o relatório for vago, faltarem passos de reprodução ou não tiver logs/ambiente.
• Explicar que não é um bug quando o relatório contradizer o comportamento atual ou restrições documentadas (cite a evidência do issue e quaisquer fontes locais que você verificou).

6. Responda

• Forneça um relatório conciso de suas descobertas e próximos passos.