스킬 convex-migration-helper
📦

convex-migration-helper

콘텐츠 리비전 r1 안전 ⚙️ 외부 명령어🌐 네트워크 접근

안전한 Convex 데이터 마이그레이션 계획

Convex 스키마의 호환되지 않는 변경은 배포 실패를 일으키거나 프로덕션 데이터를 손상시킬 수 있습니다. 이 스킬은 안전한 롤아웃, 배치 백필, 드라이 런, 검증을 안내합니다.

지원: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 브론즈

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청
Review the Skillstore skill "convex-migration-helper" from https://skillstore.io/skills/get-convex-convex-migration-helper.md and its manifest at https://skillstore.io/api/skills/get-convex-convex-migration-helper/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/get-convex-convex-migration-helper.md 서명된 manifest GET /api/skills/get-convex-convex-migration-helper/manifest 서명된 lockfile GET /api/skills/get-convex-convex-migration-helper/lockfile

테스트해 보기

"convex-migration-helper" 사용 중입니다. user 테이블에 기존 계정을 위한 새 필수 role 필드가 필요합니다.

예상 결과:

  • role을 선택적으로 둔 확장된 스키마를 배포합니다.
  • 먼저 드라이 런을 수행한 뒤 누락된 role을 배치로 백필합니다.
  • role을 필수로 만들기 전에 마이그레이션되지 않은 계정이 남아 있지 않은지 확인합니다.

"convex-migration-helper" 사용 중입니다. team 테이블이 boolean plan 플래그에서 plan enum으로 변경됩니다.

예상 결과:

  • 기존 플래그를 선택적으로 유지하면서 새 plan 필드를 추가합니다.
  • 전환 기간 동안 새 문서를 새 형식으로 작성합니다.
  • 검증을 통과한 후에만 기존 리더와 필드를 제거합니다.

"convex-migration-helper" 사용 중입니다. 로컬 테스트 중 대규모 테이블 마이그레이션이 계속 시간 초과됩니다.

예상 결과:

  • 전체 테이블을 collect하는 대신 migrations 컴포넌트를 사용합니다.
  • 무거운 문서나 높은 쓰기 트래픽에는 배치 크기를 낮춥니다.
  • 마이그레이션 상태를 모니터링하고 실패 후 저장된 커서부터 다시 시도합니다.

보안 감사

안전
v4 • 2026. 7. 5. 버전별 보고서 열기

All static findings were adjudicated as false positives. The apparent SQLite and shell execution findings are Convex ctx.db examples and Markdown backticks in documentation. No prompt injection, data exfiltration intent, or hidden malicious behavior was found in the reviewed skill files.

5
스캔된 파일
569
분석된 줄 수
0
검토 항목
0
오탐 무시됨

위험 요인

⚙️ 외부 명령어 (14)
SKILL.md:48 SKILL.md:54-65 SKILL.md:65-69 SKILL.md:69-74 SKILL.md:74-78 SKILL.md:78-84 SKILL.md:84-110 SKILL.md:110-112 SKILL.md:112-116 SKILL.md:116-130 SKILL.md:130 SKILL.md:132-133 SKILL.md:133-143 SKILL.md:143-144
🌐 네트워크 접근 (1)
SKILL.md:110
가장 최근에 완료된 정적·의미론적 감사에서 확인된 보안 발견 사항이 감지되지 않았습니다. 이는 스킬에 부작용이 없음을 증명하지 않습니다.
감사자: codex 감사 이력 보기 →
이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기
보안 평가

보고서 링크 복사

