Cloudflare D1 마이그레이션 워크플로

무엇을 해주나

• pnpm db:generate로 만든 마이그레이션 SQL을 적용 전에 반드시 검토하도록 유도하고, Drizzle이 기본값 변경 시 생성하는 위험한 "테이블 재생성(CREATE new → INSERT SELECT → DROP → RENAME)" 패턴을 찾아 단순 ALTER TABLE ADD COLUMN으로 고치는 방법을 안내합니다.
• 로컬(--local)과 리모트(--remote) 양쪽 모두에 적용하는 순서와, PRAGMA table_info로 검증하는 명령을 제공합니다.
• 컬럼은 이미 추가됐는데 마이그레이션 기록이 남지 않아 재시도 시 중복 컬럼 오류가 나는 "막힌 마이그레이션"을 d1_migrations 테이블 조회/수동 기록으로 복구합니다.
• D1의 파라미터 한계(대략 행×열 100~150개)로 인한 대량 INSERT 실패를 배치 분할 코드로 회피합니다.
• Drizzle 스키마(camelCase)와 원시 SQL(snake_case) 네이밍 규칙, 신규 프로젝트에서 Worker 배포 → D1 생성 → database_id 연결 → 재배포 → 마이그레이션 순서를 정리합니다.

이런 분께 추천

• Cloudflare Workers + D1 + Drizzle ORM으로 서비스를 운영하는 개발자
• "로컬에선 되는데 프로덕션에서 깨지는" 스키마 문제로 시간을 뺏긴 적 있는 분
• Claude Code에게 마이그레이션 실행/오류 해결을 맡기고 싶은 분

활용 예시

1. "컬럼 추가 마이그레이션 생성했는데 적용하면 실패해" → 생성된 SQL의 테이블 재생성 패턴을 짚어내고 ALTER TABLE ... ADD COLUMN 한 줄로 교체.
2. "db:migrate가 이미 끝난 것 같은 마이그레이션에서 계속 에러야" → PRAGMA table_info와 SELECT * FROM d1_migrations로 진단한 뒤 해당 마이그레이션을 수동 기록하고 나머지를 이어서 실행.
3. "시드 데이터 500행을 넣는데 조용히 실패해" → BATCH_SIZE 10 단위 분할 삽입 코드로 변경.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/jezweb/claude-skills/HEAD/archive/plugins/cloudflare/skills/d1-migration/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 jezweb/claude-skills 의 archive/plugins/cloudflare/skills/d1-migration 폴더를 내 ~/.claude/skills/jezweb-d1-migration/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.