Справочник по Prisma Client API

Даёт агенту справочник по Prisma Client: CRUD и массовые операции, select и include, фильтры, вложенная запись связей, транзакции, безопасный сырой SQL и расширения клиента, примеры на Prisma 7. Для случаев, когда пишут или проверяют запросы через Prisma.

Базы данных и SQLПак: Скиллы Prisma216 строкprisma-client-api
Автор
Источник
prisma/skills/prisma-client-api @ a6f1929
Лицензия
MIT · Copyright (c) 2025 Prisma

Об этом скилле

Что делает

Скилл — справочник, который агент читает, пока пишет код на Prisma Client. В SKILL.md сводные таблицы: методы моделей от findUnique до groupBy, параметры запроса (select, include, omit, cursor, distinct), операторы фильтров и связей, методы клиента. Подробности — в восьми файлах references/:

  • constructor.md — PrismaClient с драйвер-адаптером или accelerateUrl, логирование, плагины SQL commenter для трассировки и тегов запросов, настройки транзакций по умолчанию, queryPlanCacheMaxSize и синглтон для Node и Next.js, чтобы горячая перезагрузка не плодила пулы соединений.
  • model-queries.md — CRUD, массовая запись, createManyAndReturn, атомарные обновления вроде increment, агрегаты.
  • query-options.md, filters.md, relations.md — форма результата, фильтры по JSON, массивам и полнотекстовые, вложенная запись через connectOrCreate, set и disconnect.
  • transactions.md — транзакции массивом и интерактивные, уровни изоляции, таймауты.
  • raw-queries.md — $queryRaw с шаблонными строками, Prisma.sql и Prisma.join, чем варианты Unsafe грозят SQL-инъекцией, BigInt и даты.
  • client-methods.md — $connect, $disconnect, $on, $extends и satisfies для типизированных фрагментов запроса.

Примеры написаны под Prisma 7: генератор prisma-client, импорт из ../generated/client, адаптер вроде @prisma/adapter-pg. В поле версии скилла — 7.9.1. Сам он ничего не запускает, CLI и ключи не нужны.

Когда включать и когда не надо

Когда пишете или проверяете запросы через Prisma Client: фильтры, связи, пагинацию, транзакции, сырой SQL, расширения.

Prisma и подключение к базе скилл не настраивает, схему и миграции не трогает. Для приложения на Prisma 8 скилл Настройка Prisma ORM отсылает к скиллу prisma-8 из пакета ORM — запросы Prisma 8 описаны там.

Как поставить и вызвать

Команда установки ниже скачивает всю папку. Агент сам подхватывает скилл, когда пишет запросы на Prisma. Вызвать вручную:

  • Claude Code: /prisma-client-api или попросить скилл по имени.
  • Codex: $prisma-client-api.
  • Cursor: наберите / в чате Agent и выберите prisma-client-api.

Пример: /prisma-client-api Напиши перевод между двумя счетами интерактивной транзакцией, которая откатывается, если баланс уходит в минус.

Чем отличается от похожих

Ревью SQL-запросов ищет в готовом запросе неверные результаты, N+1, недостающие индексы и инъекции и смотрит реальный план EXPLAIN; этот скилл подсказывает, как написать запрос через API Prisma. Если запрос на Prisma вышел медленным, прогоните по нему ревью. Команды Prisma CLI отвечают за генерацию клиента и миграции, а Лучшие практики Postgres от Supabase — за сторону базы: индексы, блокировки, пул соединений.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/prisma-client-api/SKILL.md https://anymodel.org/en/skills/prisma/prisma-client-api/SKILL.md -o ~/.claude/skills/prisma-client-api/LICENSE https://anymodel.org/en/skills/prisma/prisma-client-api/LICENSE -o ~/.claude/skills/prisma-client-api/references/client-methods.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/client-methods.md -o ~/.claude/skills/prisma-client-api/references/constructor.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/constructor.md -o ~/.claude/skills/prisma-client-api/references/filters.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/filters.md -o ~/.claude/skills/prisma-client-api/references/model-queries.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/model-queries.md -o ~/.claude/skills/prisma-client-api/references/query-options.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/query-options.md -o ~/.claude/skills/prisma-client-api/references/raw-queries.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/raw-queries.md -o ~/.claude/skills/prisma-client-api/references/relations.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/relations.md -o ~/.claude/skills/prisma-client-api/references/transactions.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/transactions.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/prisma-client-api/SKILL.md https://anymodel.org/en/skills/prisma/prisma-client-api/SKILL.md -o ~/.agents/skills/prisma-client-api/LICENSE https://anymodel.org/en/skills/prisma/prisma-client-api/LICENSE -o ~/.agents/skills/prisma-client-api/references/client-methods.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/client-methods.md -o ~/.agents/skills/prisma-client-api/references/constructor.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/constructor.md -o ~/.agents/skills/prisma-client-api/references/filters.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/filters.md -o ~/.agents/skills/prisma-client-api/references/model-queries.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/model-queries.md -o ~/.agents/skills/prisma-client-api/references/query-options.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/query-options.md -o ~/.agents/skills/prisma-client-api/references/raw-queries.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/raw-queries.md -o ~/.agents/skills/prisma-client-api/references/relations.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/relations.md -o ~/.agents/skills/prisma-client-api/references/transactions.md https://anymodel.org/en/skills/prisma/prisma-client-api/references/transactions.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/client-methods.md','references/constructor.md','references/filters.md','references/model-queries.md','references/query-options.md','references/raw-queries.md','references/relations.md','references/transactions.md') { $p = Join-Path "$HOME\.claude\skills\prisma-client-api" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-client-api/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/client-methods.md','references/constructor.md','references/filters.md','references/model-queries.md','references/query-options.md','references/raw-queries.md','references/relations.md','references/transactions.md') { $p = Join-Path "$HOME\.agents\skills\prisma-client-api" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-client-api/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/prisma/prisma-client-api/SKILL.md

