К основному содержанию
скилл CX Codex

zenstack-migrate-from-prisma — скилл для Claude Code: миграция

Скилл zenstack-migrate-from-prisma для Claude Code переносит проект с Prisma на ZenStack V3. Он помогает заменить схему, клиент и команды миграции, сохранив рабочие вызовы ORM.

MIT 520 установок ★ 3 обновлён 2026-10-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add zenstackhq/skills --skill zenstack-migrate-from-prisma -a claude-code
Открыть на GitHub

Что делает zenstack-migrate-from-prisma

Скилл переводит существующий проект с Prisma на ZenStack V3: переносит schema.prisma в zenstack/schema.zmodel, заменяет PrismaClient на ZenStackClient и обновляет скрипты генерации и миграции. Он также описывает перенос пользовательских генераторов и расширений Prisma Client. Вызовы findMany, create и update остаются совместимыми с API ORM.

Для подключения к базе данных нужен драйвер: pg, mysql2 или better-sqlite3. Команды миграции ZenStack используют Prisma Migrate; историю из prisma/migrations переносят в zenstack/migrations. Многофайловую схему объединяют через import в ZModel.

Какие задачи решает

  • перенести schema.prisma в ZModel
  • заменить PrismaClient на ZenStackClient
  • обновить команды генерации и миграции
  • сохранить Prisma Migrate и историю миграций
  • перенести пользовательские генераторы и расширения клиента

Примеры запросов агенту

  • Перенеси мой проект с Prisma на ZenStack V3.
  • Замени PrismaClient на ZenStackClient и обнови скрипты.
  • Настрой миграцию схемы и истории из prisma/migrations в ZenStack.

Как установить zenstack-migrate-from-prisma

1Через Skills CLI (Vercel)

npx skills add zenstackhq/skills --skill zenstack-migrate-from-prisma -a claude-code

2Вручную: положить файлы

~/.claude/skills/zenstack-migrate-from-prisma/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/zenstack-migrate-from-prisma/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о zenstack-migrate-from-prisma

Как установить zenstack-migrate-from-prisma в Claude Code?

Выполни npx skills add zenstackhq/skills --skill zenstack-migrate-from-prisma -a claude-code. Файл скилла появится по пути ~/.claude/skills/zenstack-migrate-from-prisma/SKILL.md.

Что делает zenstack-migrate-from-prisma?

Скилл помогает перейти с Prisma на ZenStack V3: переносит схему, заменяет клиент и обновляет генерацию и миграции. Он также описывает соответствия для пользовательских генераторов и расширений Prisma Client.

Что нужно для работы zenstack-migrate-from-prisma?

Для базы данных нужен соответствующий драйвер: pg для PostgreSQL, mysql2 для MySQL или better-sqlite3 для SQLite. Команды миграции ZenStack используют Prisma Migrate.

Исходный текст

SKILL.md · MIT
---
name: zenstack-migrate-from-prisma
description: Migrate an existing Prisma project to ZenStack V3. Use when replacing Prisma/@prisma/client with ZenStack, converting schema.prisma to ZModel, swapping PrismaClient for ZenStackClient, updating generate/migrate scripts, mapping Prisma custom generators and client extensions, or keeping Prisma migrate tooling working.
---

# Migrating from Prisma to ZenStack V3

ZenStack V3 is designed as a drop-in upgrade path for Prisma: it keeps a Prisma-compatible query API
and a schema language (ZModel) that is a superset of the Prisma schema. Most apps migrate with
mechanical changes and no query rewrites. Supported databases: **PostgreSQL, MySQL, SQLite**.

For general setup/CLI details see `zenstack-project-setup`; for the client/dialect see
`zenstack-querying`; for schema syntax see `zenstack-schema-modeling`.

## At a glance

| Prisma | ZenStack V3 |
| ------ | ----------- |
| `prisma`, `@prisma/client` | `@zenstackhq/cli` (dev), `@zenstackhq/schema`, `@zenstackhq/orm` |
| `schema.prisma` | `zenstack/schema.zmodel` (Prisma schema is valid ZModel) |
| `prisma generate` | `zen generate` |
| `prisma db push` / `migrate dev` / `migrate deploy` | `zen db push` / `zen migrate dev` / `zen migrate deploy` |
| `new PrismaClient()` | `new ZenStackClient(schema, { dialect })` |
| bundled DB engine | you install a DB driver (`pg` / `mysql2` / `better-sqlite3`) |

