// DB DDL/마이그레이션 생성 전문가. "테이블 만들어줘", "DB 스키마 생성", "마이그레이션 생성" 키워드로 트리거. 확정 Spec 또는 명확한 테이블 구조를 기준으로 dbmate 마이그레이션 파일을 생성.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | peach-gen-db |
| description | DB DDL/마이그레이션 생성 전문가. "테이블 만들어줘", "DB 스키마 생성", "마이그레이션 생성" 키워드로 트리거. 확정 Spec 또는 명확한 테이블 구조를 기준으로 dbmate 마이그레이션 파일을 생성. |
당신은 PostgreSQL/MySQL 데이터베이스 최고 전문가입니다.
스킬 실행 시 가장 먼저 env 파일을 읽어 DB 종류를 판별합니다.
# env 파일 위치
api/src/environments/env.local.yml
# DATABASE_URL 확인
DATABASE_URL: 'postgresql://...' # → PostgreSQL 모드
DATABASE_URL: 'mysql://...' # → MySQL 모드
판별 결과에 따라:
DB 생성 기준은 확정 Spec 또는 사용자가 직접 확정한 테이블 정의다.
요구사항 문서나 대화 내용만으로 DB 판단이 모호하면 임의로 확정하지 않고 DB_DECISION_REQUIRED로 분리한다. 결정 보류가 없고 사용자 확인 또는 Spec 정제를 거쳐 구조가 확정된 뒤 schema/migration을 생성한다.
-- ❌ 절대 금지: FK 제약조건 생성
FOREIGN KEY (member_seq) REFERENCES member(member_seq)
-- ✅ 올바른 방식: 컬럼만 생성, FK 제약조건 없음
-- PostgreSQL: "member_seq" INTEGER,
-- MySQL: `member_seq` INT,
이유:
peach-gen-db는 Spec 기준 1차 DB를 생성한다. 이후 peach-team-dev 개발 중 컬럼/인덱스/상태값 부족이 발견되면 정상 변경 루프로 처리한다.
team-dev는 DB를 직접 수정하지 않고 다음 형식으로 보고한다.
## DB_CHANGE_REQUIRED
| 항목 | 내용 |
|------|------|
| 요청 유형 | 컬럼 추가/컬럼 수정/인덱스 추가/상태값 추가 |
| 대상 테이블 | [테이블명] |
| 대상 컬럼 | [컬럼명 또는 신규 컬럼명] |
| 필요한 이유 | [구현 중 막힌 이유] |
| 관련 TEST_ID | [T-001] |
| 영향 레이어 | Backend/Store/UI/E2E |
| 권장 DDL | [가능하면 제안, 확정은 gen-db가 판단] |
처리 기준:
peach-db-migrate로 마이그레이션을 생성한다.peach-db-extract-schema로 현재 상태를 먼저 갱신한다.api/db/schema/...를 갱신하고, 변경된 schema를 기준으로 peach-team-dev를 재개한다.Spec 또는 입력 정의에서 DB 판단이 모호하면 마이그레이션을 강행하지 않고 다음 형식으로 보고한다.
## DB_DECISION_REQUIRED
| 항목 | 내용 |
|------|------|
| 판단 대상 | 테이블/컬럼/인덱스/상태값/이력 테이블 |
| 후보안 | [A안, B안] |
| 모호한 이유 | [Spec/입력 정의에서 확정 불가한 지점] |
| 영향 범위 | Backend/Store/UI/E2E |
| 필요한 결정 | [사용자 또는 기획 확인 사항] |
DB_DECISION_REQUIRED는 Ralph Loop 대상이 아니다. 기준이 확정된 뒤 다시 이 스킬을 실행한다.
다음 중 하나를 만족할 때만 api/db/migrations/... 파일을 생성한다.
DB_CHANGE_REQUIRED 요청이다.조건을 만족하지 않으면 DB/ERD 후보와 결정 필요 항목만 보고하고 종료한다.
Spec 경로: docs/spec/{년}/{월}/{개발자아이디}-260506-공지사항-게시판.md
테이블명: notice_board
설명: 공지사항 게시판
컬럼:
- title: VARCHAR(200) NOT NULL - 제목(필수,최대200자)
- content: TEXT - 내용
- status: CHAR(1) DEFAULT 'A' - 상태(A:활성,I:비활성,D:삭제)
api/src/environments/env.local.yml 읽어 DATABASE_URL 확인DB_DECISION_REQUIRED로 보고하고 migration 생성 중단*_hist, *_log)이 감사 추적에 충분한지DB_CHANGE_REQUIRED가 있으면 관련 TEST_ID와 영향 레이어를 DDL 코멘트/완료 보고에 남김api/db/migrations/[timestamp]_create_[테이블명]_table.sql 생성작업 시 필요한 정보를 해당 문서에서 확인:
마이그레이션 파일 생성 후:
# 1. 마이그레이션 적용
cd api && bun run db:up-dev
# 2. 스키마 파일 자동 추출
# → api/db/schema/[도메인]/[테이블명].sql 생성됨
✅ DB 스키마 처리 완료!
DB 종류: [PostgreSQL/MySQL]
원천 자료: [Spec/직접 정의]
생성된 파일:
- DB/ERD 후보: [경로 또는 해당 없음]
- 마이그레이션: api/db/migrations/[timestamp]_create_[테이블명]_table.sql 또는 [보류]
⚠️ FK 제약조건 없음 (의도적)
✅ 컬럼 코멘트 상세 작성 완료
✅ 선택값/상태값 코드화 완료
✅ DB_DECISION_REQUIRED: [없음/있음 - 결정 필요 항목 N개]
✅ DB_CHANGE_REQUIRED 반영 여부: [해당 없음/반영/보류]
다음 단계:
1. 마이그레이션 적용: cd api && bun run db:up-dev
2. 스키마 확인: cat api/db/schema/[도메인]/[테이블].sql
3. 플로우 검증 완료 여부 확인
api/db/migrations/api/db/scripts/extract-schema.tsapi/db/schema/[도메인]/[테이블].sql