스킬 convex-migrate-rehearse

📦

convex-migrate-rehearse

Name: convex-migrate-rehearse
Author: get-convex

콘텐츠 리비전 r1 안전 ⚙️ 외부 명령어

Rehearse Convex Migrations Before Production

Production schema migrations can fail when existing documents do not match new validators. This skill rehearses the migration on snapshot-seeded preview data before promotion.

지원: Claude Codex Code(CC)

🥉 77 브론즈

Maintain this Skill? Claim it 🥉 77 브론즈

내 에이전트로 설치

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

에이전트 요청

Review the Skillstore skill "convex-migrate-rehearse" from https://skillstore.io/skills/get-convex-convex-migrate-rehearse.md and its manifest at https://skillstore.io/api/skills/get-convex-convex-migrate-rehearse/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

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

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

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

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

테스트해 보기

"convex-migrate-rehearse" 사용 중입니다. Plan a migration that makes the customer region field required.

예상 결과:

The plan first adds an optional region field, backfills existing customers in preview, verifies every document, and then requires the field.

"convex-migrate-rehearse" 사용 중입니다. Review a rehearsal where twelve records still lack the new field.

예상 결과:

Promotion is blocked. Resume the batched backfill, verify that no records are missing the field, and repeat the tightened schema deployment.

"convex-migrate-rehearse" 사용 중입니다. Prepare the final production approval checkpoint.

예상 결과:

The checkpoint identifies production as the target, summarizes successful preview evidence, requests explicit approval, and warns that snapshot restoration loses later writes.

보안 감사

안전

v1 • 2026. 9. 21. 버전별 보고서 열기

Four findings are confirmed because the workflow directs external Convex commands that export real data or change remote deployments. Three findings are false positives caused by Markdown code spans that name credentials, tools, or flags without executing them. No prompt injection or malicious intent was found.

스캔된 파일

분석된 줄 수

검토 항목

오탐 무시됨

기능 검토 항목 (4)

이 스킬에 대해 예상될 수 있는 실제 로컬 기능이므로 검토가 필요하지만, 확인된 악의적 동작으로는 집계되지 않습니다.

높음

SKILL.md:20

Ruby/shell backtick execution

6. PROMOTE only on the fresh explicit yes from step 1: apply the SAME sequence to prod (optional sch

Line 20 directs production migration operations and documents a replace import for rollback. The restore can discard post-snapshot writes, making this a real high-impact external command risk.

중간

SKILL.md:16

Ruby/shell backtick execution

2. SNAPSHOT the source data read-only: `npx convex export --path snapshot.zip` (from the deployment

Line 16 explicitly directs an npx Convex export command against a deployment holding real data. The command creates a sensitive local snapshot and therefore has genuine data-handling risk.

중간

SKILL.md:17

Ruby/shell backtick execution

3. CREATE the preview FROM THE PRE-CHANGE CODE — do this BEFORE editing schema.ts, so the preview st

Line 17 directs Convex deploy and import commands that create and seed a remote preview deployment. These are intentional external state changes, although they are scoped to a preview.

중간

SKILL.md:18

Ruby/shell backtick execution

4. REHEARSE on the preview, in the migrate order — each push is `npx convex deploy --preview-name mi

Line 18 directs repeated Convex deployment commands and a migration backfill against the preview. These operations intentionally mutate remote schema and data.

위험 요인

⚙️ 외부 명령어 (7)

SKILL.md:14 SKILL.md:16 SKILL.md:17 SKILL.md:18 SKILL.md:19 SKILL.md:20 SKILL.md:25

감사자: codex

이 보고서 공유 및 인용

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

버전별 보고서 열기

보고서 링크 복사

https://skillstore.io/skills/get-convex-convex-migrate-rehearse/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

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

HTML 배지

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

임베드 카드

<iframe src="https://skillstore.io/embed/skills/get-convex-convex-migrate-rehearse.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-migrate-rehearse security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/get-convex-convex-migrate-rehearse/audits/1

BibTeX 인용

@techreport{get-convex-get-convex-convex-migrate-rehearse-2026,
  author = {get-convex},
  title = {convex-migrate-rehearse security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/get-convex-convex-migrate-rehearse/audits/1},
  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-migrate-rehearse security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "get-convex"
date-released: "2026-09-21"
url: "https://skillstore.io/skills/get-convex-convex-migrate-rehearse/audits/1"
identifiers:
  - type: other
    value: "skillstore:get-convex-convex-migrate-rehearse:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 중간

아키텍처

유지보수성

콘텐츠

커뮤니티

사양 준수

만들 수 있는 것

Validate a schema change

Rehearse a validator change against production-shaped data before changing the live deployment.

Review a migration release

Confirm that schema, backfill, verification, and promotion steps follow one tested sequence.

Prepare a controlled rollout

Document preview evidence, production approval, and rollback consequences for an operational change.

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

Check readiness

Review my Convex migration goal and list the preview credentials, source deployment, schema files, and verification details needed before rehearsal.

Build a rehearsal plan

Create a preview rehearsal plan for changing [field] in [table]. Include snapshot, optional schema, backfill, verification, and tightening stages.

Evaluate rehearsal evidence

Assess these preview results: [results]. Identify failed checks, remaining data-shape risks, and evidence required before production approval.

Prepare production promotion

Using this verified sequence, prepare a production runbook with explicit approval, deployment targeting, checkpoints, abort conditions, and snapshot rollback consequences.

모범 사례

Create and seed the preview from pre-change code before editing the schema.
Use optional fields, resumable backfills, verification, and validator tightening in that order.
Confirm the resolved deployment and obtain explicit approval immediately before production changes.

피하기

Do not tighten validators before existing documents have been backfilled.
Do not seed a snapshot into a preview that already uses the changed schema.
Do not restore a production snapshot without accepting the loss of later writes.

자주 묻는 질문

Why use a preview deployment?

A preview provides an isolated copy where schema validation can fail without interrupting production.

What credentials are required?

Preview creation requires a Preview Deploy Key. A standard Convex login session cannot create preview deployments.

Can I rehearse without a preview key?

Yes. Use a personal development deployment seeded with the snapshot and clearly record that fallback.

Why must the field become optional first?

Existing documents may not contain the field. Optional validation allows deployment and backfilling before the validator becomes strict.

How is the backfill performed?

The workflow uses batched, resumable migrations through the Convex migrations package instead of one large mutation.

What does rollback preserve?

The snapshot preserves data from export time. Restoring it removes any writes created after that point.

개발자 세부 정보

작성자

get-convex

라이선스

MIT

Skillstore 리비전

버전 안내

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

리포지토리

https://github.com/get-convex/agent-skills/tree/0aa10576821c6928f6a0f498c087af4ee231536e/skills/convex-migrate-rehearse

참조

ee1e1d0465cbfd49d2dffacf50000ec9a8812bf0

유지보수 최신성

2026. 9. 21.

사용량

0 다운로드 · 0 조회

파일 구조

📄 SKILL.md