## Step 1 — Swap dependencies

```bash
npm uninstall prisma @prisma/client
npm install @zenstackhq/schema @zenstackhq/orm
npm install --save-dev @zenstackhq/cli
```

ZenStack does **not** bundle a database engine — install the driver for your database:

| Database   | Install |
| ---------- | ------- |
| PostgreSQL | `npm install pg` + `npm install -D @types/pg` |
| MySQL      | `npm install mysql2` |
| SQLite     | `npm install better-sqlite3` + `npm install -D @types/better-sqlite3` |

> `@zenstackhq/cli` has a peer dependency on `prisma`, which is installed automatically when needed
> for migration commands (ZenStack's migrate commands wrap Prisma Migrate).

## Step 2 — Move and rename the schema

Move `schema.prisma` → `zenstack/schema.zmodel`. **No edits are required** — every valid Prisma
schema is valid ZModel. Optional cleanup:

- Drop the `generator client { ... }` block (no effect in ZenStack — code gen is driven by
  `zen generate`).
- The `datasource` block is kept; its `url` is used by the migration engine (the ORM runtime gets
  its connection from the driver/dialect instead).
- If you used Prisma's multi-file/multi-schema feature, merge files using ZModel `import`
  statements.

Run **`zen check`** to confirm the converted schema is valid (syntax + semantics) before moving on.

Once moved, you can start adding ZenStack-only features that Prisma lacks — access policies
(`zenstack-access-control`), `@@delegate` polymorphism, typed JSON, mixins, computed fields
(`zenstack-schema-modeling`).

## Step 3 — Update the generate script

```json
{ "scripts": { "generate": "zen generate" } }
```

Run `zen generate` after every schema change, before using the client.

## Step 4 — Replace the client

Swap `new PrismaClient()` for `new ZenStackClient(schema, { dialect })`, supplying a Kysely dialect
for your driver (see `zenstack-querying` for all dialects). PostgreSQL example:

```ts
import { ZenStackClient } from '@zenstackhq/orm';
import { PostgresDialect } from '@zenstackhq/orm/dialects/postgres';
import { schema } from './zenstack/schema';
import { Pool } from 'pg';

export const db = new ZenStackClient(schema, {
    dialect: new PostgresDialect({
        pool: new Pool({ connectionString: process.env.DATABASE_URL }),
    }),
});
```

Your existing `findMany`/`create`/`update`/etc. calls keep working — the ORM API is
Prisma-compatible.

## Step 5 — Update type references

- Model types (e.g. `User`) — import from the generated `models`.
- Input/argument types (e.g. `UserCreateArgs`) — import from the generated `input`.

Most code relies on inferred types and needs no explicit imports.

## Step 6 — Update migration scripts

```json
{
  "scripts": {
    "db:push": "zen db push",
    "migrate:dev": "zen migrate dev",
    "migrate:deploy": "zen migrate deploy"
  }
}
```

Move your existing migration history from `prisma/migrations` to `zenstack/migrations` (ZenStack's
default location, next to `zenstack/schema.zmodel`). It continues to work unchanged since ZenStack
migrate wraps Prisma Migrate. See the `zenstack-db-migration` skill for the full migration workflow.

## Special case — Prisma custom generators

If you depend on Prisma custom generators (e.g. zod, ERD, type generators) that read a
`schema.prisma`, keep emitting one with the `@core/prisma` plugin and chain the commands:

```zmodel
plugin prisma {
    provider = '@core/prisma'
    output = './schema.prisma'
}
```

```json
{ "scripts": { "generate": "zen generate && prisma generate --schema=zenstack/schema.prisma" } }
```

## Mapping Prisma Client extensions

| Prisma extension | ZenStack equivalent |
| ---------------- | ------------------- |
| **Query** extension (intercept calls) | A runtime plugin via `db.$use(...)` with an `onQuery` hook |
| **Result** extension (computed fields) | `@computed` field in ZModel + the `computedFields` option on `ZenStackClient` (see `zenstack-schema-modeling`) |

## After migrating

Verify with: `zen generate` → typecheck → run your test suite / app. Then incrementally adopt
ZenStack's value-add features (access control, query builder escape hatch, auto CRUD APIs via
`zenstack-crud-server`).

