Prisma CLI Reference

Prisma CLI Reference 是什么

Prisma CLI Reference 是 Prisma 官方的 ORM 命令行参考 Skill，覆盖项目初始化、客户端生成、本地 Prisma Postgres、数据库同步、迁移、数据填充、Studio、schema 校验、格式化、调试和 MCP。它明确区别 Prisma ORM CLI 与 Prisma Platform 或 Compute CLI，防止同名命令体系混用。

适用场景与选择边界

适合回答 prisma init、generate、db pull、db push、db seed、migrate dev、migrate deploy、migrate diff、migrate resolve、studio、validate 和 debug 等任务。数据库提供商初始配置应配合 Database Setup，业务查询代码则配合 Client API。

核心能力与工作机制

命令按 Setup、Generation、Development、Database、Migrations 与 Utility 分类。迁移是最高风险区域：开发环境用 migrate dev 生成与应用迁移，生产用 migrate deploy 应用已有迁移；reset 会重置数据，resolve 用于标记迁移状态，diff 用于比较 schema 来源。

实际工作流

先识别命令类别、Prisma 版本、schema 路径和目标环境，再读取对应参考。执行前显示将运行的命令并解释影响；只读 validate、format、status 或 diff 可以先做。任何会改变数据库的 push、migrate、execute、seed 或 reset 都要核对连接目标、备份与用户意图。

输入、输出与交付物

输入包括项目目录、schema 或 config、数据库 URL、目标环境和期望动作。输出可以是初始化文件、生成的 Client、迁移目录、同步后的数据库、诊断信息或 Studio 会话；高风险命令还要报告实际目标、变更范围和恢复方案。

依赖、账号与权限

需要兼容版本的 Node、Prisma CLI、数据库驱动和可访问的数据源。命令默认读取项目配置与环境变量，执行前应确认没有误加载生产 DATABASE_URL。MCP 与 Studio 会开放本地服务，也要注意监听地址和数据权限。

限制与安全风险

migrate reset 会丢失数据，db push 可能绕过迁移历史，db execute 可运行任意 SQL，错误环境变量可能把开发命令指向生产。代理不能自动批准破坏性命令；即使用户说“修好迁移”，也应先展示状态、diff 和影响。

适合谁使用

适合 Prisma 项目的开发者、数据库迁移维护者和 CI/CD 工程师。初学者可把它作为命令选择地图；生产数据库管理员应结合组织审批、备份和监控流程使用。

上手与验收建议

先运行 version、validate 和 migrate status 建立只读基线，再决定后续命令。开发迁移在临时数据库演练，生产只部署已审查迁移。验收时检查 schema、生成 Client、迁移表、应用启动与关键查询，不能只看 CLI 输出。

来源、版本与许可

依据 prisma/skills 固定提交中的完整 Prisma CLI Reference、skills.sh 详情与 MIT 许可证整理。

常见问题

1. Prisma ORM CLI 与 Platform CLI 是一回事吗？

不是。本 Skill 只覆盖 ORM 项目中的 init、generate、db、migrate、Studio 等命令，不应把 Prisma Platform 或 Compute 的账户与云资源命令套进这个工作流。

2. migrate dev 与 migrate deploy 如何选择？

migrate dev 用于开发环境创建并应用新迁移，可能使用影子数据库；migrate deploy 只应用仓库中已有迁移，适合 CI 和生产。生产环境不应临时生成迁移。

3. db push 可以代替迁移历史吗？

它适合原型或明确不需要迁移历史的同步场景，但可能直接改变数据库而不生成迁移文件。需要审计、回滚和多环境发布时，应使用正式迁移流程。

4. 为什么 migrate reset 属于高风险命令？

reset 会重置数据库并重新应用迁移，通常伴随数据丢失。执行前必须确认是可丢弃环境、目标 URL 正确且已有必要备份，不能在生产中自动运行。

5. 遇到迁移状态不一致时怎么做？

先运行 migrate status 和必要的 migrate diff，确定数据库与迁移目录差异；只有理解实际历史后才用 migrate resolve 标记状态，不能用 resolve 掩盖未应用变更。

6. schema 修改后需要执行什么？

至少运行 validate 检查语法和关系，再执行 generate 更新 Prisma Client。若涉及数据库结构，还应按环境选择迁移或受控同步，并测试应用查询与回滚路径。

7. Prisma Studio 有哪些安全注意事项？

Studio 能浏览和修改数据库数据，应确认连接目标与监听地址，不要把生产 Studio 暴露到公网。共享屏幕或日志时也要避免泄露个人数据与凭据。

8. 代理执行 CLI 前应展示什么？

应说明完整命令、工作目录、schema 或 config、目标环境、是否会改变数据以及恢复方案。对 reset、push、execute 和生产 migrate 等高风险动作，必须取得明确确认。