关于 peach-db-extract-schema
用于根据数据库当前状态重新提取模式文件的技能，不执行迁移。它会汇总文件变化，帮助保持模式文件与数据库一致。
主要功能
- 01从数据库当前状态提取模式
- 02创建和更新 SQL 模式文件
- 03清理已删除表对应的文件
- 04汇报文件与 DDL 变化
- 05按表名首段对文件分类
适用场景
- 01同步他人直接修改数据库后的文件
- 02检查疑似模式不一致
- 03不运行迁移而查看结构
- 04生成项目初始模式文件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/peach-db-extract-schema确认已加载。
README 原文English
来自项目 READMEREADME 暂无中文译文，以下为英文原文；中文介绍见上方。
DB 스키마 추출
마이그레이션 없이 DB의 현재 상태를 스키마 파일로 재추출한다.
bun run db:up-dev/db:down-dev실행 시에는 extract-schema가 자동 체이닝되므로, 이 스킬은 수동 추출이 필요할 때만 사용한다.
워크플로우
1단계: 스키마 추출 실행
cd api && bun run db:extract-schema
2단계: 결과 요약
실행 결과에서 아래 4가지 수치를 보여준다:
- Created: 새로 생성된 스키마 파일
- Updated: DDL이 변경되어 갱신된 파일
- Unchanged: 변경 없는 파일
- Deleted: DB에서 삭제된 테이블의 스키마 파일 정리
3단계: 변경 파일 상세
Updated 또는 Created 파일이 있으면:
- 변경된 파일 목록을 보여준다.
- 주요 변경 내용(컬럼 추가/삭제, 인덱스 변경 등)을 요약한다.
출력 파일 위치
api/db/schema/{도메인}/{테이블명}.sql
도메인은 테이블명의 첫 번째 _ 앞 부분으로 자동 분류된다:
order_item.sql→schema/order/order_item.sqlcommon_file.sql→schema/common/common_file.sqlmember.sql→schema/member/member.sql
추출 내용
- CREATE TABLE DDL (컬럼, 타입, 기본값, NOT NULL)
- COMMENT ON TABLE / COLUMN (한글 코멘트)
- CREATE INDEX (Partial Index WHERE 절 포함)
- PRIMARY KEY CONSTRAINT
사용 시점
- 다른 개발자가 DB를 직접 변경한 후 스키마 파일 동기화
- 스키마 파일과 실제 DB 상태 불일치 의심 시
- 마이그레이션 없이 DB 구조만 확인하고 싶을 때
- 새 프로젝트 환경에서 최초 스키마 파일 생성 시
评论
支持 Markdown