> Already on **ZenStack V2**? Start here (V2 was Prisma-based), then apply the V2→V3 deltas in
> `zenstack-project-setup` (package renames, policy plugin, `post-update`/`before()`, types+mixins,
> grouped hooks).

## Reference docs

Full ZenStack documentation for this topic is bundled under [`references/`](references/):

- [migrate-prisma.md](references/migrate-prisma.md) — official "Migrating from Prisma" guide

© zenstackhq · MIT · zenstackhq/skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
prisma-cli prisma Скилл prisma-cli для Claude Code даёт справочник по Prisma ORM 7: миграции, генерация клиента и безопасная работа с базой без случайного сброса данных. CX Codex +1 438 300установок prisma-development Mindrally Скилл prisma-development для Claude Code и других агентов: задаёт правила работы с Prisma ORM и TypeScript — схема, миграции, транзакции, обработка ошибок. Покрывает проекты с Prisma. CX Codex +1 741установок prisma sanjeed5 Задаёт агенту порядок работы с Prisma ORM: один клиент на приложение, выборки без лишних полей, аккуратные миграции. CX Codex +1 ★ 3 589звёзд репо prisma-upgrade-v7 prisma Скилл prisma-upgrade-v7 для Claude Code описывает переход с Prisma ORM v6 на v7: генератор, драйверы, ESM-конфиг и импорты. Включают при обновлении Prisma или разборе ошибок v7. CX Codex +1 425 400установок prisma-patterns affaan-m Скилл prisma-patterns для Claude Code собирает правила и архитектурные шаблоны для Prisma ORM в TypeScript. Помогает писать безопасные схемы, запросы и транзакции без утечек соединений. CX Codex +1 6 300установок Prisma ORM taste f Промпт Prisma ORM taste для ChatGPT и Claude Code задаёт строгие инженерные правила работы с Prisma ORM. Фиксирует архитектуру схемы, миграций и запросов к базе данных. GP ChatGPT ★ 178 201звёзд репо

Из того же набора9

zenstack-access-control Скилл zenstack-access-control для Claude Code помогает задавать правила доступа в схеме ZenStack V3. Подключается при работе с @@allow, @@deny, auth() и проверками после обновления. CX Codex +1 556установок zenstack-db-migration Скилл zenstack-db-migration для Claude Code управляет миграциями схемы базы данных в ZenStack V3. Вызывается при создании и применении миграций, синхронизации схемы или работе с существующей базой. CX Codex +1 551установок zenstack-crud-server Скилл zenstack-crud-server для Claude Code превращает модели ZenStack V3 в REST- или RPC CRUD API. Подключается при создании серверных маршрутов, настройке доступа к данным или вызове API из клиента. CX Codex +1 548установок zenstack-plugin-dev Скилл zenstack-plugin-dev для Claude Code помогает создавать плагины ZenStack V3. Включается при работе с ZModel, генерацией кода через CLI или расширением ORM-клиента. CX Codex +1 521установок zenstack-migrate-from-v2 Скилл zenstack-migrate-from-v2 для Claude Code переводит проект ZenStack с V2 на V3. Помогает обновить схему, политики доступа, серверные адаптеры и клиентские хуки. CX Codex +1 515установок zenstack-project-setup Скилл zenstack-project-setup для Claude Code настраивает проекты ZenStack V3: устанавливает зависимости, создаёт каркас и запускает команды zen. Активируется при установке ZenStack, создании проекта или работе с CLI. CX Codex +1 510установок zenstack-querying Скилл zenstack-querying для Claude Code помогает работать с данными через клиент ZenStack V3. Он включается при создании запросов, изменении записей и настройке выборок со связями. CX Codex +1 494установок zenstack-schema-modeling Скилл zenstack-schema-modeling для Claude Code помогает создавать и менять схемы данных ZModel для ZenStack V3. Запускается при работе с моделями, полями, связями, перечислениями и типизированными JSON-полями. CX Codex +1 470установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой