# Instrucciones para el agente: Exploración SQL: consulta datos de prueba con un agente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Guía completa: https://lab.wisd.ai/hub/narwhal-db-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Prepara una prueba acotada

Define una pregunta que puedas resolver con el dataset público del inicio rápido. Usa después una copia de prueba si necesitas datos propios.

### Configura Spice

Sigue [Spice](/hub/spice-ai-sidecar), incluidos sus requisitos, configuración y comprobación actuales. Completa el inicio rápido en la misma carpeta de proyecto y comprueba la tabla y consulta del conjunto público antes de usar datos propios.

### Configura Supabase Agent Skills

Sigue [Supabase Agent Skills](/hub/supabase-agent-skills), incluidos sus requisitos, configuración y comprobación actuales. Carga la skill de PostgreSQL en el arnés y comprueba que una revisión de SQL aplica sus instrucciones y declara motor y supuestos.

## Datos que pasan entre piezas

Los archivos siguientes son entregables de este caso preparados por el agente; no implican exportadores ni sincronización automática.

Pasa de Spice al agente esquema.md con tablas, columnas, motor y origen del conjunto de prueba; la skill de Supabase revisa únicamente criterios aplicables a ese motor. Devuelve consulta.sql y resultado.csv con fecha y consulta aprobada; sin esquema o resultado de referencia detén la ejecución, y no supongas una conexión MCP creada por la skill.

## Monta el flujo

### Paso 1

Instala Spice, inicia el runtime y añade el dataset desde una segunda terminal en la misma carpeta, como indica su guía. Comprueba las tablas y la consulta de ejemplo antes de conectar al agente.

### Paso 2

Instala la skill de PostgreSQL y entrega al agente el esquema revisado. Pide una consulta con columnas explícitas y resultado acotado; usa sus recomendaciones solo cuando correspondan al motor real.

### Paso 3

Revisa la consulta, ejecútala sobre el conjunto de prueba y conserva SQL, origen y fecha del resultado. Para una fuente propia sigue el conector oficial y verifica lectura restringida antes de repetir el proceso.

## Comprobación

Compara una consulta con un resultado conocido. Confirma el esquema utilizado y comprueba por separado que el usuario de origen no dispone de escritura.

## Si algo falla

Si el SQL falla, identifica primero el dialecto y las tablas visibles. Si no hay claves documentadas, devuelve relaciones como hipótesis y solicita el esquema correcto.

La configuración se consulta en las guías del hub enlazadas. Esta composición es una propuesta de WISD; no se ha ejecutado como prueba integral.

## Prompt para tu agente

Piezas del flujo: [Spice](/hub/spice-ai-sidecar) · [Supabase Agent Skills](/hub/supabase-agent-skills).

```text
Lee y sigue las instrucciones publicadas de las piezas: Spice: /hub/spice-ai-sidecar/instrucciones.md; Supabase Agent Skills: /hub/supabase-agent-skills/instrucciones.md. Completa los requisitos, configuración y comprobación de cada pieza antes de usarla; comprueba su uso desde el cliente o arnés elegido, no solo su presencia en disco. Si falta un campo entre <>, una fuente obligatoria, acceso o una operación documentada, detén la etapa dependiente, informa qué falta y pídemelo; usa una alternativa manual solo cuando esté descrita y comprobada. No inventes datos ni des por superada una comprobación pendiente.

Para <pregunta>, prepara en Spice <dataset de prueba autorizado> siguiendo su guía. Comprueba esquema y ejemplo antes de conectar el agente. Usa Supabase Agent Skills para revisar SQL cuando el destino sea PostgreSQL. Propón columnas explícitas y resultado limitado; espera revisión antes de ejecutar. Contrasta con <resultado conocido> y guarda SQL, origen, fecha y resultado en <ruta>. No inventes relaciones ni conectes fuentes adicionales.

Pasa de Spice al agente esquema.md con tablas, columnas, motor y origen del conjunto de prueba; la skill de Supabase revisa únicamente criterios aplicables a ese motor. Devuelve consulta.sql y resultado.csv con fecha y consulta aprobada; sin esquema o resultado de referencia detén la ejecución, y no supongas una conexión MCP creada por la skill.
```