View a markdown version of this page

Aurora DSQL 操控：技能和能力 - Amazon Aurora DSQL
概述Skills CLIKiro 能力Claude 技能Gemini 技能Codex 技能

Aurora DSQL 操控：技能和能力

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

概述

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

为什么要使用技能和能力

技能和能力为 Aurora DSQL 开发提供了几个主要优势：

  • 专业的 AI 助手：为 Aurora DSQL 提供特定领域的专业知识，包括最佳实践、与 Postgres 兼容的 SQL 模式和分布式数据库优化。

  • 减少重复性：创建一次，自动使用。不再需要在多个对话中反复提供相同的指导。

  • 上下文效率：技能按需加载，而不是预先使用上下文。AI 根据需要分阶段加载信息。

  • 持续学习：随着 Aurora DSQL 功能的发展，当更新技能时，AI 助手会自动访问更新的模式。

选择与您的开发环境相匹配的设置路径：

也可以通过将技能文件夹复制到工具的 rules 或 skills 目录中，将 DSQL 技能与其它 AI 编码代理一起使用。

Skills CLI

可以使用 Skills CLI 安装 DSQL 技能。这种与代理无关的设置方法适用于大多数 AI 编码助手，可让您同时将技能安装到多个代理上。

设置

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

npx skills add awslabs/mcp --skill dsql

CLI 将指导您完成：

  • 选择代理：选择要安装到哪些代理（Kiro、Claude Code、Cursor、Copilot、Gemini、Codex、Roo、Cline、OpenCode、Windsurf 等）

  • 安装范围：在以下选项中进行选择：

    • 项目：安装在当前目录中（与您的项目一起提交）

    • 全局：安装在主目录中（适用于所有项目）

  • 安装方法：在以下选项中进行选择：

    • 符号链接（建议）：单一事实来源，易于更新

    • 复制到所有代理：每个代理都有独立的副本

管理技能

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

npx skills check
npx skills update

Kiro 能力

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

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

设置

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

  1. 直接从 Kiro Powers Registry 进行安装

  2. 在 IDE 中重定向到“能力”后，您可以：

    • 选择试用能力按钮。建议希望让 AI 指导 MCP 服务器设置或使用 Aurora DSQL 进行交互式入门体验以创建新集群的用户使用。

    • 打开一个新的 Kiro 聊天，并询问任何与 Aurora DSQL 相关的问题。（可选）使用现有集群详细信息更新 MCP 配置以测试 MCP 服务器连接，以便它可以与能力一起开箱即用。如果 Kiro 代理识别出能力对完成用户的任务有价值，它将自动激活该能力。

Claude 技能

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

使用 Skills CLI 进行简单设置

可以使用 Skills CLI 将技能安装到 Claude Code 中。要仅将 Claude Code 指定为要安装到的代理，请使用：

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

备选方案：使用 Git 克隆直接设置

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

先决条件

  • Git 已安装

设置步骤

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 或面板中使用此命令。

更新技能

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

cd .dsql_skill_repos/mcp
git pull

目录结构

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

.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 技能

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

设置

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 技能

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

设置

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

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