Escrever solicitações eficazes

Uma solicitação útil informa o resultado esperado, o contexto relevante, os limites e como o agente deve verificar a conclusão.

Comece pelo resultado

Descreva o que deve ser verdadeiro quando o trabalho estiver concluído. Dê nome ao comportamento ou componente afetado em vez de pedir ao agente para “corrigir o código” ou “melhorar tudo”.

Update the checkout total so an empty cart returns zero. Preserve the existing
function signature and add a test for the empty-cart case.

Adicione contexto focado

Anexe o arquivo ou pasta que ancora a solicitação quando você os conhecer. Inclua saídas do terminal ou alterações do Git quando explicarem uma falha ou um alvo de revisão.

Não anexe arquivos sem relação apenas para fornecer mais contexto. Uma solicitação focada é mais fácil de investigar e verificar.

Defina limites

Mencione interfaces que devem permanecer compatíveis, arquivos que não devem mudar, comandos que exigem cautela e qualquer formato de saída esperado.

Escolha um agente cujas instruções e permissões correspondam ao trabalho. Use um agente de planejamento ou o Plan Review quando a direção da implementação precisar de alinhamento antes das edições.

Defina a verificação

Diga o teste, build, verificação ou comportamento observável que demonstra a conclusão. Se o comando esperado não puder ser executado no ambiente, peça que o agente relate essa limitação explicitamente.

Revise o resultado e as evidências antes de continuar. Refine a mesma sessão com feedback específico quando o primeiro resultado não atingir o objetivo declarado.