Como revisar código com achados verificáveis.
Uma revisão deve conectar achados a comportamentos ou riscos específicos. Evite tratar preferências de estilo como defeitos sem uma convenção do projeto.
Adapte o fluxo à sua tarefa.
Revise o código pelo comportamento esperado e pelas convenções, ligando achados a linhas ou casos específicos. Diferencie defeitos, riscos relevantes e sugestões opcionais de estilo, com um exemplo reproduzível quando possível.
- O que você fornece
- Diff do código e convenções do projeto.
- O que você recebe
- Possíveis defeitos e achados de manutenibilidade com referências.
Veja a entrada e o resultado.
Entrada e saída ilustrativas · exemplo didático, não uma execução real do WebAct
Exemplo campo
Python code review: def average(total, count): return total / count. No zero-count contract supplied.
Exemplo completo
Finding: count=0 raises ZeroDivisionError. Reproduction: average(10, 0). Contract question: should an empty set return a designated value or raise a deliberate domain error? Proposed action: define that behavior and add a zero-count test before changing the implementation. Ordinary nonzero division is not itself identified as a defect.
Carregue esta entrada no prompt e copie para o WebAct para testar a tarefa. Seu resultado pode ser diferente da ilustração.
Decisões e solução de problemas.
Preferências de estilo devem ser relatadas como bugs?
Classifique-as conforme as convenções do projeto. Uma preferência é diferente de um comportamento que descumpre um requisito.
Por que a revisão aponta um problema que os chamadores já evitam?
Examine o contrato da função e os locais de chamada. Declare a hipótese em vez de avaliar o trecho como se não tivesse contexto.
Teste com sua própria fonte.
Substitua o exemplo pelo seu material no prompt. Mantenha os requisitos necessários e copie a tarefa para o WebAct.
Personalizar e copiar a tarefa ↑