Aurora DSQL ステアリング: Skills と Powers

このセクションでは、Skills と Powers を使用して Aurora DSQL の AI ステアリングを設定する方法について説明します。これらのマークダウンベースの設定ファイルは、エージェント開発の品質を向上させるためにコードを生成するときに AI アシスタントが自動的に適用するコンテキストとガイダンスを提供します。

概要

Skills と Powers は、Aurora DSQL の AI アシスタント機能を拡張するモジュラー機能です。これらは、AI アシスタントが Aurora DSQL データベースを操作するときに自動的に使用する手順、メタデータ、リソースをパッケージ化します。

Skills と Powers を使用する理由

Skills と Powers は、Aurora DSQL 開発にいくつかの重要な利点をもたらします。

推奨されるセットアップパス

開発環境に適したセットアップパスを選択します。

DSQL Skill は、skill フォルダをツールの rules または skills ディレクトリにコピーすることで、他の AI コーディングエージェントでも使用できます。

Skills CLI

DSQL skill は Skills CLI を使用してインストールできます。このエージェントに依存しないセットアップ方法は、ほとんどの AI コーディングアシスタントで動作し、skill を複数のエージェントに一度にインストールできます。

セットアップ

次のコマンドを実行して、Aurora DSQL skill をインストールします。

npx skills add awslabs/mcp --skill dsql

CLI は次の手順を案内します。

スキルの管理

以下を使用して、いつでも skills を確認し更新できます。

npx skills check
npx skills update

Kiro Power

Kiro Powers は、MCP ツールをフレームワークの専門知識とステアリング手順にバンドルする統合パッケージです。各 power には、使用可能な MCP ツールとアクティベーショントリガー、MCP サーバー設定、およびオンデマンドでロードされる追加のワークフロー固有のガイダンスを説明するエントリポイントドキュメントが含まれています。

Powers は、ユーザーのコンテキストに基づいて動的にアクティブ化されます。Powers は、すべてのツールを事前にロードするのではなく、関連するキーワードがアクティベーションをトリガーするまでほぼゼロのベースライン使用量を維持します。

セットアップ

Aurora DSQL の Kiro Power を設定するには:

Claude Skill

Claude skills は、Claude の機能を拡張するモジュラー機能です。各 skill は、Claude が必要に応じて自動的に使用する手順、メタデータ、およびオプションのリソースをパッケージ化します。Skills はファイルシステムベースで、コンテキストの使用を最小限に抑えるためにオンデマンドでロードされます。

Skills CLI を使用した簡単なセットアップ

skill は、Skills CLI を使用して Claude Code にインストールできます。インストール先のエージェントとして Claude Code のみを指定するには、以下を使用します。

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

代替方法: Git クローンを使用した直接セットアップ

代替セットアップでは、dsql-skill ディレクトリのスパースクローンを取得し、このクローンを ~/.claude/skills/ フォルダにシンボリックリンクします。これにより、skill を更新する必要があるときはいつでも、skill への変更をプルできるようになります。

前提条件

セットアップステップ

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

シンボリックリンクを追加します。

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

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 をアクティブ化できます。