# Aurora DSQL 操控：技能和能力
<a name="SECTION_aurora-dsql-steering"></a>

 本节介绍如何使用技能和能力为 Aurora DSQL 配置 AI 操控。这些基于 markdown 的配置文件提供了上下文和指导，AI 助手在生成代码时会自动应用这些上下文和指导，以提高代理式开发的质量。

## 概述
<a name="steering-overview"></a>

 技能和能力是模块化功能，可扩展 Aurora DSQL 的 AI 助手功能。它们打包了 AI 助手在处理 Aurora DSQL 数据库时自动使用的指令、元数据和资源。

### 为什么要使用技能和能力
<a name="why-use-steering"></a>

 技能和能力为 Aurora DSQL 开发提供了几个主要优势：
+  **专业的 AI 助手**：为 Aurora DSQL 提供特定领域的专业知识，包括最佳实践、与 Postgres 兼容的 SQL 模式和分布式数据库优化。
+  **减少重复性**：创建一次，自动使用。不再需要在多个对话中反复提供相同的指导。
+  **上下文效率**：技能按需加载，而不是预先使用上下文。AI 根据需要分阶段加载信息。
+  **持续学习**：随着 Aurora DSQL 功能的发展，当更新技能时，AI 助手会自动访问更新的模式。

### 建议的设置路径
<a name="recommended-paths"></a>

 选择与您的开发环境相匹配的设置路径：
+ [Skills CLI](#skills-cli)（与代理无关）
+ [Kiro 能力](#kiro-power)
+ [Claude 技能](#claude-skill)
+ [Gemini 技能](#gemini-skill)
+ [Codex 技能](#codex-skill)

 也可以通过将技能文件夹复制到工具的 `rules` 或 `skills` 目录中，将 [DSQL](https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill) 技能与其它 AI 编码代理一起使用。

## Skills CLI
<a name="skills-cli"></a>

 可以使用 [Skills CLI](https://skills.sh/docs/cli) 安装 [DSQL 技能](https://skills.sh/awslabs/mcp/dsql)。这种与代理无关的设置方法适用于大多数 AI 编码助手，可让您同时将技能安装到多个代理上。

### 设置
<a name="skills-cli-setup"></a>

 运行以下命令以安装 Aurora DSQL 技能：

```
npx skills add awslabs/mcp --skill dsql
```

 CLI 将指导您完成：
+  **选择代理**：选择要安装到哪些代理（Kiro、Claude Code、Cursor、Copilot、Gemini、Codex、Roo、Cline、OpenCode、Windsurf 等） 
+  **安装范围**：在以下选项中进行选择：
  + 项目：安装在当前目录中（与您的项目一起提交）
  + 全局：安装在主目录中（适用于所有项目）
+  **安装方法**：在以下选项中进行选择：
  + 符号链接（建议）：单一事实来源，易于更新
  + 复制到所有代理：每个代理都有独立的副本

### 管理技能
<a name="skills-cli-management"></a>

 可随时使用以下方法检查和更新技能：

```
npx skills check
npx skills update
```

## Kiro 能力
<a name="kiro-power"></a>

 Kiro 能力是统一的软件包，它将 MCP 工具与框架专业知识和操控说明捆绑在一起。每项能力都包括一个入口点文档，用于说明可用的 MCP 工具和激活触发器、MCP 服务器配置以及按需加载的其它特定于工作流程的指南。

 能力会根据用户上下文动态激活。能力并不是预先加载所有工具，而是在相关关键字触发激活之前保持接近零的基线用量。

### 设置
<a name="kiro-power-setup"></a>

 要为 Aurora DSQL 设置 Kiro 能力，请执行以下操作：

1.  直接从 [Kiro Powers Registry](https://kiro.dev/launch/powers/amazon-aurora-dsql/) 进行安装 

1.  在 IDE 中重定向到“能力”后，您可以：
   +  选择**试用能力**按钮。建议希望让 AI 指导 MCP 服务器设置或使用 Aurora DSQL 进行交互式入门体验以创建新集群的用户使用。
   +  打开一个新的 Kiro 聊天，并询问任何与 Aurora DSQL 相关的问题。（可选）使用现有集群详细信息更新 MCP 配置以测试 MCP 服务器连接，以便它可以与能力一起开箱即用。如果 Kiro 代理识别出能力对完成用户的任务有价值，它将自动激活该能力。

## Claude 技能
<a name="claude-skill"></a>

 Claude 技能是扩展 Claude 的功能的模块化能力。每项技能都会对 Claude 在相关时自动使用的指令、元数据和可选资源进行打包。技能基于文件系统并按需加载，以最大限度地减少上下文用量。

### 使用 Skills CLI 进行简单设置
<a name="claude-skill-simple-setup"></a>

 可以使用 [Skills CLI](#skills-cli) 将技能安装到 Claude Code 中。要仅将 Claude Code 指定为要安装到的代理，请使用：

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

### 备选方案：使用 Git 克隆直接设置
<a name="claude-skill-direct-setup"></a>

 备选设置采用 dsql-skill 目录的稀疏克隆，并将此克隆符号链接到 `~/.claude/skills/` 文件夹。这样，就可以在需要更新技能时对技能进行更改。

#### 先决条件
<a name="claude-skill-prerequisites"></a>
+ Git 已安装

#### 设置步骤
<a name="claude-skill-setup"></a>

 **1. 创建基本存储库目录** 

```
mkdir -p .dsql_skill_repos
```

 **2. 对 MCP 存储库中的技能进行稀疏克隆** 

 仅克隆 `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 目录** 

 添加技能目录（默认：global/user-scoped）：

```
mkdir -p ~/.claude/skills
```

**注意**  
 如果您想让它成为项目范围的技能，请改用项目根目录的 `.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. 验证技能使用情况** 

 配置技能后，您应该有一个新的技能命令：`/dsql`。您可能必须在添加技能后重启 Claude Code，才能检测到该技能。您可以根据需要从 Claude Code CLI 或面板中使用此命令。

#### 更新技能
<a name="claude-skill-updating"></a>

 要从存储库中提取最新更改，请执行以下操作：

```
cd .dsql_skill_repos/mcp
git pull
```

#### 目录结构
<a name="claude-skill-directory-structure"></a>

 设置全局技能后，您应该会看到以下目录：

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

**注意**  
 如果您不想追踪该技能，请将 `.dsql_skill_repos/` 添加到您的 `.gitignore`。稀疏签出仅保留技能文件夹，从而最大限度地减少了磁盘用量。

## Gemini 技能
<a name="gemini-skill"></a>

 要直接在 Gemini 中添加 Aurora DSQL 技能，请确定范围：`workspace`（包含在项目中）或 `user`（默认，全局），然后使用技能安装程序。

### 设置
<a name="gemini-skill-setup"></a>

```
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` 技能命令，Gemini 会自动检测何时应该使用该技能。

## Codex 技能
<a name="codex-skill"></a>

 通过 `$skill-installer` 技能使用 Codex CLI 或 TUI 中的技能安装程序。

### 设置
<a name="codex-skill-setup"></a>

```
$skill-installer install dsql skill: https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill
```

 重启 Codex 以获得技能。然后可以使用 `$dsql` 激活该技能。