스킬 레지스트리
개발 워크플로공개 스킬

Database Operations

AI 에이전트를 위한 안전한 데이터베이스 작업 — 스키마 검사, 읽기 전용 쿼리, 성능 분석, 거버넌스된 마이그레이션, Supabase, PlanetScale, Neon 또는 모든 SQL 데이터베이스를 통한 데이터 탐색.

이 스킬이 가르치는 것

특정 작업 유형을 위한 재사용 가능한 플레이북입니다.

MCP 서버는 에이전트에게 어떤 작업이 가능한지 알려줍니다. 스킬은 그 작업들에 대한 판단을 추가합니다: 작업을 인식하는 방법, 따라야 할 순서, 피해야 할 것, 그리고 결과가 완료되었는지 결정하는 방법.

데이터베이스 작업을 조율하세요 — 스키마 검사, 안전한 쿼리, 성능 분석, 마이그레이션 관리, 데이터 패턴 탐색을 포함합니다. 데이터베이스 쿼리, 테이블 스키마 검사, 느린 쿼리 분석, 마이그레이션 실행, 인덱스 사용 확인, 데이터 분포 탐색 등에 사용하세요.

아키텍처

Database Operations이(가) ADK-Rust 에이전트를 어떻게 안내하는지.

스킬은 서비스 자격 증명이나 비즈니스 데이터를 포함하지 않고 지침만 포함하므로 읽기 쉽고 휴대 가능합니다. ADK-Rust가 에이전트에 제공하고, 에이전트는 검토된 도구 경계에서 선택하며, 연결된 MCP 서버가 인증된 작업을 수행합니다.

01

사용자 요청

에이전트는 일반 언어로 표현된 목표를 받습니다.

02

Database Operations 스킬

의도를 일치시키고 결정 가이드를 제공하며 도구 경계를 좁힙니다.

03

ADK-Rust 에이전트

워크플로우를 계획하고 각 의미 있는 단계를 런타임을 통해 스트리밍합니다.

04

mcp-database

기능을 소유한 시스템에 대해 인증된 작업을 실행합니다.

05

검증된 결과

스킬의 완료 규칙은 사용자에게 반환되는 증거를 형성합니다.

휴대 가능한 지침: SKILL.md · 기능 경계: mcp-database · 허용된 도구: 22

결정 가이드

에이전트가 요청을 올바른 작업으로 전환하는 방법입니다.

이 경로들은 스킬 지침에서 직접 가져온 것입니다. 모델이 의도를 인식하고 전체 기능 범위 대신 집중된 도구나 워크플로우를 선택하도록 돕습니다.

01

"schema", "tables", "columns", "structure"?

WORKFLOW 1: 스키마 검사

02

"query", "select", "find data", "show me"?

WORKFLOW 2: 안전한 쿼리

03

"slow", "performance", "optimize", "index"?

WORKFLOW 3: 성능 분석

04

"migrate", "alter", "add column", "create table"?

WORKFLOW 4: 마이그레이션

05

"insert", "update", "delete", "write"?

WORKFLOW 5: 거버넌스된 쓰기

06

불명확?

먼저 list_tables로 데이터베이스 이해

검증된 워크플로우

유용한 결과를 위한 반복 가능한 시퀀스입니다.

워크플로우는 여러 도구 호출을 사용자가 실제로 인식하는 작업으로 결합합니다. 스킬은 순서와 의도된 결과를 설명하며 ADK-Rust는 공유 런타임을 통해 에이전트의 진행 상황을 스트리밍합니다.

012-4개의 호출

스키마 검사

작업 전에 구조 이해

022-3개의 호출

안전한 쿼리

LIMIT 및 EXPLAIN 포함 읽기 전용

033-4개의 호출

성능 분석

느린 쿼리 및 누락된 인덱스 찾기

043-4개의 호출

마이그레이션

생성 → 검증 → 롤백 가능한 적용

053개의 호출

거버넌스 쓰기

검증 → 범위 설명 → 실행

도구 경계

스킬은 22개의 문서화된 도구를 사용할 수 있습니다.

이 허용 목록은 스킬에서 선언합니다. 에이전트가 이 작업에 필요한 행동에 집중하도록 유지하며, mcp-database는 인증, 검증, 연결된 시스템에 대한 책임을 집니다.

list_tables
describe_table
get_relationships
list_indexes
get_database_stats
search_schema
query
sample_data
filter_table
explain_query
get_column_stats
execute
create_index
run_migration
list_migrations
get_slow_queries
get_connections
get_maintenance_status
get_index_usage
generate_schema
get_er_diagram
validate_sql

작동 규칙

에이전트가 해야 할 것

  • 결정 가이드를 따르고, 선언된 도구 경계를 사용하며, 응답 전에 결과를 검증하세요.

운영 경계

에이전트가 피해야 할 것

  • 이 스킬을 프로덕션 작업에 사용하기 전에 완전한 SKILL.md를 검토하세요.

설치 및 연결

기능이 기대하는 스킬을 그 옆에 추가하세요.

ADK-Rust 스킬 로더가 발견할 수 있는 저장소에 설치하고, mcp-database에 연결하며, 선언된 도구가 사용 가능한지 확인한 후 에이전트에게 워크플로우 사용을 요청하세요.

스킬 설치
git clone https://github.com/zavora-ai/skill-database-operations.git \
  ~/.skills/skills/database-operations
ADK-Rust 로딩 형태
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("database-operations").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

저장소의 호환성 선언: mcp-database 서버 연결 필요 (Supabase, PlanetScale, Neon 또는 맞춤 API).

공식 문서

완전한 스킬 패키지를 읽어보세요.

저장소는 정확한 지침, 예제, 헬퍼 스크립트, 자산, MCP 요구사항, 라이선스, 이후 업데이트에 대해 권위 있는 출처로 남아 있습니다.

소스 기록

이 스킬 항목의 저장소 메타데이터입니다.

공개 저장소 보기 ↗
라이선스
Apache-2.0
허용된 도구
22
참조
3
수정
565646477a6f
업데이트됨
2026년 5월 31일