SKILL.md

Исходник

Prisma Client API Reference

Complete API reference for Prisma Client. This skill provides guidance on model queries, filtering, relations, and client methods for current Prisma projects.

When to Apply

Reference this skill when:

  • Writing database queries with Prisma Client
  • Performing CRUD operations (create, read, update, delete)
  • Filtering and sorting data
  • Working with relations
  • Using transactions
  • Configuring client options

Rule Categories by Priority

Priority Category Impact Prefix
1 Client Construction HIGH constructor
2 Model Queries CRITICAL model-queries
3 Query Shape HIGH query-options
4 Filtering HIGH filters
5 Relations HIGH relations
6 Transactions CRITICAL transactions
7 Raw SQL CRITICAL raw-queries
8 Client Methods MEDIUM client-methods

Quick Reference

  • constructor - PrismaClient setup, adapter wiring, logging, and SQL commenter plugins
  • model-queries - CRUD operations and bulk operations
  • query-options - select, include, omit, sort, pagination
  • filters - scalar and logical filter operators
  • relations - relation reads and nested writes
  • transactions - array and interactive transaction patterns
  • raw-queries - $queryRaw and $executeRaw safety
  • client-methods - lifecycle methods, extensions, and satisfies patterns for prisma-client

Client Instantiation

import { PrismaClient } from '../generated/client'
import { PrismaPg } from '@prisma/adapter-pg'

const adapter = new PrismaPg({
  connectionString: process.env.DATABASE_URL
})

const prisma = new PrismaClient({ adapter })

Model Query Methods

Method Description
findUnique() Find one record by unique field
findUniqueOrThrow() Find one or throw error
findFirst() Find first matching record
findFirstOrThrow() Find first or throw error
findMany() Find multiple records
create() Create a new record
createMany() Create multiple records
createManyAndReturn() Create multiple and return them
update() Update one record
updateMany() Update multiple records
updateManyAndReturn() Update multiple and return them
upsert() Update or create record
delete() Delete one record
deleteMany() Delete multiple records
count() Count matching records
aggregate() Aggregate values (sum, avg, etc.)
groupBy() Group and aggregate

Query Options

Option Description
where Filter conditions
select Fields to include
include Relations to load
omit Fields to exclude
orderBy Sort order
take Limit results
skip Skip results (pagination)
cursor Cursor-based pagination
distinct Unique values only

Client Methods

Method Description
$connect() Explicitly connect to database
$disconnect() Disconnect from database
$transaction() Execute transaction
$queryRaw() Execute raw SQL query
$executeRaw() Execute raw SQL command
$on() Subscribe to events
$extends() Add extensions

Quick Examples

Find records

// Find by unique field
const user = await prisma.user.findUnique({
  where: { email: '[email protected]' }
})

// Find with filter
const users = await prisma.user.findMany({
  where: { role: 'ADMIN' },
  orderBy: { createdAt: 'desc' },
  take: 10
})

Create records

const user = await prisma.user.create({
  data: {
    email: '[email protected]',
    name: 'Alice',
    posts: {
      create: { title: 'Hello World' }
    }
  },
  include: { posts: true }
})

Update records

const user = await prisma.user.update({
  where: { id: 1 },
  data: { name: 'Alice Smith' }
})

Delete records

await prisma.user.delete({
  where: { id: 1 }
})

Transactions

const [user, post] = await prisma.$transaction([
  prisma.user.create({ data: { email: '[email protected]' } }),
  prisma.post.create({ data: { title: 'Hello', authorId: 1 } })
])

Rule Files

Detailed API documentation:

references/constructor.md        - PrismaClient constructor options
references/model-queries.md      - CRUD operations
references/query-options.md      - select, include, omit, where, orderBy
references/filters.md            - Filter conditions and operators
references/relations.md          - Relation queries and nested operations
references/transactions.md       - Transaction API
references/raw-queries.md        - $queryRaw, $executeRaw
references/client-methods.md     - $connect, $disconnect, $on, $extends

Filter Operators

Operator Description
equals Exact match
not Not equal
in In array
notIn Not in array
lt, lte Less than
gt, gte Greater than
contains String contains
startsWith String starts with
endsWith String ends with
mode Case sensitivity

Relation Filters

Operator Description
some At least one related record matches
every All related records match
none No related records match
is Related record matches (1-to-1)
isNot Related record doesn't match

Resources

How to Use

Pick the category from the table above, then open the matching reference file for implementation details and examples.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Prisma