本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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>

 選擇符合您開發環境的設定路徑：
+ [技能 CLI](#skills-cli) (Agent-Agnostic)
+ [Kiro Power](#kiro-power)
+ [Claude 技能](#claude-skill)
+ [Gemini 技能](#gemini-skill)
+ [Codex 技能](#codex-skill)

 [DSQL 技能](https://github.com/awslabs/mcp/tree/main/src/aurora-dsql-mcp-server/skills/dsql-skill)也可以透過將技能資料夾複製到工具的 `rules`或 `skills`目錄，與其他 AI 編碼代理器搭配使用。

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

 您可以使用 Skills [CLI 安裝 DSQL](https://skills.sh/awslabs/mcp/dsql) [技能](https://skills.sh/docs/cli)。此與代理程式無關的設定方法適用於大多數 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 等） 
+  **安裝範圍** - 選擇：
  + 專案：在目前的目錄中安裝 （與您的專案一起遞交）
  + 全域：在主目錄中安裝 （適用於所有專案）
+  **安裝方法** - 選擇：
  + Symlink （建議）：單一事實來源，輕鬆更新
  + 複製到所有客服人員：每個客服人員的獨立副本

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

 隨時使用 檢查和更新技能：

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

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

 Kiro Powers 是統一套件，將 MCP 工具與架構專業知識和轉向指示綁定在一起。每個功能都包含一個進入點文件，說明可用的 MCP 工具和啟用觸發條件、MCP 伺服器組態，以及隨需載入的其他工作流程特定指引。

 電源會根據使用者內容動態啟用。電源不會預先載入所有工具，而是維持接近零的基準用量，直到相關關鍵字觸發啟用為止。

### 設定
<a name="kiro-power-setup"></a>

 若要設定 Aurora DSQL 的 Kiro 電源：

1.  直接從 [Kiro Powers 登錄](https://kiro.dev/launch/powers/amazon-aurora-dsql/)檔安裝 

1.  重新導向至 IDE 中的 Power 後，請執行下列其中一項操作：
   +  選取**嘗試電源**按鈕。建議希望 AI 引導 MCP 伺服器設定或互動入門體驗的使用者使用 Aurora DSQL 建立新的叢集。
   +  開啟新的 Kiro 聊天，並詢問與 Aurora DSQL 相關的任何內容。選擇性地使用您現有的叢集詳細資訊更新 MCP Config，以測試 MCP 伺服器連線，使其能夠立即使用。如果 Kiro 代理程式將電源識別為對完成使用者任務有價值，則其將自動啟用電源。

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

 Claude 技能是擴展 Claude 功能的模組化功能。Claude 會在相關時自動使用的每個技能套件指示、中繼資料和選用資源。技能是以檔案系統為基礎，並隨需載入，以將內容用量降至最低。

### 使用技能 CLI 進行簡單設定
<a name="claude-skill-simple-setup"></a>

 您可以使用 安裝技能到 Claude Code[技能 CLI](#skills-cli)。若要將 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. 將技能 Symlink 至技能目錄** 

 新增技能目錄 （預設：全域/使用者範圍）：

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

**注意**  
 `.gitignore` 如果您不想追蹤，請將 `.dsql_skill_repos/`新增至您的 。稀疏結帳只會保留技能資料夾，將磁碟用量降至最低。

## 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`。

 然後，您可以將`/dsql`技能命令與 Gemini 搭配使用，Gemini 會自動偵測何時應使用技能。

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

 使用技能從 Codex CLI 或 TUI 使用`$skill-installer`技能安裝程式。

### 設定
<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`。