Definir Objetivos com Clareza
Nesta página
A Clareza do Objetivo Determina o Resultado
Um prompt eficaz para o grok-build-0.1 não se limita a dizer o que fazer; descreve o que pretende alcançar. A diferença é subtil, mas fundamental: o «o quê» deixa o modelo a adivinhar as suas expectativas, enquanto o «resultado esperado» fornece-lhe um alvo preciso.
A Armadilha dos Objetivos Vagos
Veja este exemplo:
“Criar um registador de alimentação”
O modelo tem de adivinhar: que tipo de interface? Quais as funcionalidades? Que nível de detalhe para o registo? Que tecnologia? Vai produzir algo, mas será a visão dele sobre o projeto, não a sua.
Agora, com um objetivo claro:
“Criar um registador de alimentação que mostre a decomposição diária de calorias por nutriente quando eu introduzir um alimento. Quero uma visão geral e tendências de alto nível.”
O modelo sabe exatamente o que espera: introdução de alimentos, cálculo de calorias, decomposição de nutrientes, visão diária e tendências. Pode produzir um resultado relevante desde a primeira iteração.
Técnicas para Formular Objetivos Claros
Descrever o Resultado Final
Em vez de descrever a ação («adicionar uma funcionalidade»), descreva o que o utilizador verá ou o que o código fará:
- Vago: «Adicionar paginação»
- Claro: «Quando a lista exceder 20 itens, apresentar botões Anterior/Seguinte na parte inferior. A página atual deve estar destacada. O URL deve refletir a página ativa com ?page=N»
Especificar Restrições
As restrições eliminam a ambiguidade:
- «Sem adicionar novas dependências»
- «Manter a compatibilidade retroativa com a API v1»
- «O tempo de resposta deve manter-se abaixo de 200 ms»
- «Compatível com Node.js 18+»
Fornecer Exemplos de Entrada/Saída
Ao trabalhar na transformação de dados ou numa função utilitária, um exemplo vale mais do que mil palavras:
“Criar uma função que transforme um slug num título. Exemplo: ‘my-blog-post’ → ‘My Blog Post’. As palavras de ligação (of, the, a) não devem ser capitalizadas, a menos que estejam na primeira posição.”
Especificar o Que Não Quer
Por vezes, dizer o que não quer é tão útil como dizer o que quer:
“Refatorar o componente para usar hooks, mas não alterar a interface pública (as props). Os testes existentes devem continuar a passar sem modificações.”
Estruturar Objetivos Complexos
Para pedidos que envolvam múltiplas alterações, estruture os seus objetivos em passos ou pontos:
“Quero modernizar o sistema de autenticação:
- Substituir sessões de cookies por JWTs
- Adicionar um token de atualização com rotação
- Manter a rota /logout funcional
- Os tokens expiram após 15 minutos”
Cada ponto é um objetivo mensurável que o modelo pode verificar.
Pontos-chave
- Descreva o resultado esperado, não apenas a ação a tomar
- Adicione restrições para eliminar a ambiguidade
- Forneça exemplos de entrada/saída quando relevante
- Liste o que não pretende modificar
- Estruture objetivos complexos em pontos numerados