Prisma 官方 Skills:Prisma 6 停补丁,让 Agent 接手升级

今天(2026-11-19)是 Prisma ORM 6 安全补丁的最后一天,而 npm 上 prisma 的 latest 标签已经是 Prisma 8 的候选版 8.0.0-rc.34。还在 6 或 7 上的项目,下一次随手 npm install prisma 就可能装到一个不认 schema.prisma 的新 CLI。Prisma 官方的 Agent Skills 仓库 prisma/skills 就是为这种情况准备的:装进 Claude Code、Cursor、Codex 这类编程 Agent,让它先认清项目在哪个版本,再按官方步骤升级或原地修。这篇按仓库 README、各 Skill 的 SKILL.md 和 Prisma 官方文档整理。
它是什么
一组写给编程 Agent 看的操作说明,格式遵循 Agent Skills 规范,每个 Skill 是一个 SKILL.md 加若干参考文件。Agent 碰到「帮我跑迁移」「升级到 Prisma 7」这类任务时自动加载对应的那份。
| 仓库 | github.com/prisma/skills |
|---|---|
| 作者 | Prisma 官方团队 |
| 许可证 | MIT |
| 热度 | GitHub 80 星(GitHub API,2026-11-19 15:15 北京时间);skills.sh 仓库页 11 个 Skill 累计 4.0M 次安装,当天 24 小时热门榜上有 8 个 Prisma Skill,各约 2.4–2.5K 次安装 |
| 运行要求 | 任何支持 Agent Skills 的编程 Agent;用 npx skills 安装需要 Node.js |
| 最近更新 | 2026-11-09 19:24(北京时间)合入 #38,新增 prisma-postgres-upgrade(Prisma 6/7 → 8) |
解决什么问题
Prisma 7 发布刚满一年,8 的候选版又来了,两次改动都落在 Agent 最容易想当然的地方。Prisma 7 要求 SQL 数据库必须装驱动适配器、配置挪进 prisma.config.ts、环境变量要自己用 dotenv 加载;Prisma 8 换了一套 CLI 和运行时包,不读 schema.prisma,没有 generate、migrate dev、db push。Agent 照着训练数据里的老写法改,很容易把一个能跑的 Prisma 6 项目改坏。
按官方发布状态页,三个版本现在是这个局面:
| 版本 | 现状 | npm 包 |
|---|---|---|
| Prisma ORM 6 | 安全补丁到 2026-11-19 结束 | 文档留在 /orm/v6 |
| Prisma ORM 7 | 8 正式版发布后再维护 18 个月 | @prisma/client 停在 7.10.1 |
| Prisma ORM 8 | 候选版,API 还可能小改 | prisma 8.0.0-rc.34,@prisma/orm-postgres 8.0.0-rc.24(npm latest,11-19 查询) |
Skill 做的事是让 Agent 先看 package.json、锁文件、schema 和 import,判断项目到底在哪个大版本,再决定走哪条路。prisma-orm-setup 里直接写了:修连接不需要升大版本,Prisma 6/7 的项目原样留在原版本。
该装哪一个
| 你的情况 | 用这个 Skill | 要点 |
|---|---|---|
| 新项目,或修数据库连接 | prisma-orm-setup | 新项目默认 Prisma 8,要求钉死一个 8 的具体版本,不靠浮动的 latest |
| 还没有数据库 | prisma-postgres-setup | 可用 npx create-db 建临时库,默认 24 小时内不认领就删 |
| PostgreSQL,6 或 7 → 8 | prisma-postgres-upgrade | 一次升完,保留 schema、数据库和数据;6 不必先过 7 |
| 6 → 7 并停在 7 | prisma-upgrade-v7 | ESM、驱动适配器、prisma.config.ts、中间件改 Client Extensions |
| MongoDB 项目 | prisma-mongodb-upgrade | 7 没有 MongoDB 连接器;8 的 MongoDB 支持是抢先体验版 |
| 日常写查询、跑命令 | prisma-client-api、prisma-cli | 都是 Prisma 7 的参考,含 prisma mcp |
| 部署到 Prisma Compute | prisma-compute | Prisma 自家托管,只跑 Prisma 8 |
另外两个:prisma-driver-adapter-implementation 给写数据库驱动适配器的人用;prisma-database-setup 是旧名字,只负责转到 prisma-orm-setup。
先让 Agent 判断项目在哪个大版本,再动依赖,顺序反了就容易出事。
怎么用
1. 安装。README 给的命令,全装或按名字装:
npx skills add prisma/skills
npx skills add prisma/skills --skill prisma-postgres-upgrade
npx skills add prisma/skills --list # 看有哪些
npx skills 是 Vercel 的 Skills 命令行,用法见这篇介绍。
2. 在项目根目录交给 Agent。官方升级文档给的提示词只有一行:
Upgrade this app from Prisma ORM 6 to Prisma 8.
按 prisma-postgres-upgrade 的流程,Agent 先跑一遍项目自己的类型检查、构建和测试并记下结果,再换 CLI、写 Prisma 8 的 prisma.config.ts、执行 npx prisma skills sync 拉取和安装版本配套的 prisma-8 Skill,接着 contract emit、db sign、生成基线迁移、逐条改写查询,最后删掉 @prisma/client 和旧的生成代码,再跑一遍同样的检查。Skill 记录的验证情况是:一个 Prisma 6.19 + Express 4 + PostgreSQL 18 的应用,两个不带上下文的 Agent 只靠这些 Skill 完成升级,前后页面和 API 输出一致,prisma db verify 通过。
3. 只想留在 7。官方建议把 prisma 和 @prisma/client 都锁到 ^7,CI 和临时命令里写 npx prisma@7。已经被装成 8 的,npm install --save-dev prisma@7 会降回去。
几个容易踩的坑
- 版本要钉死。升级文档要求
prisma@8.0.0-rc.27和@prisma/orm-postgres@8.0.0-rc.20用--save-exact装;打算部署到 Prisma Compute 的应用不能用 latest 那一对,和控制台装的 Composer 版本不兼容。 - 运行环境门槛变高。Prisma 8 要 Node.js 22.18+、24.11+ 或 26+,TypeScript 5.9+ 且开
strict;Prisma 7 是 Node.js 20.19+、TypeScript 5.4+。 - 有些功能 8 里还没有。发布状态页列出
$extends、JSON 字段内过滤、原子increment、大部分嵌套写入和P2002这类错误码。代码重度依赖这些的,先别急着上 8。 - Agent 替不了的几件事。数据库时区不是 UTC 时怎么处理、给预发和生产库执行
npx prisma db sign、上线前的代码审查,Skill 明确要求停下来交给人。 - Skill 本身也会落后。
prisma-upgrade-v7里写的「最新稳定版 7.6.0」已经旧了,npm 上 7 系到了 7.10.1;具体版本号以 npm 和官方文档为准。
适合谁,不适合谁
适合手上有 Prisma 6/7 老项目、平时让 Agent 写数据库代码的人,尤其是 MongoDB 项目,这套 Skill 能拦住 Agent「升到 7」这种走不通的方案。只用 Prisma 7、短期不打算升级的,装 prisma-cli 和 prisma-client-api 两个就够。用 Drizzle、TypeORM 的项目和它无关;prisma-postgres-setup 也会尊重你指定的其他 ORM 或驱动,不会强行换成 Prisma。
最后
先在项目里跑一下 npm ls prisma @prisma/client 看清自己在哪个版本,再决定装 prisma-postgres-upgrade 升上去,还是把版本锁在 7。