prisma-orm-setup

Prisma ORM のセットアップ

このスキルでは、セットアップと接続作業で使用する ORM のバージョンを管理します。アプリケーションの ORM バージョンと、使用するデータベースを維持してください。接続の修復にメジャーバージョンのアップグレードは必要ありません。

新規アプリケーションでは、デフォルトで Prisma ORM 8 を使用します。Prisma 8 の詳細な設定、クエリ、マイグレーション、ランタイムコードについては、ORM パッケージに同梱されているバージョン別の prisma-8 skill を参照してください。

1. 現在の状態を確認する

パッケージマニフェスト、ロックファイル、Prisma 設定、スキーマ、アプリケーションのインポートを確認します。ORM のバージョン、データベースプロバイダー、ランタイムを特定してください。CLI のバージョンだけでは、アプリケーションのバージョンは特定できません。Prisma 8 CLI とレガシークライアントが共存する場合があるため、@prisma/client、@prisma/prisma7、スキーマ、設定を確認してください。

開始時の状態	手順
Prisma 8 アプリケーション	再初期化せずに手順 4 へ
バージョンを選択していない新規アプリケーション	手順 3
Prisma 6 または 7 のアプリケーション、あるいは明示的に選択した旧メジャーバージョン	手順 5

新規アプリケーションの場合、インストール前に、選択した Prisma 8 リリースのプロバイダーのサポート状況とランタイム要件を確認してください。プロバイダーがサポートされていない場合は、その制限を説明し、明示的に選択した旧バージョンを提案してください。要求されたデータベースを維持し、黙って別のデータベースに切り替えたり、サポート対象のデータベースを独自に選んだりしないでください。

既存のデータベースが指定されている場合は、それを使用してください。Prisma Postgres が必要で、まだ接続先が選択されていない場合に限り prisma-postgres-setup を読み込み、接続後にこの手順へ戻ってください。

2. 要求されたメジャーアップグレードは別途扱う

ユーザーからメジャーアップグレードを依頼された場合は、移行元のバージョンとプロバイダーに対応したワークフローを読み込んでください。PostgreSQL の 7 から 8 へのアップグレードには、Prisma の移行ガイドを使用してください。MongoDB の 6 から 8 へのアップグレードには、prisma-mongodb-upgrade を使用してください。その他のプロバイダーでは、明示的にサポートされた移行パスが必要です。prisma-upgrade-v7 は 6 から 7 へのアップグレードに対応し、パッケージに同梱された prisma-8 のアップグレードリファレンスは 8 内の更新に対応します。

3. 新しい Prisma 8 アプリケーションを初期化する

選択したリリースのランタイム要件と初期化ガイドを確認してください。公開済みの Prisma CLI 8 リリースを解決して固定し、必要であればプレリリースのサフィックスも含めてください。初期化の前にバージョンを確認してください。変動する latest が引き続きバージョン 8 を指すことを前提にしないでください。

プロジェクトのパッケージマネージャーを使用して、インストール済みの CLI を実行してください。PostgreSQL と Prisma スキーマ言語で記述する場合は、次のとおりです。

prisma orm init --yes --target postgres --authoring psl

選択したプロバイダーでサポートされているターゲットを使用してください。既存のアプリケーションファイルと接続設定を維持し、セットアップによって無関係なデータベースをプロビジョニングしないでください。続行する前に、解決された ORM パッケージのバージョンが 8 であることを確認してください。

4. インストール済みの Prisma 8 のガイダンスを読み込む

プロジェクトのパッケージマネージャーを使用して、インストール済みの CLI を実行してください。

prisma skills sync

次に、同期された prisma-8/SKILL.md（例：.agents/skills/prisma-8/SKILL.md）を読み、前提条件と選択したリファレンスに従ってください。同期しただけでは手順は読み込まれません。パッケージに同梱されたガイダンスを読み込めない場合は、作業を妨げている問題を報告してください。手順 6 に進んでください。

5. 以前のバージョンをセットアップまたは修復する

以前のバージョンを明示的に選択して新規セットアップする場合は、パッケージをそのメジャーバージョンに固定し、対応するランタイム要件を使用します。CLI、クライアント、SQL アダプターのリリース間で互換性を保ってください。接続の修復であれば、既存の依存関係を変更する必要はありません。

• Prisma 7 SQL: 以下のプロバイダーリファレンスとクライアントのセットアップを使用します。
• Prisma 6 MongoDB: MongoDB のセットアップを使用します。SQL ドライバーアダプターは適用されません。
• Prisma 6 SQL: そのジェネレーター、スキーマ URL、クライアント初期化を維持します。以下のプロバイダーの接続情報とPrisma 6 のドキュメントを使用し、Prisma 7 の設定やアダプターの例をコピーしないでください。

データベース	リファレンス
PostgreSQL	PostgreSQL
MySQL / MariaDB / PlanetScale	MySQL
SQLite / Turso	SQLite
Microsoft SQL Server / Azure SQL	SQL Server
CockroachDB	CockroachDB
Prisma 6 の MongoDB / Atlas	MongoDB
Prisma 7 の Prisma Postgres	Prisma Postgres

Prisma 7 の SQL の例は Prisma 7.10.0 で、MongoDB の例は Prisma 6.19.3 で検証されています。

6. 接続して検証する

CLI とアプリケーションでは、異なる環境ファイルが読み込まれる場合があります。秘密情報を表示せずに、それぞれで意図した環境を読み込み、認証情報は無視対象の環境ファイルまたはホストのシークレット設定に保管してください。SQL アダプターでは、アダプターのランタイムオプションが CLI の接続 URL と同じデータベースを参照するようにしてください。

既存のアプリでは、依頼された作業で変更が必要な場合を除き、スキーマ、マイグレーション、ジェネレーター設定を維持してください。スキーマを変更するコマンドを実行する前に、接続を診断してください。

プロジェクトに関連するチェックを実行し、アプリケーションのクライアントを通じて、意図したデータベースに対して読み取り専用のクエリを実行してください。ORM のバージョン、該当する場合は読み込まれた prisma-8 スキルのバージョン、クエリ結果を報告してください。パッケージのインストールやスキルの同期に成功しただけでは、セットアップが完了したことにはなりません。