Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Aurora DSQL Steering: competenze e poteri Questa sezione descrive come configurare lo sterzo AI per Aurora DSQL utilizzando competenze e poteri. Questi file di configurazione basati su markdown forniscono un contesto e una guida che gli assistenti AI applicano automaticamente durante la generazione del codice per migliorare la qualità dello sviluppo agentico. ## Panoramica di Le competenze e i poteri sono funzionalità modulari che estendono le funzionalità dell'assistente AI per Aurora DSQL. Raccolgono istruzioni, metadati e risorse che gli assistenti AI utilizzano automaticamente quando lavorano con i database Aurora DSQL. ### Perché usare competenze e poteri Le competenze e le competenze offrono diversi vantaggi chiave per lo sviluppo di Aurora DSQL: + **Assistenti AI specializzati**: fornisci competenze specifiche del dominio per Aurora DSQL, tra cui best practice, modelli SQL compatibili con Postgres e ottimizzazioni di database distribuiti. + **Riduci** le ripetizioni: crea una sola volta, usa automaticamente. Elimina la necessità di fornire ripetutamente la stessa guida in più conversazioni. + **Efficienza contestuale**: le competenze vengono caricate su richiesta anziché utilizzare il contesto in anticipo. L'intelligenza artificiale carica le informazioni gradualmente secondo necessità. + **Apprendimento continuo**: man mano che le funzionalità di Aurora DSQL si evolvono, gli assistenti AI accedono automaticamente ai modelli aggiornati quando le competenze vengono aggiornate. ### Percorsi di configurazione consigliati Scegliete il percorso di configurazione adatto al vostro ambiente di sviluppo: + [Competenze CLI](#skills-cli)(Agent-Agnostic) + [Kiro Power](#kiro-power) + [Claude Skill](#claude-skill) + [Abilità Gemini](#gemini-skill) + [Abilità Codex](#codex-skill) La [Skill DSQL](https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill) può essere utilizzata anche con altri agenti di codifica AI copiando la cartella delle abilità nella cartella o nella directory dello strumento. `rules` `skills` ## Competenze CLI La [skill DSQL](https://skills.sh/awslabs/mcp/dsql) può essere installata utilizzando la [CLI Skills](https://skills.sh/docs/cli). Questo metodo di configurazione indipendente dall'agente funziona con la maggior parte degli assistenti di codifica AI e consente di installare la skill su più agenti contemporaneamente. ### Configurazione Esegui il comando seguente per installare la skill Aurora DSQL: ``` npx skills add awslabs/mcp --skill dsql ``` La CLI ti guiderà attraverso: + **Selezione degli agenti**: scegli su quali agenti eseguire l'installazione (Kiro, Claude Code, Cursor, Copilot, Gemini, Codex, Roo, Cline, Windsurf, ecc.) OpenCode + **Ambito** di installazione: scegli tra: + Progetto: Installazione nella cartella corrente (inserita nel progetto) + Globale: installa nella home directory (disponibile in tutti i progetti) + **Metodo di installazione**: scegli tra: + Symlink (consigliato): unica fonte di verità, aggiornamenti semplici + Copia per tutti gli agenti: copie indipendenti per ogni agente ### Gestione delle competenze Controlla e aggiorna le competenze in qualsiasi momento utilizzando: ``` npx skills check npx skills update ``` ## Kiro Power I Kiro power sono pacchetti unificati che combinano strumenti MCP con competenze di framework e istruzioni di guida. Ogni power include un documento introduttivo che spiega gli strumenti MCP disponibili e i trigger di attivazione, la configurazione del server MCP e linee guida aggiuntive specifiche per il flusso di lavoro caricate su richiesta. I poteri si attivano dinamicamente in base al contesto dell'utente. Anziché caricare tutti gli strumenti in anticipo, Power mantiene un utilizzo di base vicino allo zero fino a quando le parole chiave pertinenti non attivano l'attivazione. ### Configurazione Per configurare la potenza di Kiro per Aurora DSQL: 1. [Installa direttamente dal registro di Kiro Powers](https://kiro.dev/launch/powers/amazon-aurora-dsql/) 1. Una volta reindirizzato a Power in the IDE, puoi: + Seleziona il pulsante **Try Power**. Consigliato agli utenti che desiderano che l'intelligenza artificiale guidi la configurazione del server MCP o un'esperienza di onboarding interattiva con Aurora DSQL per creare un nuovo cluster. + Apri una nuova chat di Kiro e chiedi qualsiasi cosa relativa ad Aurora DSQL. Facoltativamente, aggiorna MCP Config con i dettagli del cluster esistente per testare la connessione al server MCP in modo che possa essere utilizzata immediatamente con l'alimentazione. L'agente Kiro attiverà automaticamente l'alimentazione se la ritiene utile per completare l'attività dell'utente. ## Claude Skill Le competenze di Claude sono capacità modulari che estendono le funzionalità di Claude. Ogni abilità racchiude istruzioni, metadati e risorse opzionali che Claude utilizza automaticamente quando necessario. Le competenze sono basate su file system e vengono caricate su richiesta per ridurre al minimo l'utilizzo del contesto. ### Configurazione semplice con la CLI di Skills L'abilità può essere installata su Claude Code utilizzando. [Competenze CLI](#skills-cli) Per specificare solo Claude Code come agente su cui eseguire l'installazione, usa: ``` npx skills add awslabs/mcp --skill dsql --agent claude-code ``` ### Alternativa: configurazione diretta tramite un clone Git La configurazione alternativa utilizza un clone sparso della directory dsql-skill e collega simbolicamente questo clone nella cartella. `~/.claude/skills/` Ciò consente di apportare modifiche all'abilità ogni volta che l'abilità deve essere aggiornata. #### Prerequisiti + Git installato #### Fasi di configurazione **1. Crea una directory di repository di base** ``` mkdir -p .dsql_skill_repos ``` **2. Sparse: clona la skill dal repository MCP** Clona solo la `dsql-skill` cartella (nessun altro file): ``` 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. Collega l'abilità con un simbolo nella Skills Directory** Aggiungi la cartella delle competenze (impostazione predefinita: global/user-scoped): ``` mkdir -p ~/.claude/skills ``` **Nota** Se vuoi che questa sia un'abilità limitata al progetto, usa invece la directory principale del tuo progetto. `.claude/skills/` Aggiungi il link simbolico: ``` ln -s "$(pwd)/.dsql_skill_repos/mcp/src/aurora-dsql-mcp-server/skills/dsql-skill" ~/.claude/skills/dsql-skill ``` **4. Verifica la configurazione** ``` # Should show SKILL.md and other skill files ls -la ~/.claude/skills/dsql-skill/ ``` **5. Verifica l'uso delle abilità** Una volta configurata l'abilità, dovresti avere un nuovo comando skill:`/dsql`. Potrebbe essere necessario riavviare Claude Code dopo aver aggiunto l'abilità per rilevarla. È possibile utilizzare questo comando dalla CLI o dal pannello Claude Code come desiderato. #### Aggiornamento dell'abilità Per recuperare le ultime modifiche dal repository: ``` cd .dsql_skill_repos/mcp git pull ``` #### Struttura della directory Dopo aver impostato una skill globale, dovresti vedere queste directory: ``` .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** Aggiungilo `.dsql_skill_repos/` al tuo `.gitignore` se non vuoi tracciarlo. Il checkout sparse mantiene solo la cartella delle abilità, riducendo al minimo l'utilizzo del disco. ## Abilità Gemini Per aggiungere la skill Aurora DSQL direttamente in Gemini, scegli un ambito: `workspace` (contenuto nel progetto) o `user` (predefinito, globale) e usa il programma di installazione delle competenze. ### Configurazione ``` gemini skills install https://github.com/awslabs/mcp.git --path src/aurora-dsql-mcp-server/skills/dsql-skill --scope $SCOPE ``` Sostituisci con `$SCOPE` uno o. `workspace` `user` Puoi quindi usare il comando `/dsql` abilità con Gemini e Gemini rileverà automaticamente quando l'abilità deve essere usata. ## Abilità Codex Usa lo skill installer dalla CLI di Codex o TUI usando la skill. `$skill-installer` ### Configurazione ``` $skill-installer install dsql skill: https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill ``` Riavvia Codex per acquisire l'abilità. L'abilità può quindi essere attivata utilizzando`$dsql`.