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

Especifique o contexto

Aula 5 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. O contexto faz a diferença
  2. O problema dos prompts sem contexto
  3. Como especificar o contexto de forma eficaz
  4. Exemplos de antes/depois
  5. Pontos-chave

O contexto faz a diferença

A qualidade das respostas do grok-build-0.1 depende diretamente da qualidade do contexto que você fornece. Um prompt vago gera uma resposta genérica. Um prompt com o contexto certo produz uma resposta que você pode aplicar imediatamente ao seu código.

O problema dos prompts sem contexto

Eis um exemplo concreto. Você pergunta:

“Melhore o tratamento de erros”

O modelo não sabe:

  • Em qual ficheiro trabalhar
  • Que tipo de erros está a tratar
  • Quais são os seus códigos de erro existentes
  • Como é a estrutura do seu projeto
  • Que dependências está a utilizar

Ele produzirá uma resposta genérica com blocos try/catch padrão que, provavelmente, não corresponderão à sua arquitetura.

Como especificar o contexto de forma eficaz

Mencione os ficheiros relevantes

Editores como o Cline e o Cursor permitem referenciar ficheiros usando @. Utilize esta funcionalidade de forma consistente:

“Os meus códigos de erro estão definidos em @errors.ts. Use-os como referência para adicionar o tratamento de erros adequado em @sql.ts, onde estou a fazer consultas”

O modelo vê agora os ficheiros reais, compreende as suas convenções e produz código consistente com a sua base de código.

Descreva a estrutura do projeto

Quando trabalha num projeto novo ou numa parte do código que o modelo ainda não conhece, descreva brevemente a estrutura:

“O projeto usa Express com TypeScript. As rotas estão em src/routes/, os serviços em src/services/ e os tipos em src/types/. Estou a trabalhar no serviço de autenticação.”

Especifique as dependências

Se o seu código utiliza bibliotecas específicas, mencione-as:

“Estou a usar Zod para validação, Drizzle para o ORM e Pino para registo (logging). Adicione validação ao esquema de entrada em @api/users.ts”

Exclua o que é irrelevante

Excluir o que não é relevante é tão importante quanto incluir o contexto certo. Se referenciar 15 ficheiros para uma alteração simples, o modelo pode perder-se. Foque-se nos ficheiros diretamente envolvidos.

Exemplos de antes/depois

Geração de testes

Sem contexto: “Escreva testes para a minha função de validação”

Com contexto: “Escreva testes Vitest para a função validateUser em @src/validators/user.ts. Os dados de teste (fixtures) estão em @tests/fixtures/users.json. Use o mesmo padrão de @tests/validators/product.test.ts”

Refatorização

Sem contexto: “Refatore este código para o tornar mais limpo”

Com contexto: “Extraia a lógica de repetição (retry) em @src/api/client.ts (linhas 45-78) para um auxiliar reutilizável em @src/utils/retry.ts. Os outros clientes API em @src/api/ também devem poder usá-lo”

Pontos-chave

  • Referencie sempre os ficheiros relevantes com @
  • Descreva a estrutura do projeto quando necessário
  • Mencione as dependências e convenções que utiliza
  • Exclua informações irrelevantes para evitar ruído
  • Quanto mais preciso for o contexto, mais diretamente poderá aplicar a resposta