https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/get-convex-convex-migration-helper/security.svg)](https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/get-convex-convex-migration-helper/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/get-convex-convex-migration-helper.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
학술 인용 (APA · BibTeX · CFF)

APA 인용

get-convex. (2026). convex-migration-helper security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4

BibTeX 인용

@techreport{get-convex-get-convex-convex-migration-helper-2026, author = {get-convex}, title = {convex-migration-helper security audit report (audit version 4)}, institution = {Skillstore}, year = {2026}, number = {4}, url = {https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "convex-migration-helper security audit report (audit version 4)" version: "unspecified" type: report authors: - name: "get-convex" date-released: "2026-07-05" url: "https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4" identifiers: - type: other value: "skillstore:get-convex-convex-migration-helper:audit:4" description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 높음
55
아키텍처
85
유지보수성
87
콘텐츠
68
커뮤니티
83
사양 준수

만들 수 있는 것

필수 필드를 안전하게 추가

먼저 선택적 필드를 추가하고, 기존 문서를 백필한 다음, 검증 후 필드를 필수로 만드는 롤아웃을 계획합니다.

무중단 롤아웃 준비

마이그레이션 기간 동안 애플리케이션 코드가 이전 데이터 형식과 새 데이터 형식을 모두 처리하는 단계적 배포를 설계합니다.

기존 데이터 모델 리팩터링

필드 삭제, 타입 변경, 테이블 분할, 고아 데이터 정리, 마이그레이션 완료 확인을 위한 단계를 매핑합니다.

이 프롬프트를 사용해 보세요

마이그레이션 필요 여부 식별 
이 Convex 스키마 변경을 검토하고 데이터 마이그레이션이 필요한지 알려주세요. 배포 순서와 주요 위험을 설명하세요.
필수 필드 롤아웃 계획 
기존 Convex 테이블에 필수 필드를 추가하기 위한 widen-migrate-narrow 계획을 작성하세요. 검증 및 롤백 메모를 포함하세요.
배치 마이그레이션 설계 
이 테이블에 대해 드라이 런, 상태 모니터링, 안전한 배치 크기 설정을 포함한 배치 Convex 마이그레이션을 설계하도록 도와주세요.
프로덕션 롤아웃 감사 
프로덕션 안전성을 기준으로 이 Convex 마이그레이션 계획을 감사하세요. 스키마 확장, 이중 읽기 또는 쓰기, 드라이 런 범위, 완료 확인을 점검하세요.

모범 사례

  • 프로덕션 데이터를 변경하기 전에 스키마를 확장합니다.
  • 프로덕션 실행 전에 드라이 런을 실행하고 상태를 검사합니다.
  • 스키마를 좁히기 전에 모든 문서가 마이그레이션되었는지 확인합니다.

피하기

  • 기존 문서가 백필되기 전에 필드를 필수로 만드는 것.
  • 대규모 테이블에서 배치 마이그레이션 대신 collect를 사용하는 것.
  • 리더와 라이터가 사용을 중단하기 전에 레거시 필드를 삭제하는 것.

자주 묻는 질문

widen-migrate-narrow란 무엇인가요?
단계적 워크플로입니다. 먼저 이전 데이터와 새 데이터를 모두 허용하고, 그런 다음 레코드를 마이그레이션한 뒤, 새 형태를 필수로 만듭니다.
이 스킬이 마이그레이션을 자동으로 실행하나요?
아니요. 계획과 예시를 제공합니다. 명령을 언제 실행할지는 사용자가 선택하며, 먼저 검토해야 합니다.
언제 @convex-dev/migrations를 사용해야 하나요?
사소하지 않은 백필, 대규모 테이블, 재개 가능한 작업, 드라이 런, 진행 상황 모니터링에 사용하세요.
무중단을 지원할 수 있나요?
예. 스키마를 좁히기 전 단계적 배포, 이중 읽기, 이중 쓰기, 검증을 설명합니다.
작은 테이블 마이그레이션도 지원하나요?
예. 작은 테이블의 경우 단일 내부 mutation이 허용될 수 있는 경우를 설명합니다.
프로덕션 전에 무엇을 해야 하나요?
중요한 데이터를 백업하고, 드라이 런을 실행하고, 마이그레이션 상태를 확인하고, 남아 있는 미마이그레이션 문서를 검증하세요.

개발자 세부 정보

작성자

get-convex

라이선스

MIT

Skillstore 리비전

r1

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/get-convex/agent-skills/tree/main/skills/convex-migration-helper/

참조

30c73eac2afe762f6aa9c4553158769369d47351

유지보수 최신성

2026. 7. 18.

사용량

3 다운로드 · 88 조회

파일 구조

📁 agents/

📄 openai.yaml

📁 assets/

📄 icon.svg

📁 references/

📄 migration-patterns.md

📄 migrations-component.md

📄 SKILL.md

get-convex의 다른 스킬

전체 보기

관련 스킬

전체 보기