Справочник по Prisma Client API
Даёт агенту справочник по Prisma Client: CRUD и массовые операции, select и include, фильтры, вложенная запись связей, транзакции, безопасный сырой SQL и расширения клиента, примеры на Prisma 7. Для случаев, когда пишут или проверяют запросы через Prisma.
prisma-client-api- Автор
- Prisma
- Источник
- 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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
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
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
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 }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-PrismaClientsetup, adapter wiring, logging, and SQL commenter pluginsmodel-queries- CRUD operations and bulk operationsquery-options-select,include,omit, sort, paginationfilters- scalar and logical filter operatorsrelations- relation reads and nested writestransactions- array and interactive transaction patternsraw-queries-$queryRawand$executeRawsafetyclient-methods- lifecycle methods, extensions, andsatisfiespatterns forprisma-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 и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel