项目2026-11-19 · 智涌AI

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

Prisma Skills 项目头图:左侧大字「Prisma Skills 交给 Agent 升级」与钩子「Prisma 6 今天停补丁,先认版本再动依赖」,三张数据卡为 11 个官方 Skill、4.0M 累计安装、MIT 开源许可;右侧面板按数据库列出升级路线:PostgreSQL 6 或 7 到 8、停在 7、MongoDB 6 到 8 抢先体验,并标出对应 Skill 名

今天(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 78 正式版发布后再维护 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 → 8prisma-postgres-upgrade一次升完,保留 schema、数据库和数据;6 不必先过 7
6 → 7 并停在 7prisma-upgrade-v7ESM、驱动适配器、prisma.config.ts、中间件改 Client Extensions
MongoDB 项目prisma-mongodb-upgrade7 没有 MongoDB 连接器;8 的 MongoDB 支持是抢先体验版
日常写查询、跑命令prisma-client-api、prisma-cli都是 Prisma 7 的参考,含 prisma mcp
部署到 Prisma Computeprisma-computePrisma 自家托管,只跑 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 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。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。