Prisma Skills：Prisma 官方为 AI Agent 打包的 ORM 全套技能集

Skill超级捕获手 技术创作者 2026-08-09 10 阅读

Prisma 官方 skills 套件最近在 skills.sh 24h 趋势榜冲到第 35 位，总下载量已突破 47.7K，单子技能 prisma-client-api 一天就有 5.4K 下载。这套来自 Prisma 团队官方维护的 AI Agent 技能集合覆盖了 Prisma ORM 在 AI 编程场景下几乎所有常见需求：CLI 命令、客户端 API、数据库连接、v6 → v7 升级、Driver Adapter 实现，甚至连自家的 Prisma Compute 部署流都打包好了。对任何一个用 Claude Code / Codex / Cursor 写 Prisma 项目的开发者来说，这就是把 Prisma 官方文档”内化”成 AI 助手肌肉记忆的捷径。

功能与原则

prisma/skills 是 Prisma 团队（@AmanVarshney01 等 5 位贡献者）按 Agent Skills 规范发布的官方技能集，遵循 SKILL.md + references/ 的标准结构。每个 Skill 都把对应主题的官方知识（CLI 命令、API 用法、迁移路径、部署流程）压缩成一段”结构化指令包”，让 AI 编码 Agent 写到 Prisma 相关代码时能自动调用、按命令输出正确结果，而不是凭印象瞎猜。核心设计原则：让 Agent 像熟读 Prisma 文档的工程师一样回答问题。

认可度

GitHub 51 stars / 4 forks（截至 2026-08-09），表面看 star 不算高，但这是一个刚发布的官方仓库（init 在 2026-01-23，最近一次 feat commit 在 2026-08-04，仅 5 天前）。真正反映热度的是分发端：在 skills.sh 上：

  • 总下载 47.7K，含 9 个子技能
  • 24h trending 第 35 位，prisma-client-api 单日 5.4K 下载
  • 已收录 5 位 Prisma 团队成员 commit

对官方仓库来说，”下载量爆表 + Trending 排名”才是真正的认可度信号。Skills.sh 上 mattpocock/skills 之外的官方大厂源里，prisma/skills 与 microsoft/azure-skills、google/skills 一起构成”三大官方 AI Skills 包”。

链接

  • 仓库：https://github.com/prisma/skills
  • skills.sh 入口：https://skills.sh/prisma/skills

原作者

Prisma 团队官方维护，主要贡献者 AmanVarshney01（GitHub: @AmanVarshney01），其他四位是 kristof-siket、luiz1361、aidankmcalister、tensordreams，都是 Prisma 工程师。其中 AmanVarshney01 在 8 月 4 日合并了 PR #23「refresh Prisma skills for current releases」统一刷新整套 Skill 到当前 Prisma 7.6.x 版本，是这次上 trending 的直接原因。

介绍

整套 Skills 围绕 Prisma ORM 7.6.x 设计，按场景切成 9 个独立子技能，每个都标了「Use when」+「Topics covered」让你一眼看清边界：

  • prisma-cli — 现行 Prisma ORM CLI 完整命令速查（init / generate / dev / migrate dev|deploy|reset / db push|pull|seed|execute / studio / mcp 等），写项目脚手架必备
  • prisma-client-api — 客户端 API 全集：CRUD、select/include/omit/orderBy、分页、过滤、$transaction、$queryRaw/$executeRaw、$connect/$extends，是 Prisma Client 查询的事实参考手册
  • prisma-upgrade-v7 — v6 → v7 升级权威指南，覆盖 ESM-first、Driver Adapter 必填、新 prisma.config.ts、手动 env、生成入口拆分（client/browser/models/enums）、Prisma.validator → satisfies、middleware / metrics 移除、Accelerate 特殊路径
  • prisma-mongodb-upgrade — MongoDB 用户专用的决策树：MongoDB v6 是终态、Prisma 7 没 connector、迁移路径是 Prisma Next，含 stay-on-v6 vs migrate-now 决策表
  • prisma-database-setup — PostgreSQL / Prisma Postgres / MySQL / MariaDB / SQLite / MongoDB / SQL Server / CockroachDB 的连接配置
  • prisma-postgres — Prisma Postgres 工作流：Console / npx create-db / Management API（api.prisma.io/v1）/ @prisma/management-api-sdk
  • prisma-postgres-setup — 生产部署倾向 migrate dev 而非 db push 的迁移规范
  • prisma-driver-adapter-implementation — 给写 SQL Driver Adapter 的人：SqlDriverAdapter / Transaction 接口契约、嵌套事务协议、SqlQuery / SqlResultSet 映射、ColumnTypeEnum 策略、错误转换、单元 + E2E 验证清单
  • prisma-compute — Prisma Compute 部署：@prisma/cli app build/run/deploy、生成 compute:deploy 脚本、create-prisma --deploy、Hono / Elysia / Next.js / TanStack Start / Astro / Nuxt / Svelte / Nest / Turborepo 框架适配、auth / env / build / port 问题排查

