Especifique o contexto
Nesta página
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