Hackcat

Como enviar um trecho de código para explicação ou revisão?

Delimite o âmbito para que a resposta diferencie observações do código de conclusões de execução.

Limite o âmbito do código

Forneça primeiro a função ou o trecho relevante para revisão e informe a linguagem, a forma de chamada e o comportamento esperado. Se o problema depende de configuração, formato da entrada ou outras funções, inclua o contexto mínimo necessário. Diga claramente se quer entender o fluxo de controlo, as condições de contorno ou os problemas potenciais, evitando que a resposta vire uma lista genérica de verificação do projeto inteiro.

Defina objetivos específicos para a revisão

Pode escrever: “Explique como esta função trata uma entrada vazia e aponte os casos de contorno que precisam de teste”. Se quiser sugestões de alterações, peça que sejam explicados os motivos e o impacto esperado. Ao colar código diretamente ou anexá-lo pelas opções disponíveis, confira sempre a indentação e os nomes dos ficheiros; não inclua chaves reais ou segredos só por conveniência.

  1. Forneça o código relevante, a linguagem e os resultados esperados.
  2. Descreva o comportamento real ou os riscos que mais preocupam.
  3. Peça que descobertas, sugestões e métodos de verificação sejam listados separadamente.

Confirme quais etapas da revisão foram concluídas

Conclusões obtidas apenas pela leitura do código são análise estática e não significam que testes foram executados. Se a resposta disser que o programa foi executado, confira as saídas correspondentes das ferramentas; se o ambiente não estiver disponível, peça uma lista das partes não verificadas. Antes de adotar alterações, ainda é necessário conferir o comportamento num ambiente adequado, principalmente se entradas normais e tratamento de erros atendem às expectativas.