View a markdown version of this page

Aurora DSQL 운영: 스킬 및 파워 - Amazon Aurora DSQL
개요스킬 CLIKiro 파워Claude 스킬Gemini 스킬Codex 스킬

Aurora DSQL 운영: 스킬 및 파워

이 섹션에서는 스킬 및 파워를 사용하여 Aurora DSQL용 AI 운영을 구성하는 방법을 설명합니다. 이러한 마크다운 기반 구성 파일은 에이전트 개발의 품질을 개선하기 위해 코드를 생성할 때 AI 어시스턴트가 자동으로 적용하는 컨텍스트와 지침을 제공합니다.

개요

스킬 및 파워는 Aurora DSQL의 AI 어시스턴트 기능을 확장하는 모듈식 기능입니다. AI 어시스턴트가 Aurora DSQL 데이터베이스로 작업할 때 자동으로 사용하는 지침, 메타데이터 및 리소스를 패키징합니다.

스킬 및 파워를 사용하는 이유

스킬 및 파워는 Aurora DSQL 개발에 몇 가지 주요 이점을 제공합니다.

  • AI 어시스턴트 전문화 - 모범 사례, Postgres 호환 SQL 패턴, 분산 데이터베이스 최적화를 포함하여 Aurora DSQL에 대한 도메인별 전문 지식을 제공합니다.

  • 반복 감소 - 한 번 생성하고 자동으로 사용합니다. 여러 대화에서 동일한 지침을 반복적으로 제공할 필요가 없습니다.

  • 컨텍스트 효율성 - 스킬은 컨텍스트를 미리 사용하는 대신 온디맨드 방식으로 로드합니다. AI는 필요에 따라 단계별로 정보를 로드합니다.

  • 지속적인 학습 - Aurora DSQL 기능이 발전함에 따라 AI 어시스턴트는 기술이 업데이트될 때 업데이트된 패턴에 자동으로 액세스합니다.

개발 환경과 일치하는 설정 경로를 선택합니다.

DSQL 스킬은 스킬 폴더를 도구의 rules 또는 skills 디렉터리에 복사하여 다른 AI 코딩 에이전트와 함께 사용할 수도 있습니다.

스킬 CLI

DSQL 스킬은 스킬 CLI를 사용하여 설치할 수 있습니다. 에이전트에 구애받지 않는 이 설정 방법은 대부분의 AI 코딩 어시스턴트에서 작동하며 한 번에 여러 에이전트에 스킬을 설치할 수 있습니다.

설정

다음 명령을 실행하여 Aurora DSQL 스킬을 설치합니다.

npx skills add awslabs/mcp --skill dsql

CLI는 다음을 안내합니다.

  • 에이전트 선택 - 설치할 에이전트를 선택합니다(Kiro, Claude Code, Cursor, Copilot, Gemini, Codex, Roo, Cline, OpenCode, Windsurf 등).

  • 설치 범위 - 다음 중에서 선택합니다.

    • 프로젝트: 현재 디렉터리에 설치(프로젝트와 커밋됨)

    • 글로벌: 홈 디렉터리에 설치(모든 프로젝트에서 사용 가능)

  • 설치 방법 - 다음 중에서 선택합니다.

    • Symlink(권장): 단일 정보 소스, 간편한 업데이트

    • 모든 에이전트에 복사: 각 에이전트에 대해 독립적인 복사본

스킬 관리

다음을 사용하여 언제든지 스킬을 확인하고 업데이트합니다.

npx skills check
npx skills update

Kiro 파워

Kiro 파워는 MCP 도구를 프레임워크 전문 지식 및 운영 지침과 함께 번들링하는 통합 패키지입니다. 각 파워에는 사용 가능한 MCP 도구 및 활성화 트리거, MCP 서버 구성, 온디맨드 로드된 추가 워크플로별 지침을 설명하는 진입점 문서가 포함되어 있습니다.

사용자 컨텍스트에 따라 파워가 동적으로 활성화됩니다. 파워는 모든 도구를 미리 로드하는 대신 관련 키워드가 활성화를 트리거할 때까지 거의 0에 가까운 기준 사용량을 유지합니다.

설정

Aurora DSQL에 대한 Kiro 파워를 설정하려면:

  1. Kiro 파워 레지스트리에서 직접 설치

  2. IDE에서 파워로 리디렉션되면 다음 중 하나를 수행합니다.

    • 파워 사용해 보기 버튼을 선택합니다. AI가 MCP 서버 설정 또는 Aurora DSQL을 사용한 대화형 온보딩 환경을 안내하여 새 클러스터를 생성하려는 사용자에게 제안됩니다.

    • 새 Kiro 채팅을 열고 Aurora DSQL과 관련된 모든 것을 질문합니다. 필요에 따라 기존 클러스터 세부 정보로 MCP 구성을 업데이트하여 파워로 즉시 사용할 수 있도록 MCP 서버 연결을 테스트합니다. Kiro 에이전트는 사용자의 작업을 완료하는 데 유용한 파워를 식별하면 자동으로 파워를 활성화합니다.

Claude 스킬

Claude 스킬은 Claude의 기능을 확장하는 모듈식 기능입니다. 각 스킬은 관련된 경우 Claude가 자동으로 사용하는 지침, 메타데이터 및 선택적 리소스를 패키징합니다. 스킬은 파일 시스템 기반이며 온디맨드 방식으로 로드되어 컨텍스트 사용을 최소화합니다.

스킬 CLI를 사용한 간단한 설정

스킬 CLI를 사용하여 스킬을 Claude Code에 설치할 수 있습니다. Claude Code만 설치할 에이전트로 지정하려면 다음을 사용합니다.

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

대안: Git 복제본을 사용한 직접 설정

대체 설정은 dsql-skill 디렉터리의 희소 복제본을 가져와 이 복제본을 ~/.claude/skills/ 폴더에 symlink합니다. 이렇게 하면 스킬을 업데이트해야 할 때마다 스킬에 대한 변경 사항을 가져올 수 있습니다.

사전 조건

  • 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. 스킬을 스킬 디렉터리에 Symlink

스킬 디렉터리를 추가합니다(기본값: global/user-scoped).

mkdir -p ~/.claude/skills
참고

이를 프로젝트 범위 스킬로 만들려면 프로젝트 루트의 .claude/skills/ 디렉터리를 대신 사용합니다.

symlink를 추가합니다.

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 코드를 다시 시작해야 할 수 있습니다. Claude 코드 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
참고

추적하지 않으려면 .gitignore에 .dsql_skill_repos/를 추가합니다. 희소 체크아웃은 스킬 폴더만 유지하여 디스크 사용량을 최소화합니다.

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을 사용하여 스킬을 활성화할 수 있습니다.