View a markdown version of this page

Dirección de Aurora DSQL: Skills y Powers - Amazon Aurora DSQL
Descripción generalCLI de SkillsKiro PowerClaude SkillGemini SkillCodex Skill

Dirección de Aurora DSQL: Skills y Powers

En esta sección se describe cómo configurar la dirección de IA para Aurora DSQL utilizando Skills y Powers. Estos archivos de configuración basados en Markdown proporcionan contexto y orientación que los asistentes de IA aplican automáticamente al generar código para mejorar la calidad del desarrollo de los agentes.

Descripción general

Los Skills y Powers son capacidades modulares que amplían la funcionalidad del asistente de IA para Aurora DSQL. Incluyen instrucciones, metadatos y recursos que los asistentes de IA utilizan automáticamente cuando trabajan con las bases de datos de Aurora DSQL.

Por qué usar Skills y Powers

Los Skills y Powers proporcionan varias ventajas clave para el desarrollo de Aurora DSQL:

  • Asistentes de IA especializados: ofrecen conocimientos especializados específicos del dominio para Aurora DSQL, incluidas las prácticas recomendadas, los patrones SQL compatibles con Postgres y las optimizaciones de bases de datos distribuidas.

  • Reducción de repetición: cree una vez y úselo de forma automática. Elimina la necesidad de proporcionar repetidamente la misma orientación en varias conversaciones.

  • Eficiencia contextual: las Skills se cargan bajo demanda en lugar de consumir contexto por adelantado. La IA carga la información por etapas según se necesita.

  • Aprendizaje continuo: a medida que evolucionan las funciones de Aurora DSQL, los asistentes de IA acceden automáticamente a los patrones actualizados cuando se actualizan las Skills.

Elija la ruta de configuración que se adapte a su entorno de desarrollo:

La Skill de DSQL también se puede usar con otros agentes de codificación de IA copiando la carpeta de Skills en las rules de la herramienta o el directorio de skills.

CLI de Skills

La Skill de DSQL se puede instalar mediante la CLI de Skills. Este método de configuración independiente de agente funciona con la mayoría de los asistentes de codificación de IA y le permite instalar la Skill en varios agentes a la vez.

Configuración

Ejecute el siguiente comando para instalar la Skill de Aurora DSQL: 

npx skills add awslabs/mcp --skill dsql

La CLI lo guiará a través de lo siguiente:

  • Selección de agentes: elija en qué agentes desea instalar (Kiro, Claude Code, Cursor, Copilot, Gemini, Codex, Roo, Cline, OpenCode, Windsurf, etc.).

  • Alcance de la instalación: elija entre las siguientes opciones:

    • Proyecto: instalación en el directorio actual (asignado a su proyecto)

    • Global: instalación en el directorio principal (disponible para todos los proyectos)

  • Método de instalación: elija entre las siguientes opciones:

    • Enlace simbólico (recomendado): fuente única de información veraz, actualizaciones sencillas

    • Copia para todos los agentes: copias independientes para cada agente

Administración de Skills

Compruebe y actualice sus Skills en cualquier momento mediante: 

npx skills check
npx skills update

Kiro Power

Los Powers de Kiro son paquetes unificados que incluyen herramientas de MCP con experiencia en marcos e instrucciones de dirección. Cada Power incluye un documento de punto de entrada que explica las herramientas MCP disponibles y los desencadenantes de activación, la configuración del servidor MCP y orientación adicional específica del flujo de trabajo cargada bajo demanda.

Los Powers se activan de forma dinámica en función del contexto del usuario. En lugar de cargar todas las herramientas por adelantado, los Powers mantienen un uso básico prácticamente nulo hasta que las palabras clave relevantes activen la activación.

Configuración

Para configurar el Kiro Power para Aurora DSQL:

  1. Instálelo directamente desde el registro de Powers de Kiro.

  2. Una vez redirigido al Power en el IDE, puede:

    • Seleccionar el botón Try Power (Probar Power). Recomendado para usuarios que desean que la IA les guíe en la configuración del servidor MCP o que buscan una experiencia de incorporación interactiva con Aurora DSQL para crear un nuevo clúster.

    • Abra un nuevo chat de Kiro y pregunte cualquier cosa relacionada con Aurora DSQL. Si lo desea, actualice la configuración de MCP con los datos de su clúster actual para probar la conexión del servidor MCP, de modo que pueda utilizarse inmediatamente con el Power. El agente de Kiro activará automáticamente el Power si lo identifica como valioso para completar la tarea del usuario.

