Registro de skills
Flujos de desarrolloSkills públicas

Database Operations

Operaciones seguras de base de datos para agentes de IA — inspección de esquema, consultas solo lectura, análisis de rendimiento, migraciones gobernadas y exploración de datos vía Supabase, PlanetScale, Neon o cualquier base SQL.

Qué enseña esta habilidad

Un manual reutilizable para un tipo específico de trabajo.

Un servidor MCP indica a un agente qué acciones están disponibles. Una habilidad añade el juicio alrededor de esas acciones: cómo reconocer el trabajo, qué secuencia seguir, qué evitar y cómo decidir que el resultado está completo.

Orquesta operaciones de bases de datos — inspecciona esquemas, consulta datos de forma segura, analiza rendimiento, gestiona migraciones y explora patrones de datos. Úsalo para consultar bases de datos, inspeccionar esquemas de tablas, analizar consultas lentas, ejecutar migraciones, verificar uso de índices o explorar distribuciones de datos.

Arquitectura

Cómo Database Operations guía a un agente ADK-Rust.

La habilidad se mantiene legible y portátil porque contiene instrucciones en lugar de credenciales de servicio o datos de negocio. ADK-Rust la suministra al agente, el agente elige dentro de su límite de herramientas revisado y el servidor MCP conectado realiza la operación autenticada.

01

Solicitud del usuario

El agente recibe un objetivo expresado en lenguaje común.

02

Habilidad Database Operations

Coincide con la intención, suministra la guía de decisiones y limita el límite de herramientas.

03

Agente ADK-Rust

Planifica el flujo de trabajo y transmite cada paso significativo a través del entorno de ejecución.

04

mcp-database

Ejecuta operaciones autenticadas contra el sistema que posee la capacidad.

05

Resultado verificado

Las reglas de finalización de la habilidad moldean la evidencia devuelta al usuario.

Instrucciones portátiles: SKILL.md · Límite de capacidad: mcp-database · Herramientas permitidas: 22

Guía de decisiones

Cómo el agente convierte una solicitud en la acción correcta.

Estas rutas provienen directamente de las instrucciones de la habilidad. Ayudan al modelo a reconocer la intención y seleccionar una herramienta o flujo de trabajo enfocado en lugar de improvisar en toda la superficie de capacidad.

01

¿"schema", "tables", "columns", "structure"?

WORKFLOW 1: Inspección de Esquema

02

¿"query", "select", "find data", "show me"?

WORKFLOW 2: Consultas Seguras

03

¿"slow", "performance", "optimize", "index"?

WORKFLOW 3: Análisis de Rendimiento

04

¿"migrate", "alter", "add column", "create table"?

WORKFLOW 4: Migraciones

05

¿"insert", "update", "delete", "write"?

WORKFLOW 5: Escrituras Gobernadas

06

¿No está claro?

listar_tablas primero para entender la base de datos

Flujos de trabajo probados

Secuencias repetibles para resultados útiles.

Un flujo de trabajo une varias llamadas a herramientas en una tarea que el usuario realmente reconoce. La habilidad explica la secuencia y el resultado esperado mientras ADK-Rust transmite el progreso del agente a través del entorno de ejecución compartido.

012-4 llamadas

Inspección de Esquema

Entender la estructura antes de actuar

022-3 llamadas

Consultas Seguras

Solo lectura con LIMIT y EXPLAIN

033-4 llamadas

Análisis de Rendimiento

Detectar consultas lentas + índices faltantes

043-4 llamadas

Migraciones

Generar → validar → aplicar con reversión

053 llamadas

Escrituras Gobernadas

Validar → explicar alcance → ejecutar

Límite de herramienta

La habilidad puede usar 22 herramientas documentadas.

Esta lista blanca es declarada por la habilidad. Mantiene al agente enfocado en las acciones necesarias para este trabajo mientras mcp-database retiene la responsabilidad de autenticación, validación y el sistema conectado.

list_tables
describe_table
get_relationships
list_indexes
get_database_stats
search_schema
query
sample_data
filter_table
explain_query
get_column_stats
execute
create_index
run_migration
list_migrations
get_slow_queries
get_connections
get_maintenance_status
get_index_usage
generate_schema
get_er_diagram
validate_sql

Reglas de trabajo

Qué debe hacer el agente.

  • Sigue la guía de decisiones, usa el límite de herramienta declarado y verifica el resultado antes de responder.

Límites operativos

Qué debe evitar el agente.

  • Revisa el SKILL.md completo antes de habilitar esta habilidad para trabajo en producción.

Instalar y conectar

Agrega la habilidad junto a la capacidad que espera.

Instala el repositorio donde tu cargador de habilidades ADK-Rust pueda descubrirlo, conecta mcp-database y confirma que las herramientas declaradas están disponibles antes de pedir al agente que use el flujo de trabajo.

Instalar la habilidad
git clone https://github.com/zavora-ai/skill-database-operations.git \
  ~/.skills/skills/database-operations
Forma de carga ADK-Rust
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("database-operations").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

La declaración de compatibilidad del repositorio: Requiere conexión al servidor mcp-database (Supabase, PlanetScale, Neon o API personalizada).

Documentación oficial

Lee el paquete completo de la habilidad.

El repositorio sigue siendo la autoridad para sus instrucciones exactas, ejemplos, scripts auxiliares, recursos, requisitos MCP, licencia y actualizaciones posteriores.

Registro de origen

Metadatos del repositorio para esta entrada de habilidad.

Ver repositorio público ↗
Licencia
Apache-2.0
Herramientas permitidas
22
Referencias
3
Revisión
565646477a6f
Actualizado
31 may 2026