Ir al contenido principal
Español— Elegir un idioma
Menú

Especificar el contexto

Lección 5 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. El contexto marca la diferencia
  2. El problema de los prompts sin contexto
  3. Cómo especificar el contexto eficazmente
  4. Ejemplos de antes y después
  5. Puntos clave

El contexto marca la diferencia

La calidad de las respuestas de grok-build-0.1 depende directamente de la calidad del contexto que proporciones. Un prompt vago genera una respuesta genérica. Un prompt con el contexto adecuado produce una respuesta que puedes aplicar inmediatamente a tu código.

El problema de los prompts sin contexto

Veamos un ejemplo concreto. Preguntas:

«Mejora el manejo de errores»

El modelo no sabe:

  • En qué archivo debe trabajar
  • Qué tipo de errores estás gestionando
  • Cuáles son tus códigos de error existentes
  • Cómo es la estructura de tu proyecto
  • Qué dependencias estás utilizando

Generará una respuesta genérica con bloques try/catch estándar que probablemente no encajen con tu arquitectura.

Cómo especificar el contexto eficazmente

Menciona los archivos relevantes

Editores como Cline y Cursor te permiten hacer referencia a archivos usando @. Utiliza esta función de forma consistente:

«Mis códigos de error están definidos en @errors.ts. Úsalos como referencia para añadir el manejo de errores apropiado en @sql.ts, donde estoy realizando consultas»

Ahora el modelo ve los archivos reales, entiende tus convenciones y produce código coherente con tu base de código.

Describe la estructura del proyecto

Cuando trabajas en un proyecto nuevo o en una parte del código que el modelo aún no conoce, describe brevemente la estructura:

«El proyecto usa Express con TypeScript. Las rutas están en src/routes/, los servicios en src/services/ y los tipos en src/types/. Estoy trabajando en el servicio de autenticación».

Especifica las dependencias

Si tu código utiliza bibliotecas específicas, menciónalas:

«Estoy usando Zod para validación, Drizzle para el ORM y Pino para el registro de eventos. Añade validación al esquema de entrada en @api/users.ts»

Excluye lo irrelevante

Excluir lo que no es relevante es tan importante como incluir el contexto correcto. Si haces referencia a 15 archivos para un cambio sencillo, el modelo puede perderse. Céntrate en los archivos directamente implicados.

Ejemplos de antes y después

Generación de pruebas

Sin contexto: «Escribe pruebas para mi función de validación»

Con contexto: «Escribe pruebas con Vitest para la función validateUser en @src/validators/user.ts. Los datos de prueba están en @tests/fixtures/users.json. Usa el mismo patrón que en @tests/validators/product.test.ts»

Refactorización

Sin contexto: «Refactoriza este código para que quede más limpio»

Con contexto: «Extrae la lógica de reintentos en @src/api/client.ts (líneas 45-78) a un helper reutilizable en @src/utils/retry.ts. Los demás clientes de API en @src/api/ también deberían poder usarlo»

Puntos clave

  • Haz referencia siempre a los archivos relevantes con @
  • Describe la estructura del proyecto cuando sea necesario
  • Menciona las dependencias y convenciones que utilizas
  • Excluye la información irrelevante para evitar ruido
  • Cuanto más preciso sea el contexto, más directamente podrás aplicar la respuesta