실행 전 대기 중인 SQL 마이그레이션을 자동으로 스캔하고 검증하여 파이프라인 오류를 방지하는 데이터베이스 도구입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install migration-validator
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 migration-validator 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Migration Validator란 무엇인가요?
Migration Validator는 마이그레이션 디렉토리에서 대기 중인 SQL 데이터베이스 마이그레이션 파일을 스캔하고 배포 전 구문 정확성을 보장하도록 설계된 필수 유틸리티입니다. 검증 알고리즘을 실행하고 마이그레이션 스크립트를 파싱함으로써 현대 소프트웨어 릴리스 주기에서 중요한 안전장치 역할을 합니다.
Openclaw Skills를 통해 이 도구를 통합하면 자동화된 스키마 보호가 가능하여 개발자가 구문 오타나 구조적 불일치로 인한 데이터베이스 런타임 오류를 제거할 수 있습니다. 이는 마이그레이션 실행 상태를 관리 및 기록하며, 어떤 마이그레이션이 대기 중이거나 완료되었는지 식별합니다.
Migration Validator 활용 사례
- 배포 게이팅: 실행 전 SQL 마이그레이션 스크립트의 구문 문제 및 구조 오류를 감지합니다.
- CI/CD 통합: pull request 또는 배포 파이프라인에서 SQL 파일을 자동 검증하는 차단 사전 단계로 활용합니다.
- 다중 환경 정렬: 마이그레이션 스크립트가 개발, 스테이징 및 프로덕션 환경 전반에서 상호 호환되고 유효한지 확인합니다.
Migration Validator 작동 원리
- 디렉토리 검색: 이 스킬은 지정된 마이그레이션 디렉토리(예:
migrations/)를 스캔하여 모든 후보 SQL 파일을 식별합니다. - 구문 검증: 각 SQL 파일은 전문화된 구문 엔진(예: SQLite PRAGMA 문 검증 또는 네이티브 SQL 파서)을 사용하여 파싱되고 검증됩니다.
- 상태 추적: 이 도구는 대기 중인 마이그레이션 파일을 이전에 실행된 마이그레이션과 대조하여 데이터베이스의 차등 상태를 확인합니다.
- 보고서 출력: 실행 상태, 오류 및 식별된 마이그레이션이 포함된 구조화된 JSON 검증 보고서가 생성됩니다.
Migration Validator 설정 가이드
Openclaw Skills 제품군 내에서 이 마이그레이션 유틸리티를 활용하려면 프로젝트 워크스페이스를 구성하고 아래와 같이 검증 스크립트를 실행하십시오:
# 마이그레이션이 포함된 프로젝트 디렉토리로 이동
cd /path/to/your/project
# 검증 스크립트 실행
python scripts/validate.py
가상 환경 내에 데이터베이스 드라이버와 python 종속성이 설정되어 있는지 확인하십시오.
Migration Validator 데이터 스키마 및 분류 체계
이 도구는 SQL 마이그레이션 구조를 평가하고 스키마를 준수하는 JSON 검증 보고서를 생성합니다. 다음은 검증 메타데이터 출력 구조입니다:
| 속성 | 유형 | 설명 |
|---|---|---|
validation_timestamp |
String | 검증 실행의 ISO 8601 타임스탬프 |
migrations_found |
Array | 폴더에서 발견된 SQL 파일 이름 목록 |
pending_migrations |
Array | 대상 데이터베이스에 아직 적용되지 않은 SQL 파일 |
validation_errors |
Array | 구문 확인에서 파싱된 상세 오류 |
status |
String | 일반적인 검증 상태(예: completed, failed) |
예시 출력:
{
"validation_timestamp": "2026-06-01T12:00:00",
"migrations_found": ["001_initial.sql", "002_create_orders.sql"],
"pending_migrations": [],
"validation_errors": [],
"status": "completed"
}
Migration Validator 고급 기능
- Dry-Run 검증: 활성 데이터베이스 상태를 수정하지 않고 스키마 파싱을 실행합니다.
- 구성 가능한 파싱 엔진: SQLite, PostgreSQL 또는 MySQL 스키마에 맞춰진 방언별 검증 체크를 선택합니다.
- Openclaw Skills 자동화: migration-validator를 다중 에이전트 오케스트레이션 파이프라인과 쉽게 연결하여 자동 롤백 및 pre-commit 훅을 구현합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
RaspAP
REST APIs를 통해 로컬 RaspAP 무선 액세스 포인트를 안전하게 쿼리, 관리 및 문제 해결하기 위한 네트워크 준비 시스템 skill.
Schema Migrator
분석기 권장 사항에 따라 보류 중인 인덱스 정리 작업과 마이그레이션을 검증하고 실행하는 데이터베이스 자동화 도구입니다.
cleanMyMacSkill
디스크 사용량을 스캔하고 파일을 안전 등급별로 분류하며, 원클릭 정리를 위한 인터랙티브 Apple 스타일 대시보드를 제공하는 AI 기반 크로스 플랫폼 디스크 스토리지 분석기입니다.
WeChat Reading 데스크탑 위젯
WeChat Reading의 연속 독서 일수, 독서 시간, 현재 진행 상황, 목표 및 일일 명언을 표시하는 우아하고 자동 새로 고침되는 macOS 데스크탑 위젯입니다.
eBay Account Automation
ADS Power 및 Chrome DevTools Protocol을 사용하여 여러 eBay 판매자 계정에서 현실적인 구매자 행동을 시뮬레이션하는 자동화 솔루션입니다.
AI Video Workflow
주제, 기사 및 스크립트를 완전하고 타임스탬프가 동기화된 MP4 단편 또는 장편 비디오로 변환하는 Openclaw 에이전트용 자동화 및 프로그래밍 방식 AI 비디오 제작 파이프라인입니다.
추천*
