prisma-postgres-setup

Prisma Postgres 设置

连接目标数据库，然后从应用程序中验证连接。将资源配置与 ORM 配置分开处理，以便复用现有数据库。

1. 检查项目

检查用户指定的 ORM 或驱动程序、已安装的软件包、数据库连接以及用于加载环境变量的文件。确认密钥是否存在，但不要打印其值。

• 遵循 Drizzle、pg 或仅设置数据库等明确选择。
• 对已配置应用中的查询或架构进行操作时，请使用与其版本匹配的 ORM 指南；不要重新开始设置。

2. 复用或获取数据库

情况	操作
已有连接或已连接的集成	验证其项目、数据库和环境；复用该连接。
v0、Vercel Marketplace 或 Vercel 项目	阅读 Marketplace 设置，并使用原生集成流程。
尚无数据库且未指定提供商	提供 npx create-db@latest 选项：立即创建可用数据库，无需账户（除非认领，否则 24 小时后会删除；认领需要免费的 Prisma 账户。请阅读 资源配置 中的 create-db 部分）；或者通过 资源配置 创建持久数据库。如果请求中没有说明，请询问用户选择哪种方式。
独立的持久数据库	阅读 资源配置；使用经过身份验证的 CLI、MCP 工具、Console 或 Management API。
请求临时开发数据库	阅读 资源配置 中的 create-db 部分，包括有效期和认领说明。

创建前，先确定工作区、项目和区域。如果有多个合适的资源，请询问用户要使用哪一个。如果权限或配额阻止资源配置，请说明阻碍；不要删除其他资源，也不要切换工作区来绕过限制。

3. 连接应用程序

根据所选驱动程序和运行时使用适当的连接方式。将连接信息存储在项目的机密环境配置中，绝不要放入源代码或聊天中。保留无关条目，只更新目标变量一次，并确保本地机密文件已从 Git 中忽略。

应用程序进程和 CLI 命令可能加载不同的环境文件。例如，某个框架可能会加载 .env.development.local，而 shell 命令不会。shell 中缺少变量并不意味着数据库不存在：在运行该命令时加载指定文件，但不要显示凭据，也不要另行配置数据库。

4. 配置 ORM 并验证

设置 Prisma ORM 时，请直接阅读 prisma-orm-setup/SKILL.md，或者在宿主能够按名称解析同级技能时加载已安装的 prisma-orm-setup 技能。该技能负责选择 ORM 版本并进行配置。如果无法移交给该技能，请说明这一点。

如果用户明确选择了其他方案，请保留该 ORM 或驱动程序，并使用其文档中的设置方法。仅设置数据库时，验证连接后即可停止。

通过应用所选的 ORM 或驱动程序，对目标数据库执行只读查询。报告连接的数据库、所选 ORM/版本以及查询结果，不要泄露机密。如果任何步骤受阻或未经测试，请如实说明，不要声称设置已完成。

如需使用 Studio、SDK 集成或执行初始设置以外的数据库操作，请阅读 操作。