Claude Skill

Las Skills de Claude son capacidades modulares que amplían la funcionalidad de Claude. Cada Skill incluye instrucciones, metadatos y recursos opcionales que Claude usa automáticamente cuando es relevante. Las Skills se basan en un sistema de archivos y se cargan bajo demanda para minimizar el uso del contexto.

Configuración sencilla con la CLI de Skills

La Skill se puede instalar en Claude Code mediante la CLI de Skills. Para especificar únicamente Claude Code como agente en el que realizar la instalación, utilice: 

npx skills add awslabs/mcp --skill dsql --agent claude-code

Alternativa: configuración directa mediante un clon de Git

La configuración alternativa toma un clon disperso del directorio dsql-skill y crea un enlace simbólico de este clon en la carpeta de ~/.claude/skills/. Esto permite realizar cambios en la Skill siempre que sea necesario actualizarla.

Requisitos previos

  • Git instalado

Pasos de configuración

1. Cree un directorio de repositorios base 

mkdir -p .dsql_skill_repos

2. Clone de forma dispersa la Skill desde el repositorio de MCP

Clone solo la carpeta de dsql-skill (no otros archivos): 

cd .dsql_skill_repos
git clone --filter=blob:none --no-checkout https://github.com/awslabs/mcp.git
cd mcp
git sparse-checkout init --cone
git sparse-checkout set src/aurora-dsql-mcp-server/skills/dsql-skill
git checkout
cd ../..

3. Aplique un enlace simbólico de la Skill al directorio de Skills

Añada el directorio de Skills (predeterminado: global/orientado al usuario): 

mkdir -p ~/.claude/skills
nota

Si desea que esta sea una Skill específica del proyecto, utilice el directorio raíz de .claude/skills/ del proyecto.

Añada el enlace simbólico: 

ln -s "$(pwd)/.dsql_skill_repos/mcp/src/aurora-dsql-mcp-server/skills/dsql-skill" ~/.claude/skills/dsql-skill

4. Verifique la configuración 

# Should show SKILL.md and other skill files
ls -la ~/.claude/skills/dsql-skill/

5. Verifique el uso de la Skill

Una vez configurada la Skill, de tener un nuevo comando de esta: /dsql. Es posible que deba reiniciar Claude Code después de añadir la habilidad para que pueda detectarse. Puede utilizar este comando desde la CLI o el panel de Claude Code, según sus preferencias.

Actualización de la Skill

Para obtener los cambios más recientes del repositorio: 

cd .dsql_skill_repos/mcp
git pull

Estructura de directorios

Tras configurar una Skill global, debería ver estos directorios: 

.dsql_skill_repos/
└── mcp/                              # Sparse git checkout
    └── src/
        └── aurora-dsql-mcp-server/
            └── skills/
                └── dsql-skill/
                    ├── SKILL.md
                    └── ...

~/.claude/
└── skills/
    └── dsql-skill -> /path/to/.dsql_skill_repos/mcp/src/aurora-dsql-mcp-server/skills/dsql-skill
nota

Añada .dsql_skill_repos/ a su .gitignore si no desea realizar rastrearlo. El checkout disperso solo conserva la carpeta de Skills, lo que minimiza el uso del disco.

Gemini Skill

Para añadir la Skill de Aurora DSQL directamente en Gemini, elija un ámbito: workspace (contenido en el proyecto) o user (predeterminado, global) y utilice el instalador de Skills.

Configuración

gemini skills install https://github.com/awslabs/mcp.git --path src/aurora-dsql-mcp-server/skills/dsql-skill --scope $SCOPE

Sustituya $SCOPE por workspace o user.

A continuación, puede utilizar el comando de Skill /dsql con Gemini, y Gemini detectará automáticamente cuándo debe utilizarse la Skill.

Codex Skill

Utilice el instalador de Skill desde la TUI o CLI de Codex utilizando la Skill $skill-installer.

Configuración

$skill-installer install dsql skill: https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill

Reinicie Codex para obtener la Skill. Luego, la Skill se puede activar usando $dsql.