Переход на Prisma ORM 7
Переводит проект с Prisma ORM 6 на 7: генератор prisma-client, prisma.config.ts, драйвер-адаптеры, ESM, явная загрузка env и всё, что в v7 убрали. Для случаев, когда SQL-проект обновляют с Prisma 6 или чинят ошибки сразу после обновления.
prisma-upgrade-v7- Автор
- Prisma
- Источник
- prisma/skills/prisma-upgrade-v7 @ a6f1929
- Лицензия
- MIT · Copyright (c) 2025 Prisma
Об этом скилле
Что делает
Скилл переводит проект с Prisma ORM 6 на 7 за десять шагов. Сначала — обновить пакеты, выбрать ESM (по умолчанию) или CommonJS через moduleFormat = "cjs", поправить tsconfig.json, сменить генератор prisma-client-js на prisma-client с явным output и создать prisma.config.ts. Потом — поставить драйвер-адаптер, исправить импорты и создание клиента, заменить Prisma.validator на satisfies, сгенерировать клиент и проверить. Минимум — Node.js 20.19.0 и TypeScript 5.4.0.
Семь файлов в references/ разбирают каждое несовместимое изменение:
schema-changes.md— генератор, пути вывода,engineType, новые точки входаclient,browser,modelsиenums.driver-adapters.md— почему SQL-провайдерам теперь нужен адаптер; настройка для PostgreSQL, MySQL, SQLite, SQL Server, Neon и Prisma Postgres; настройки пула и SSL, которые по умолчанию отличаются от v6.esm-support.md,prisma-config.md,env-variables.md— формат модулей, файл конфигурации, загрузка.envчерезdotenv, удалённые переменные окружения Prisma.removed-features.md— middleware$use, которое заменили Client Extensions (с примерами мягкого удаления и логирования), метрики,--skip-generateи--skip-seed, migrate больше не запускает generate и сид.accelerate-users.md— URL Accelerate видаprisma://передаётся вaccelerateUrl, а не в драйвер-адаптер.
Когда включать и когда не надо
Для SQL-проекта на Prisma 6, который переходит на 7, и для ошибок сразу после перехода: «Cannot find module», когда путь вывода не совпал с импортом, ошибки SSL, таймауты подключения из-за новых настроек пула.
Не для MongoDB: в Prisma 7 нет коннектора MongoDB, и скилл советует таким проектам остаться на 6 или перейти на Prisma 8 через prisma-mongodb-upgrade — скилл Prisma, которого нет в нашем каталоге. Последним стабильным релизом скилл называет 7.6.0, а примеры скилла Настройка Prisma ORM проверены на 7.10.0, так что перед фиксацией версии уточните актуальную 7.x.
Как поставить и вызвать
Команда установки ниже скачивает всю папку. Агент сам подхватывает скилл, когда речь о переходе на Prisma 7 или об ошибке v7. Вызвать вручную:
- Claude Code:
/prisma-upgrade-v7или попросить скилл по имени. - Codex:
$prisma-upgrade-v7. - Cursor: наберите
/в чате Agent и выберитеprisma-upgrade-v7.
Пример: /prisma-upgrade-v7 Переведи это приложение на Express с Prisma 6 на 7. У нас PostgreSQL, CommonJS и middleware $use для мягкого удаления.
Чем отличается от похожих
Настройка Prisma ORM тоже работает с Prisma 7, но оставляет приложению его версию и сюда отправляет только переход с 6 на 7. Приложение на PostgreSQL может перейти с 6 сразу на 8 через prisma-postgres-upgrade — скилл Prisma, которого нет в нашем каталоге. Команды Prisma CLI — справочник для проекта, который уже на 7. Вне набора Prisma этот переход в нашем каталоге не разбирает ни один скилл: Вывод из эксплуатации и миграции — про то, как выводить из оборота собственные системы и API, а не про мажорную версию зависимости.
Установка
Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
curl -fsSL --create-dirs -o ~/.claude/skills/prisma-upgrade-v7/SKILL.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md -o ~/.claude/skills/prisma-upgrade-v7/LICENSE https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/LICENSE -o ~/.claude/skills/prisma-upgrade-v7/references/accelerate-users.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/accelerate-users.md -o ~/.claude/skills/prisma-upgrade-v7/references/driver-adapters.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/driver-adapters.md -o ~/.claude/skills/prisma-upgrade-v7/references/env-variables.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/env-variables.md -o ~/.claude/skills/prisma-upgrade-v7/references/esm-support.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/esm-support.md -o ~/.claude/skills/prisma-upgrade-v7/references/prisma-config.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/prisma-config.md -o ~/.claude/skills/prisma-upgrade-v7/references/removed-features.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/removed-features.md -o ~/.claude/skills/prisma-upgrade-v7/references/schema-changes.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/schema-changes.md
curl -fsSL --create-dirs -o ~/.agents/skills/prisma-upgrade-v7/SKILL.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md -o ~/.agents/skills/prisma-upgrade-v7/LICENSE https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/LICENSE -o ~/.agents/skills/prisma-upgrade-v7/references/accelerate-users.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/accelerate-users.md -o ~/.agents/skills/prisma-upgrade-v7/references/driver-adapters.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/driver-adapters.md -o ~/.agents/skills/prisma-upgrade-v7/references/env-variables.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/env-variables.md -o ~/.agents/skills/prisma-upgrade-v7/references/esm-support.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/esm-support.md -o ~/.agents/skills/prisma-upgrade-v7/references/prisma-config.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/prisma-config.md -o ~/.agents/skills/prisma-upgrade-v7/references/removed-features.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/removed-features.md -o ~/.agents/skills/prisma-upgrade-v7/references/schema-changes.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/schema-changes.md
foreach ($f in 'SKILL.md','LICENSE','references/accelerate-users.md','references/driver-adapters.md','references/env-variables.md','references/esm-support.md','references/prisma-config.md','references/removed-features.md','references/schema-changes.md') { $p = Join-Path "$HOME\.claude\skills\prisma-upgrade-v7" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/$f" -UseBasicParsing -OutFile $p }foreach ($f in 'SKILL.md','LICENSE','references/accelerate-users.md','references/driver-adapters.md','references/env-variables.md','references/esm-support.md','references/prisma-config.md','references/removed-features.md','references/schema-changes.md') { $p = Join-Path "$HOME\.agents\skills\prisma-upgrade-v7" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/$f" -UseBasicParsing -OutFile $p }Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md
SKILL.md
Upgrade to Prisma ORM 7
Complete guide for migrating from Prisma ORM v6 to v7. This upgrade introduces significant breaking changes around the new prisma-client generator, driver adapters, prisma.config.ts, explicit environment loading, and generated client entrypoints.
When to Apply
Reference this skill when:
- Upgrading from Prisma v6 to v7
- Updating to the
prisma-clientgenerator - Setting up driver adapters
- Configuring
prisma.config.ts - Fixing import errors after upgrade
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Schema Migration | CRITICAL | schema-changes |
| 2 | Database Connectivity | CRITICAL | driver-adapters |
| 3 | Module System | CRITICAL | esm-support |
| 4 | Config and Env | HIGH | prisma-config, env-variables |
| 5 | Removed Features | HIGH | removed-features |
| 6 | Accelerate | HIGH | accelerate-users |
Quick Reference
schema-changes- generator migration, required output paths, generated entrypoints, andPrisma.validatorreplacementdriver-adapters- required adapter installation for SQL providers, pool differences, and Prisma Postgres adapter choicesesm-support- ESM-first setup plus CommonJS fallback withmoduleFormat = "cjs"prisma-config- creating and usingprisma.config.tsenv-variables- explicit environment loadingremoved-features- removed middleware, metrics, and legacy CLI behavioraccelerate-users- migration notes for Accelerate users
Using MongoDB? This guide does not apply
Prisma 7 has no MongoDB connector. Do not apply any step in this guide to a project with
provider = "mongodb" — see the prisma-mongodb-upgrade skill for the actual decision
(stay on v6 deliberately vs migrate to Prisma 8).
Important Notes
- MongoDB projects should stay on Prisma 6.x or migrate to Prisma 8 - do not migrate MongoDB apps to Prisma 7's SQL client path (see
prisma-mongodb-upgrade) - Node.js 20.19.0+ required
- TypeScript 5.4.0+ required
- Latest stable Prisma ORM version:
7.6.0
Upgrade Steps Overview
- Update packages to v7
- Choose your module format (
esmby default,cjsif needed) - Update TypeScript configuration
- Update the schema generator block
- Create
prisma.config.ts - Install and configure a driver adapter for SQL providers
- Update Prisma Client imports
- Update client instantiation
- Replace deprecated helper patterns like
Prisma.validator - Run
prisma generateand test
Quick Upgrade Commands
# Update packages
npm install @prisma/client@7
npm install -D prisma@7
# Install a driver adapter (PostgreSQL or Prisma Postgres via direct TCP)
npm install @prisma/adapter-pg pg
# Install dotenv for env loading
npm install dotenv
# Regenerate client
npx prisma generate
Breaking Changes Summary
| Change | v6 | v7 |
|---|---|---|
| Module format | Implicit / mixed | ESM-first, moduleFormat = "cjs" supported |
| Generator provider | prisma-client-js |
prisma-client is the default, while prisma-client-js still exists for legacy setups |
| Output path | Auto (node_modules) | Required explicit |
| Driver adapters | Optional | Required for SQL providers |
| Config file | .env + schema |
prisma.config.ts |
| Env loading | Automatic | Manual (dotenv) |
| Generated entrypoints | Single package export | client, browser, models, enums entrypoints |
| Type-safe query fragments | Prisma.validator() |
TypeScript satisfies |
| Middleware | $use() |
Client Extensions |
| Metrics | Preview feature | Removed |
Rule Files
Detailed migration guides for each breaking change:
references/esm-support.md - ESM and CommonJS configuration
references/schema-changes.md - Generator, output, imports, and generated entrypoints
references/driver-adapters.md - Required driver adapter setup
references/prisma-config.md - New configuration file
references/env-variables.md - Environment variable loading
references/removed-features.md - Middleware, metrics, and CLI flags
references/accelerate-users.md - Special handling for Accelerate
Step-by-Step Migration
1. Update package.json for ESM-first projects
{
"type": "module"
}
If you need to stay on CommonJS, keep your app as CJS and set moduleFormat = "cjs" in the generator block instead of forcing ESM.
2. Update tsconfig.json
{
"compilerOptions": {
"module": "ESNext",
"moduleResolution": "bundler",
"target": "ES2023",
"strict": true,
"esModuleInterop": true
}
}
3. Update schema.prisma
// Before (v6)
generator client {
provider = "prisma-client-js"
}
// After (v7)
generator client {
provider = "prisma-client"
output = "../generated/prisma"
// Optional if you need CommonJS:
// moduleFormat = "cjs"
}
4. Create prisma.config.ts
import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'
export default defineConfig({
schema: 'prisma/schema.prisma',
migrations: {
path: 'prisma/migrations',
},
datasource: {
url: env('DATABASE_URL'),
},
})
5. Install a driver adapter (SQL providers only)
# PostgreSQL
npm install @prisma/adapter-pg pg
# MySQL
npm install @prisma/adapter-mariadb mariadb
# SQLite
npm install @prisma/adapter-better-sqlite3 better-sqlite3
# Prisma Postgres in standard Node.js apps (recommended)
npm install @prisma/adapter-pg pg
# Prisma Postgres serverless driver (edge/serverless)
npm install @prisma/adapter-ppg @prisma/ppg
# Neon
npm install @prisma/adapter-neon
MongoDB does not have a SQL @prisma/adapter-* package in the published Prisma 7.6.0 packages. If you're upgrading a MongoDB project, stop and keep that project on the latest Prisma 6.x release instead of following the standard Prisma 7 migration path.
6. Update client instantiation
// Before (v6)
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
// After (v7)
import { PrismaClient } from '../generated/prisma/client'
import { PrismaPg } from '@prisma/adapter-pg'
const adapter = new PrismaPg({
connectionString: process.env.DATABASE_URL
})
const prisma = new PrismaClient({ adapter })
7. Replace Prisma.validator with satisfies
import { Prisma } from '../generated/prisma/client'
const userSelect = {
id: true,
email: true,
name: true,
} satisfies Prisma.UserSelect
8. Run migrations and generate
npx prisma generate
npx prisma migrate dev # if needed
Troubleshooting
"Cannot find module" errors
- Check that the generator
outputpath matches your import path - Ensure
prisma generateran successfully
SSL certificate errors
- Add
ssl: { rejectUnauthorized: false }to the adapter config if you need to preserve old behavior - Or configure your certificates properly with
NODE_EXTRA_CA_CERTS/ OpenSSL CA settings
Connection timeout issues
- Driver adapters use the underlying driver's defaults, which differ from v6
- Configure pool settings explicitly on the adapter if needed
Resources
How to Use
Follow references/schema-changes.md and references/driver-adapters.md first, then apply the remaining reference files based on your project setup.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel