Prompts de código que funcionam (depuração, refatoração, testes)

Como parar de receber respostas genéricas: exija diffs, restrições e checklists de teste.

Última atualização: · Versão em Markdown

Seja concreto

  • Forneça um trecho mínimo que reproduza o problema + o esperado vs. o obtido.
  • Exija uma estrutura de saída (passos, diff, checklist).
  • Inclua restrições de ambiente e de versão.
  • Peça casos de borda + testes.

Antes → depois: um pedido de depuração

  • Antes: "Minha função não funciona, conserte." O modelo precisa adivinhar a linguagem, o sintoma e o que significa 'funcionar', então reescreve a função de forma genérica.
  • Depois: "Bug: o total sai com um a menos quando a lista tem um único item. Ambiente: Node 20, TypeScript 5. Esperado: 10. Obtido: 9. Reprodução mínima abaixo. Retorne a causa, a correção como diff e um teste que falhe antes e passe depois."
  • O que mudou: sintoma, ambiente, esperado versus obtido, uma reprodução mínima e a entrega exata agora estão declarados.

Confira a resposta antes de confiar nela

  • Rode o código e os testes que ele propõe. Uma explicação confiante não prova que a correção funciona.
  • Peça um diff ou só as partes alteradas, para revisar uma mudança pequena em vez de um arquivo reescrito.
  • Mude uma coisa por pedido. Se você pedir uma refatoração, uma funcionalidade nova e uma correção de bug ao mesmo tempo, não vai saber qual mudança quebrou o quê.
  • Pergunte do que ele não tem certeza ('liste as suposições que você fez'): é das suposições que saem as correções erradas.

Templates

Refatoração com invariantes

Refatore este código mantendo o comportamento idêntico.

Restrições:
- Não altere a API pública.
- Mantenha a complexidade de execução <= a atual.
- Prefira funções pequenas + nomes mais claros.

Código:
"""[cole aqui]"""

Retorne:
1) justificativa breve
2) diff/trecho (só as partes alteradas)
3) checklist de testes (o que cobrir)
Abre o analisador com o prompt já preenchido.

Depuração com esperado vs. obtido

Bug: [descrição em uma linha]
Ambiente: [linguagem, runtime, versões dos frameworks]
Esperado: [o que deveria acontecer]
Obtido: [o que acontece; cole o erro ou o stack trace]

Reprodução mínima:
"""[código]"""

Retorne:
1) a causa mais provável, em duas frases
2) a correção mínima como diff (só as linhas alteradas)
3) um teste que falhe antes da correção e passe depois
4) as suposições que você fez, para eu poder conferir
Abre o analisador com o prompt já preenchido.

Perguntas frequentes

Como consigo um diff de verdade?
Peça 'só as partes alteradas' e especifique o contexto do arquivo. Se possível, inclua os nomes dos arquivos.
Devo colar o arquivo inteiro?
Cole o menor trecho que reproduza o problema, mais as assinaturas das quais ele depende. Um arquivo inteiro acrescenta ruído e pode tirar o foco das linhas relevantes.
Como evito que ele reescreva tudo?
Declare as invariantes ('não altere a API pública') e peça o diff mínimo. Dizer o que precisa continuar igual funciona melhor do que pedir que ele 'tome cuidado'.