View a markdown version of this page

Aurora DSQL Steering: competenze e poteri - Amazon Aurora DSQL

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.

Scegliete il percorso di configurazione adatto al vostro ambiente di sviluppo:

La Skill DSQL 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 può essere installata utilizzando la CLI Skills. 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

  2. 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 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.