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 版本，必要时包括预发布后缀；初始化前验证其版本。不要依赖可能不再指向 8 的浮动 latest。

使用项目的包管理器运行已安装的 CLI。对于 PostgreSQL 和 Prisma schema language 编写：

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 skill 版本，以及查询结果。仅安装软件包或成功同步 skill 并不代表设置已完成。