# Aurora DSQL ステアリング: Skills と Powers
このセクションでは、Skills と Powers を使用して Aurora DSQL の AI ステアリングを設定する方法について説明します。これらのマークダウンベースの設定ファイルは、エージェント開発の品質を向上させるためにコードを生成するときに AI アシスタントが自動的に適用するコンテキストとガイダンスを提供します。
## 概要
Skills と Powers は、Aurora DSQL の AI アシスタント機能を拡張するモジュラー機能です。これらは、AI アシスタントが Aurora DSQL データベースを操作するときに自動的に使用する手順、メタデータ、リソースをパッケージ化します。
### Skills と Powers を使用する理由
Skills と Powers は、Aurora DSQL 開発にいくつかの重要な利点をもたらします。
+ **AI アシスタントの専門化** - ベストプラクティス、Postgres 互換 SQL パターン、分散データベースの最適化など、Aurora DSQL のドメイン固有の専門知識を提供します。
+ **繰り返しを削減** - 一度作成すれば自動的に使用されます。複数の会話で同じガイダンスを繰り返し提供する必要がなくなります。
+ **コンテキスト効率性** - Skills は、コンテキストを事前に消費するのではなく、オンデマンドでロードします。AI は、必要に応じて情報を段階的にロードします。
+ **継続的な学習** - Aurora DSQL の機能が進化するにつれて、Skills が更新されると、AI アシスタントは更新されたパターンに自動的にアクセスします。
### 推奨されるセットアップパス
開発環境に適したセットアップパスを選択します。
+ [Skills CLI](#skills-cli) (エージェントに依存しない)
+ [Kiro Power](#kiro-power)
+ [Claude Skill](#claude-skill)
+ [Gemini Skill](#gemini-skill)
+ [Codex Skill](#codex-skill)
[DSQL Skill](https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill) は、skill フォルダをツールの `rules` または `skills` ディレクトリにコピーすることで、他の AI コーディングエージェントでも使用できます。
## Skills CLI
[DSQL skill](https://skills.sh/awslabs/mcp/dsql) は [Skills CLI](https://skills.sh/docs/cli) を使用してインストールできます。このエージェントに依存しないセットアップ方法は、ほとんどの AI コーディングアシスタントで動作し、skill を複数のエージェントに一度にインストールできます。
### セットアップ
次のコマンドを実行して、Aurora DSQL skill をインストールします。
```
npx skills add awslabs/mcp --skill dsql
```
CLI は次の手順を案内します。
+ **エージェントの選択** - インストールするエージェントを選択します (Kiro、Claude Code、Cursor、Copilot、Gemini、Codex、Roo、Cline、OpenCode、Windsurf など)
+ **インストールスコープ** - 次のいずれかを選択します。
+ プロジェクト: 現在のディレクトリにインストールする (プロジェクトにコミット済み)
+ グローバル: ホームディレクトリにインストールする (すべてのプロジェクトで利用可能)
+ **インストール方法** - 次のいずれかを選択します。
+ Symlink (推奨): 信頼できる単一のソース、簡単に更新可能
+ すべてのエージェントにコピー: エージェントごとに個別のコピー
### スキルの管理
以下を使用して、いつでも skills を確認し更新できます。
```
npx skills check
npx skills update
```
## Kiro Power
Kiro Powers は、MCP ツールをフレームワークの専門知識とステアリング手順にバンドルする統合パッケージです。各 power には、使用可能な MCP ツールとアクティベーショントリガー、MCP サーバー設定、およびオンデマンドでロードされる追加のワークフロー固有のガイダンスを説明するエントリポイントドキュメントが含まれています。
Powers は、ユーザーのコンテキストに基づいて動的にアクティブ化されます。Powers は、すべてのツールを事前にロードするのではなく、関連するキーワードがアクティベーションをトリガーするまでほぼゼロのベースライン使用量を維持します。
### セットアップ
Aurora DSQL の Kiro Power を設定するには:
1. [Kiro Powers Registry](https://kiro.dev/launch/powers/amazon-aurora-dsql/) から直接インストールする
1. IDE の Power にリダイレクトされたら、次のいずれかを実行します。
+ **[Power を試す]** ボタンを選択します。AI による MCP サーバーのセットアップガイドや、Aurora DSQL を使用したインタラクティブなオンボーディングエクスペリエンスで新しいクラスターを作成したりしたいユーザーに推奨されます。
+ 新しい Kiro チャットを開き、Aurora DSQL に関連する質問をします。必要に応じて、既存のクラスターの詳細で MCP Config を更新して MCP サーバー接続をテストし、power を使用してすぐに使用できるようにします。Kiro エージェントは、ユーザーのタスクを完了するために power が有益であると判断した場合、power を自動的にアクティブ化します。
## Claude Skill
Claude skills は、Claude の機能を拡張するモジュラー機能です。各 skill は、Claude が必要に応じて自動的に使用する手順、メタデータ、およびオプションのリソースをパッケージ化します。Skills はファイルシステムベースで、コンテキストの使用を最小限に抑えるためにオンデマンドでロードされます。
### Skills CLI を使用した簡単なセットアップ
skill は、[Skills CLI](#skills-cli) を使用して Claude Code にインストールできます。インストール先のエージェントとして Claude Code のみを指定するには、以下を使用します。
```
npx skills add awslabs/mcp --skill dsql --agent claude-code
```
### 代替方法: Git クローンを使用した直接セットアップ
代替セットアップでは、dsql-skill ディレクトリのスパースクローンを取得し、このクローンを `~/.claude/skills/` フォルダにシンボリックリンクします。これにより、skill を更新する必要があるときはいつでも、skill への変更をプルできるようになります。
#### 前提条件
+ インストール済みGit
#### セットアップステップ
**1. ベースリポジトリディレクトリを作成する**
```
mkdir -p .dsql_skill_repos
```
**2. MCP リポジトリから skill をスパースクローンする**
`dsql-skill` フォルダのみをクローンします (他のファイルはクローンしません)。
```
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. Skills ディレクトリに skill をシンボリックリンクする**
skills ディレクトリを追加します (デフォルト: global/user-scoped):
```
mkdir -p ~/.claude/skills
```
**注記**
これをプロジェクトスコープの skill にする場合は、代わりにプロジェクトルートの `.claude/skills/` ディレクトリを使用します。
シンボリックリンクを追加します。
```
ln -s "$(pwd)/.dsql_skill_repos/mcp/src/aurora-dsql-mcp-server/skills/dsql-skill" ~/.claude/skills/dsql-skill
```
**4. セットアップを確認します**
```
# Should show SKILL.md and other skill files
ls -la ~/.claude/skills/dsql-skill/
```
**5. Skill の使用を確認する**
skill が設定されたら、新しい skill コマンドが作成されます。`/dsql`。skill を追加した後、skill が検出されるように Claude Code を再起動する必要がある場合があります。このコマンドは、必要に応じて Claude Code CLI またはパネルから使用できます。
#### Skill の更新
リポジトリから最新の変更をプルするには:
```
cd .dsql_skill_repos/mcp
git pull
```
#### ディレクトリ構造
グローバル skill を設定すると、次のディレクトリが表示されます。
```
.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
```
**注記**
追跡しない場合は、`.gitignore` に `.dsql_skill_repos/` を追加します。スパースチェックアウトでは skill フォルダのみが保持されるため、ディスク使用量が最小限に抑えられます。
## Gemini Skill
Aurora DSQL skill を Gemini に直接追加するには、スコープ `workspace` (プロジェクトに含まれる) または `user` (デフォルト、グローバル) を決定し、skills インストーラを使用します。
### セットアップ
```
gemini skills install https://github.com/awslabs/mcp.git --path src/aurora-dsql-mcp-server/skills/dsql-skill --scope $SCOPE
```
`$SCOPE` を `workspace` または `user` に置き換えます。
その後、Gemini で `/dsql` skill コマンドを使用できるようになります。Gemini は skill を使用するタイミングを自動的に検出します。
## Codex Skill
`$skill-installer` skill を使用して、Codex CLI または TUI から skill インストーラを使用します。
### セットアップ
```
$skill-installer install dsql skill: https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill
```
Codex を再起動して skill を取得します。その後、`$dsql` を使用して skill をアクティブ化できます。