特点

  • Prisma 官方出品：跟 mattpocock/skills（社区工程师）这种第三方精选不一样，prisma/skills 直接由 Prisma 团队维护，文档口径零误差
  • 覆盖完整生态：CLI + Client API + 多数据库 + v7 升级 + Driver Adapter 实现 + 部署一条龙，不会出现”这块没覆盖”
  • 原子化拆分：9 个独立 Skill，需要哪个装哪个，不会一次性塞进几百 KB context
  • 兼容所有 Skills 协议 Agent：npx skills add prisma/skills 即可给 Claude Code / Codex / Cursor / Copilot / Windsurf 等所有支持 Skills 协议的 Agent 装上
  • 紧跟当前 release：5 天前的 PR #23 刚把整套刷到 Prisma 7.6.x，比官方文档更新更快（文档常常滞后）

使用方法

# 一键装全
npx skills add prisma/skills

# 按需装单个
npx skills add prisma/skills --skill prisma-client-api
npx skills add prisma/skills --skill prisma-upgrade-v7

# 查看可装清单
npx skills add prisma/skills --list

# 列出当前已装
npx skills list

装完启动 Claude Code / Codex 会话后，直接用自然语言触发：

Help me run Prisma migrations in production
Upgrade my project from Prisma 6 to Prisma 7
How do I use transactions in Prisma?

Agent 会自动调用对应 Skill 并按规范回答。

使用场景与人群

  • Prisma 项目开发者：写 schema、迁移、查询时被 Agent 乱猜 API 折磨过的，必装
  • 正在做 v6 → v7 升级的团队：prisma-upgrade-v7 把所有 breaking change 串成清单，省 2 天啃 changelog
  • MongoDB + Prisma 用户：prisma-mongodb-upgrade 阻止”向 v7 升级”这种不可行路径，避免踩坑
  • Driver Adapter 开发者：写 Prisma 兼容 driver 的人，prisma-driver-adapter-implementation 给完整接口契约和验证清单
  • Prisma Compute 用户：要部署到 Prisma Platform 的项目，prisma-compute 覆盖 create-prisma、Hono / Next.js / TanStack 等框架适配

输入与输出案例

案例 1：v6 → v7 升级咨询

输入："升级我的项目从 Prisma 6 到 Prisma 7，需要注意哪些？"

输出（节选）：
– ESM-first 模块配置：v7 默认走 ESM，需要在 package.json 加 "type": "module"，CommonJS 项目要保留 fallback
– Driver Adapter 必填：v7 不再支持内置 query engine，必须接入 SQL Driver Adapter（Neon / PlanetScale / D1 / 自研）
– 新 prisma.config.ts：代替 v6 的 schema.prisma 内的 generator / datasource 块
– Prisma.validator → satisfies：旧类型校验 API 全部改成 TS 标准 satisfies
– 生成入口拆分：@prisma/client 拆成 client / browser / models / enums 四个入口

案例 2：客户端事务用法

输入："Prisma 里我要在一个事务里同时改两个表，怎么办？"

输出（节选）：

ts
await prisma.$transaction(async (tx) => {
const order = = await tx.order.create({
data: { userId, total, items: { create: items } },
});
await tx.user.update({
where: { id: userId },
data: { lastOrderAt: new Date() },
});
return order;
});

交互式事务会自动在回调里抛错时回滚；批量事务（$transaction([...])）则按数组顺序原子执行。需要隔离级别时加 { isolationLevel: Prisma.TransactionIsolationLevel.Serializable }。

核心数据：
– GitHub 51 stars / 4 forks（截至 2026-08-09）
– skills.sh 总下载 47.7K
– 24h trending 第 35，单技能 5.4K 下载
– 9 个子 Skill，Prisma 官方团队维护
– 最近 commit：5 天前

GitHub: https://github.com/prisma/skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读