D1 마이그레이션 워크플로

무엇을 해주나

• pnpm db:generate로 생성된 마이그레이션 SQL을 적용 전에 검수하도록 유도합니다. 특히 Drizzle이 default 값 변경 시 만들어내는 "테이블 재생성(CREATE new → INSERT SELECT → DROP → RENAME)" 패턴을 위험 신호로 잡아내고, 단순 ALTER TABLE ADD COLUMN으로 고치는 방법을 제시합니다.
• 로컬과 원격 양쪽에 모두 적용(--local / --remote)하고 PRAGMA table_info로 검증하는 절차를 정해줍니다.
• 부분 적용으로 막힌 마이그레이션을 진단(d1_migrations 조회)하고 수동 기록으로 복구하는 절차를 안내합니다.
• D1 파라미터 한도(약 100~150개)로 인한 대량 INSERT 실패를 배치 처리로 회피하는 코드 패턴을 제공합니다.
• Drizzle camelCase vs 원시 SQL snake_case 컬럼 명명 규칙, 신규 프로젝트에서 Worker 배포 → D1 생성 → binding → 재배포 순서를 정리해줍니다.

이런 분께 추천

• Cloudflare Workers + D1 + Drizzle ORM으로 서비스를 운영하는 백엔드/풀스택 개발자
• 마이그레이션이 "로컬은 되는데 프로덕션은 깨지는" 문제를 반복 겪는 팀
• wrangler CLI 명령을 매번 검색해서 쓰는 분

활용 예시

1. 스키마에 컬럼을 추가한 뒤 "마이그레이션 생성하고 적용해줘"라고 요청 → Claude가 생성된 SQL을 먼저 읽고 테이블 재생성 패턴이 있으면 안전한 ALTER 문으로 수정한 후 로컬·원격에 적용.
2. db:migrate가 "duplicate column" 에러로 실패할 때 → PRAGMA table_info와 d1_migrations 조회로 부분 적용을 확인하고, 해당 마이그레이션을 수동 기록해 이후 마이그레이션을 정상 진행.
3. 시드 데이터 500행 삽입이 조용히 실패할 때 → 10행 단위 배치 루프로 리팩터링.

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

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

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