用途:Prisma 8(原 Prisma Next)是契约优先的数据层。用户编写数据契约(contract.prisma 或 TypeScript builder),框架生成 contract.json 与 contract.d.ts,并在 SQL 目标上提供类型化 SQL 查询构建器(db.sql.<ns>.<table>)和类型化 ORM 客户端(db.orm.<ns>.<Model>);MongoDB 目标只有 ORM 通道。
主要能力:编辑数据契约(模型、字段、关系、索引、枚举、值对象、命名空间、跨契约外键、多态类型、扩展命名空间如 pgvector/postgis);从契约差异规划迁移,可编辑 migration.ts 做数据迁移后执行;编写查询(where、select、orderBy、聚合、事务、预编译语句、流式迭代等);运行时接线(db.ts、中间件、连接池、只读副本、多数据库);构建工具集成(Vite 插件等);Supabase 的 RLS 与角色绑定;结构化错误调试;应用与扩展的升级;反馈渠道。
使用方式:技能随已安装的 Prisma 包提供,描述项目实际版本。前置条件:项目使用 Prisma 8,prisma.config.ts 导出 definePrismaConfig({ orm: ... }),package.json 依赖 @prisma/orm-postgres、@prisma/orm-sqlite 或 @prisma/orm-mongo;若项目含 schema.prisma 与 @prisma/client 则为 Prisma 7 或更早,本技能不适用。需比对 frontmatter 中 metadata.library_version 与已安装版本,不一致时运行 prisma skills sync 后重读。契约产物 contract.json 与 contract.d.ts 需存在且不旧于源文件,否则先运行 prisma contract emit。用户代码中应写 @prisma/orm-* 导入名。任务按路由表打开对应参考文件(quickstart、contract、migrations、migration-model、migration-review、queries、runtime、build、supabase、debug、upgrade-app、upgrade-extension、feedback),不要仅凭本文件作答。
适用场景:新建或接入现有数据库、编辑契约、编写与审查迁移、查询、运行时与构建集成、Supabase、排错、升级。
限制:仅适用于 Prisma 8;迁移计划原点为 --from、db ref 或空数据库,无 ref 时从零规划,CLI 对已有迁移会拒绝(MIGRATION.PLAN_ORIGIN_UNKNOWN);部分构建工具集成存在明确缺口;具体收费、价格与平台信息暂未提供。