# cga-prisma-migration

> Prismaを使用したDBスキーマ変更とマイグレーション管理。schema.prismaの編集、マイグレーション生成・適用、型定義作成を行う。Use when user wants to "add table", "modify schema", "create migration", "add column", "Prismaでマイグレーション", or needs database schema changes with Prisma.

- Author: “Eiji
- Repository: haru01/order_skills_sample
- Version: 20260202195235
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/haru01/order_skills_sample
- Web: https://mule.run/skillshub/@@haru01/order_skills_sample~cga-prisma-migration:20260202195235

---

---
name: cga-prisma-migration
description: Prismaを使用したDBスキーマ変更とマイグレーション管理。schema.prismaの編集、マイグレーション生成・適用、型定義作成を行う。Use when user wants to "add table", "modify schema", "create migration", "add column", "Prismaでマイグレーション", or needs database schema changes with Prisma.
allowed-tools: Read Glob Grep Edit Write Bash AskUserQuestion
disable-model-invocation: true
---

## いつ使うか

- テーブル追加・変更するとき
- カラム追加・削除するとき
- インデックス作成するとき

## いつ使わないか

- `schema.prisma` の変更を伴わない型定義の変更
- テーブル設計が未確定のとき（先に `/cga-explore-planning` で設計を決める）

## 何をするか

1. `prisma/schema.prisma` を編集
2. `npx prisma migrate dev --name {name}` でマイグレーション生成
3. `npx prisma generate` でクライアント生成
4. `src/models/` に型定義作成

## 命名規則

- `add_{table}` - テーブル追加
- `add_{column}_to_{table}` - カラム追加
- `remove_{column}_from_{table}` - カラム削除
- `create_{index}_index` - インデックス追加

## 中断条件

以下の場合はマイグレーションを中断し、開発者に確認を求める:

- **破壊的変更**: 既存データの削除・型変更を伴うマイグレーションが生成された場合
- **複数テーブル影響**: 予期しない複数テーブルへの影響が検出された場合

## 注意事項

- 本番環境では `migrate deploy` を使用
- 破壊的変更は段階的に実行
- バックアップを取ってから実行

## 使用例

```text
/cga-prisma-migration OrderテーブルにcancelledAtカラムを追加して
/cga-prisma-migration 新しいPaymentテーブルを作成して
```

## トラブルシューティング

### マイグレーション競合エラー

```bash
# マイグレーション履歴をリセット
npx prisma migrate reset
```

### Prisma Clientが古い

```bash
# クライアント再生成
npx prisma generate
```

### マイグレーション失敗時のロールバック

1. 失敗したマイグレーションファイルを削除: `prisma/migrations/{failed_migration}/`
2. `prisma migrate dev` で再生成

### データベース接続エラー

- `.env` の `DATABASE_URL` を確認
- データベースが起動しているか確認

## 詳細

[guide.md](guide.md) を参照