Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Definir Objetivos com Clareza

Aula 6 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. A Clareza do Objetivo Determina o Resultado
  2. A Armadilha dos Objetivos Vagos
  3. Técnicas para Formular Objetivos Claros
  4. Estruturar Objetivos Complexos
  5. Pontos-chave

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:

  1. Substituir sessões de cookies por JWTs
  2. Adicionar um token de atualização com rotação
  3. Manter a rota /logout funcional
  4. 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