# 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: + **Especialização de assistentes de IA**: esses recursos oferecem conhecimentos de domínios específicos para o Aurora DSQL, como práticas recomendadas, padrões SQL compatíveis com Postgres e otimizações distribuídas de bancos de dados. + **Redução da repetição**: cria-se uma vez e usa-se automaticamente. Isso elimina a necessidade de fornecer repetidamente a mesma orientação em várias conversas. + **Eficiência contextual**: em vez de consumir o contexto antecipadamente, as skills são carregadas sob demanda. A IA carrega as informações em etapas, conforme necessário. + **Aprendizado contínuo**: à medida que os recursos do Aurora DSQL evoluem e as skills são atualizadas, os assistentes de IA acessam padrões atualizados automaticamente. ### Caminhos de configuração recomendados Escolha o caminho de configuração que corresponda ao seu ambiente de desenvolvimento: + [CLI de Skills](#skills-cli) (independente do agente) + [Kiro Power](#kiro-power) + [Claude Skill](#claude-skill) + [Gemini Skill](#gemini-skill) + [Codex Skill](#codex-skill) A [skill do DSQL](https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill) 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](https://skills.sh/awslabs/mcp/dsql) pode ser instalada usando a [CLI de skills](https://skills.sh/docs/cli). 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ê: + **Selecionar agentes**: escolha em quais agentes instalar (Kiro, Claude Code, Cursor, Copilot, Gemini, Codex, Roo, Cline, OpenCode, Windsurf etc.) + **Definir o escopo da instalação**: escolha entre: + Projeto: instale no diretório atual (dedicado ao seu projeto). + Global: instale no diretório inicial (disponível em todos os projetos). + **Método de instalação**: escolha entre: + Link simbólico (recomendado): única fonte confiável, atualizações fáceis. + Cópia para todos os agentes: cópias independentes para cada agente. ### 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: 1. Instale diretamente do [Kiro Powers Registry](https://kiro.dev/launch/powers/amazon-aurora-dsql/). 1. Isso conduzirá você ao power no IDE, onde você pode: + Selecionar o botão **Try Power**. Sugerido para usuários que desejam que a IA oriente a configuração do servidor MCP ou uma experiência de integração interativa com o Aurora DSQL para criar um cluster. + Abrir um novo chat do Kiro e pergunte qualquer coisa relacionada ao Aurora DSQL. Opcionalmente, atualize a configuração de MCP com os detalhes do cluster existente para testar a conexão do servidor MCP e possibilitar que ela seja usada imediatamente com o power. O agente do Kiro ativará automaticamente o power se considerar que ele é importante para concluir a tarefa do usuário. ## 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](#skills-cli). 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 + Git instalado #### 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 ``` **nota** Se você quiser definir o escopo da skill para um projeto, use o diretório raiz `.claude/skills/` do projeto em vez disso. 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 ``` **nota** Adicione `.dsql_skill_repos/` ao seu `.gitignore` se você não quiser rastreá-lo. O checkout esparso mantém apenas a pasta de skills, minimizando o uso do disco. ## 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`.