Direcionamento do Aurora DSQL: skills e powers

Esta seção descreve como configurar o direcionamento da IA para o Aurora DSQL usando skills e powers. Esses arquivos de configuração baseados em Markdown oferecem contexto e orientações que os assistentes de IA aplicam automaticamente ao gerar código para melhorar a qualidade do desenvolvimento agêntico.

Visão geral

Skills e powers são recursos modulares que ampliam a funcionalidade do assistente de IA para o Aurora DSQL. Eles reúnem instruções, metadados e recursos que os assistentes de IA usam automaticamente ao trabalhar com bancos de dados do Aurora DSQL.

Por que usar skills e powers

Os recursos de skills e powers oferecem vários benefícios importantes para o desenvolvimento do Aurora DSQL:

Caminhos de configuração recomendados

Escolha o caminho de configuração que corresponda ao seu ambiente de desenvolvimento:

A skill do DSQL também pode ser usada com outros agentes de codificação de IA copiando a pasta skill no diretório rules ou skills da ferramenta.

CLI de Skills

A skill do DSQL pode ser instalada usando a CLI de skills. Esse método de configuração independente de agente funciona com a maioria dos assistentes de codificação de IA e permite que você instale a skill em vários agentes ao mesmo tempo.

Configuração

Execute o seguinte comando para instalar a skill do Aurora DSQL:

npx skills add awslabs/mcp --skill dsql

A CLI oferecerá orientações para você:

Gerenciar habilidades

Verifique e atualize as skills a qualquer momento usando:

npx skills check
npx skills update

Kiro Power

Os powers do Kiro são pacotes unificados que reúnem ferramentas MCP com experiência em framework e instruções de direcionamento. Cada power inclui um documento de ponto de entrada que explica as ferramentas MCP e os acionadores de ativação disponíveis, a configuração do servidor MCP e orientações adicionais específicas do fluxo de trabalho, carregadas sob demanda.

Os powers são ativados dinamicamente com base no contexto do usuário. Em vez de carregar todas as ferramentas antecipadamente, os powers mantêm um uso básico próximo de zero até que as palavras-chave relevantes acionem a ativação.

Configuração

Para configurar um power do Kiro para o Aurora DSQL:

Claude Skill

As skills do Claude são capacidades modulares que ampliam a funcionalidade do Claude. Cada skill inclui instruções, metadados e recursos opcionais que o Claude usa automaticamente quando relevante. As skills são baseadas no sistema de arquivos e são carregadas sob demanda para minimizar o uso de contexto.

Configuração simples com a CLI de Skills

A skill pode ser instalada no Claude Code usando a CLI de Skills. Para especificar somente o Claude Code como o agente a ser instalado, use:

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

Alternativa: configuração direta usando um clone do Git

A configuração alternativa usa um clone esparso do diretório dsql-skill e cria um link simbólico desse clone na pasta ~/.claude/skills/. Isso permite que alterações na skill sejam removidas sempre que for necessário atualizar a skill.

Pré-requisitos

Etapas da configuração

1. Criar um diretório de repositórios base

mkdir -p .dsql_skill_repos

2. Usar um clone esparso da skill do repositório MCP

Clone somente a pasta dsql-skill (nenhum outro arquivo):

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. Criar um link simbólico da skill no diretório de skills

Adicione o diretório de skills (padrão: escopo global/de usuário):

mkdir -p ~/.claude/skills

Criar um link simbólico:

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

4. Verifique a configuração

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

5. Verificar o uso da skill

Assim que a skill estiver configurada, você terá um novo comando de skill: /dsql. Talvez seja necessário reiniciar o Claude Code depois de adicionar a skill, para que ela seja detectada. Você pode usar esse comando na CLI ou no painel do Claude Code, conforme desejado.

Atualizar a skill

Para obter as alterações mais recentes do repositório:

cd .dsql_skill_repos/mcp
git pull

Estrutura de diretório

Depois de configurar uma skill global, você deve ver estes diretórios:

.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

Gemini Skill

Para adicionar a skill do Aurora DSQL diretamente no Gemini, escolha um escopo: workspace (contido no projeto) ou user (padrão, global) e use o instalador de skills.

Configuração

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

Substitua $SCOPE por workspace ou user.

Você pode então usar o comando de skill /dsql com o Gemini, e o Gemini detectará automaticamente quando a skill deve ser usada.

Codex Skill

Use o instalador de skill da CLI ou TUI do Codex usando a skill $skill-installer.

Configuração

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

Reinicie o Codex para adquirir a skill. A skill pode então ser ativada usando $dsql.