Prisma ORM 7 CLI 参考技能,用于 prisma/skills 仓库中的 prisma-cli 条目。其命令与示例仅适用于 Prisma ORM 7;如需项目初始化、连接修复或 Prisma 8 应用,应改用 prisma-orm-setup 技能。使用时应调用与项目版本匹配的 CLI,不要安装浮动的 prisma@latest 来运行这些命令。
用途:为明确选定 Prisma 7 的工作流提供 CLI 命令参考,包括初始化项目、生成 Prisma Client、运行数据库迁移、管理数据库状态、使用本地开发数据库、调试 Prisma 问题以及生成 shell 补全代码。同时区分稳定版 ORM 命令(prisma)与公测版平台包(@prisma/cli,二进制 prisma-cli);Compute 应用与工作区认证应使用 prisma-compute,平台项目与数据库应使用 prisma-postgres-setup。
主要能力与命令分类:按优先级划分为 Setup(init,HIGH)、Generation(generate,HIGH)、Development(dev,HIGH)、Database(db-,HIGH)、Migrations(migrate-,CRITICAL)、Utility(complete、studio、validate、format、debug、mcp,MEDIUM)。具体命令包括:prisma init(创建 prisma/ 目录与 prisma.config.ts,可指定 datasource-provider 如 postgresql、mysql、sqlite,或使用 --db 云数据库、--with-model 示例模型);prisma generate(生成 Prisma Client,支持 --watch 与 --generator);prisma dev(本地 Prisma Postgres 开发库,支持 --name、--detach、ls、stop、rm);数据库操作 prisma db pull、db push、db seed、db execute --file;迁移命令 prisma migrate dev(含 --name、--create-only)、migrate reset、migrate deploy、migrate status、migrate diff(--from-config-datasource、--to-schema、--script)、migrate resolve;工具命令 prisma studio、prisma mcp、prisma version/-v、prisma debug、prisma validate、prisma format、prisma complete zsh。
使用方式:使用 Bun 时需加 --bun 标志,如 bunx --bun prisma init、bunx --bun prisma generate,否则因 CLI shebang 会回退到 Node.js。配置使用 prisma.config.ts,通过 defineConfig 定义 schema、migrations.path、migrations.seed、datasource.url(env('DATABASE_URL')),并显式加载环境变量(常用 import 'dotenv/config')。在当前命令行为下,migrate dev、db push 等 schema 同步后需显式运行 prisma generate 生成最新客户端,需种子数据时在 migrate dev 或 migrate reset 后显式运行 prisma db seed。详细命令文档分散于 references 目录下的各规则文件。
适用场景:已存在的 Prisma 7 应用或明确选择的 Prisma 7 工作流。
限制与安全说明:不适用于 Prisma 8 或 setup/连接修复场景。Prisma 在检测到 AI 代理时会阻塞破坏性命令(migrate reset、db push --force-reset、db push --accept-data-loss),直到代理获得用户明确同意;须在运行前解释确切的数据丢失影响并立即征求同意,不得从先前或不相关消息推断同意;自动化需同意变量时,将 PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION 设为用户的确切同意文本,不得编造。Prisma MCP 服务器故意不提供 migrate-reset 工具。执行任何破坏性 Prisma 命令前应阅读 references/agent-safety.md。