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

db-enforcer — скилл для Claude Code: что делает и установка

Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS.

MIT 109 установок ★ 29 обновлён 2026-08-17

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

Что делает db-enforcer

db-enforcer связывает типы TypeScript с ограничениями PostgreSQL и проверяет согласованность схемы Prisma. Он задаёт порядок работы с изменениями: сначала сгенерировать SQL командой prisma migrate dev --create-only, затем проверить схему через prisma validate, а новые таблицы снабдить политиками RLS.

Скилл также описывает правила именования через @map и @@map, проверку индексов и миграции без длительных блокировок. Для UUIDv7 требуется PostgreSQL 18; на более ранних версиях в качестве альтернативы указан gen_random_uuid() через pgcrypto. Для полной проверки безопасности RLS в описании выделен отдельный скилл database-security.

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

  • сверить типы TypeScript с ограничениями CHECK в базе
  • подготовить миграцию Prisma до применения изменений
  • сопоставить имена полей Prisma и колонок PostgreSQL
  • настроить политики RLS для новых таблиц
  • спланировать изменение схемы с учётом блокировок

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

  • Проверь схему Prisma и сопоставь типы TypeScript с ограничениями PostgreSQL.
  • Подготовь миграцию для новой таблицы с политикой RLS и проверь порядок команд.
  • Проверь, как добавить обязательное поле в большую таблицу без полной блокировки.

Как установить db-enforcer

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill db-enforcer -a claude-code

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

~/.claude/skills/db-enforcer/SKILL.md

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

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

Вопросы о db-enforcer

Как установить db-enforcer в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill db-enforcer -a claude-code. Файл скилла находится по пути ~/.claude/skills/db-enforcer/SKILL.md.

Что делает db-enforcer?

Проверяет согласованность PostgreSQL и Prisma: типы, ограничения, именование, миграции и политики RLS. Также описывает способы добавлять изменения схемы с учётом блокировок.

Какие версии PostgreSQL нужны для UUIDv7 и виртуальных колонок?

Для uuidv7() и виртуальных колонок требуется PostgreSQL 18. Для UUID на более ранней версии указан gen_random_uuid() через pgcrypto, а для виртуальных колонок — вариант STORED, доступный с PostgreSQL 12.

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

SKILL.md · MIT
---
name: db-enforcer
description: 'Enforces database integrity for PostgreSQL and Prisma systems. Use when designing schemas, writing migrations, or configuring Row-Level Security. Use for type-safe SQL, naming alignment, constraint validation, zero-trust RLS policies, UUIDv7 primary keys, and zero-downtime deployments.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# DB Enforcer

## Overview

Enforces data integrity and architectural consistency between the TypeScript application layer and the PostgreSQL persistence layer. Prevents type drift by ensuring CHECK constraints mirror TypeScript types, migrations are generated before applying changes, and Row-Level Security protects every table.

**When to use:** Schema design, migration planning, RLS policy authoring, Prisma model mapping, constraint auditing, zero-downtime deployments.

**When NOT to use:** Application-level business logic, frontend state management, non-PostgreSQL databases. For full RLS auditing, performance tuning, and compliance validation, use the `database-security` skill instead.

## Quick Reference

| Pattern               | API/Tool                            | Key Points                                           |
| --------------------- | ----------------------------------- | ---------------------------------------------------- |
| Type-to-DB sync       | `prisma migrate dev --create-only`  | Generate SQL before applying changes                 |
| Naming alignment      | `@map` / `@@map`                    | snake_case in SQL, camelCase in TS                   |
| Primary keys          | `DEFAULT uuidv7()`                  | Sequential, globally unique, fast indexing (PG 18+)  |
| Virtual columns       | `GENERATED ALWAYS AS (...) VIRTUAL` | Zero disk cost, computed on read (PG 18+)            |
| Temporal uniqueness   | `EXCLUDE USING gist`                | Prevent overlapping ranges natively                  |
| NOT VALID constraints | `ADD CONSTRAINT ... NOT VALID`      | Add constraints without table locks                  |
| TypedSQL              | `prisma.$queryRawTyped()`           | Type-safe raw SQL via `.sql` files                   |
| Relation emulation    | `relationMode = "prisma"`           | Integrity in FK-less environments (GA since 4.8.0)   |
| Soft deletes          | Prisma `$extends`                   | Cross-cutting concern via client extensions          |
| RLS standard          | `(select auth.uid()) = user_id`     | Default own-data access policy with initPlan caching |
| Team RLS              | `EXISTS` subquery                   | Permission checks via join tables                    |
| Column-level security | PostgreSQL Views                    | Hide sensitive columns from public APIs              |

## Synchronization Protocol

Every schema modification MUST follow these steps:

1. **Type-to-DB Verification**: When adding an enum or union in TS, verify the equivalent CHECK constraint in SQL
2. **Migration-First Generation**: Generate SQL migrations using `prisma migrate dev --create-only` BEFORE applying
3. **Naming Alignment**: Enforce snake_case in SQL and camelCase in TS via explicit `@map`/`@@map` directives
4. **Integrity Audit**: Run `prisma validate` and check for missing indices on relation scalars
5. **RLS Verification**: Confirm every new table has RLS enabled with appropriate policies
6. **Lock Assessment**: Evaluate whether migration requires `CREATE INDEX CONCURRENTLY` or `NOT VALID` patterns

## PostgreSQL Version Requirements

Several patterns in this skill require specific PostgreSQL versions:

| Feature            | Minimum Version | Fallback                                      |
| ------------------ | --------------- | --------------------------------------------- |
| `uuidv7()`         | PostgreSQL 18   | `gen_random_uuid()` (UUIDv4) via `pgcrypto`   |
| Virtual columns    | PostgreSQL 18   | `STORED` generated columns (PG 12+)           |
| `EXCLUDE USING`    | PostgreSQL 9.0  | Application-level overlap checks              |
| `NOT VALID`        | PostgreSQL 9.1  | Schedule constraint addition during downtime  |
| `security_invoker` | PostgreSQL 15   | Use `security_definer` with restricted grants |

## Common Mistakes

| Mistake                                                  | Correct Pattern                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Running SQL changes manually without migrations          | Generate numbered migrations with `prisma migrate dev --create-only` before applying  |
| Using auto-increment or raw IDs exposed in URLs          | Use UUIDv7 for globally unique, non-enumerable identifiers                            |
| Skipping CHECK constraints on enums or unions            | Add database-level CHECK constraints that mirror TypeScript types                     |
| Mixing snake_case and camelCase without explicit mapping | Use `@map` and `@@map` to enforce snake_case in SQL and camelCase in TypeScript       |
| Tables without Row-Level Security policies               | Apply RLS policies to every table, defaulting to `(select auth.uid()) = user_id`      |
| DROP or RENAME column in a single deployment             | Use expand-and-contract: add new column, dual-write, backfill, switch reads, drop old |
| Adding NOT NULL to large tables with full lock           | Add column as NULL first, backfill, then add NOT NULL with NOT VALID                  |
| Creating indices without CONCURRENTLY                    | Use `CREATE INDEX CONCURRENTLY` in raw SQL migrations to avoid table locks            |
| Using `auth.uid()` directly in RLS without subselect     | Wrap in `(select auth.uid())` to trigger initPlan caching                             |
| Assuming `uuidv7()` works on all PG versions             | Verify PostgreSQL 18+; fall back to `gen_random_uuid()` on older versions             |

## Naming Conventions

Prisma models use camelCase in TypeScript and must map to snake_case in PostgreSQL:

| Layer      | Convention  | Enforced By              |
| ---------- | ----------- | ------------------------ |
| TypeScript | camelCase   | Prisma model field names |
| PostgreSQL | snake_case  | `@map` / `@@map`         |
| Enums      | UPPER_SNAKE | CHECK constraints        |
| Indices    | snake_case  | `idx_table_column`       |

## Deployment Pipeline

Migrations follow a strict pipeline order:

1. `prisma migrate dev --create-only` -- generate and review SQL locally
2. `prisma validate` -- verify schema consistency
3. Apply to staging/preview database and run integration tests
4. `prisma migrate deploy` -- apply in CI/CD pipeline to production
5. Monitor for lock contention and query plan regressions

## Relationship to Other Skills

- **`database-security`**: Covers full RLS auditing, PGAudit configuration, Supabase-specific patterns, Convex auth guards, and compliance validation. Use `database-security` for in-depth policy review and access simulation. Use `db-enforcer` for schema design and migration patterns that include RLS as part of the integrity workflow.

## Delegation

- **Audit existing schema for missing constraints or indices**: Use `Explore` agent
- **Plan a zero-downtime migration strategy for production databases**: Use `Plan` agent
- **Execute a full schema refactor with type alignment and RLS setup**: Use `Task` agent
- **Review RLS policies for bypasses and performance issues**: Use `database-security` skill

## References

- [PostgreSQL integrity patterns, UUIDv7, virtual columns, and temporal constraints](references/postgres-integrity.md)
- [Prisma architecture, TypedSQL, extensions, and edge-first patterns](references/prisma-architecture.md)
- [Migration safety protocols, destructive changes, and rollback strategies](references/migration-safety.md)
- [Row-Level Security, column-level security, and audit logging](references/rls-security.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Данные и базы» →
prisma prisma Управляет базами данных Postgres прямо из диалога с ассистентом. Создаёт инстансы Prisma Postgres и накатывает миграции схемы. multi-tenant-safety-checker patricio0312rev Скилл multi-tenant-safety-checker настраивает изоляцию данных между арендаторами в PostgreSQL через Row Level Security, проверяет запросы в Prisma и создаёт тесты на утечки. CX Codex +1 446установок supabase-postgres-best-practices supabase Скилл supabase-postgres-best-practices помогает агенту проектировать схемы и писать SQL с учётом правил Supabase для Postgres. Подключайте его до изменений базы и при разборе проблем с запросами, подключениями или RLS. CX Codex +1 146установок database-design spencerpauly Скилл database-design помогает спроектировать реляционную схему базы данных, расставить внешние ключи, индексы и сгенерировать модели для Prisma или Drizzle по требованиям к проекту. CX Codex +1 505установок prisma-migration-assistant patricio0312rev Скилл prisma-migration-assistant помогает планировать и проводить миграции Prisma без потери данных. Подходит для разделения колонок, смены типов и безопасного наполнения таблиц. CX Codex +1 316установок database-reviewer sangrokjung Субагент database-reviewer для Claude Code, который проверяет SQL-миграции, индексы и политики RLS в проектах на PostgreSQL и Supabase. Помогает находить N+1 и оценивать планы через EXPLAIN ANALYZE. CX Codex ★ 880звёзд репо

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

Весь набор →
figma-developer Скилл figma-developer для Claude Code получает из Figma цвета, шрифты и иконки через REST API и собирает CSS-переменные и React-компоненты. Автоматизирует перенос изменений макета в код. CX Codex +1 114установок tanstack-store Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок hono Скилл по веб-фреймворку Hono для создания API и edge-функций на Cloudflare Workers, Bun, Deno и Node.js. CX Codex +1 112установок astro Скилл Claude Code объясняет агенту Astro: коллекции контента, островную гидратацию, view transitions и режимы рендеринга. Описывает статичные сайты с вкраплениями интерактива. CX Codex +1 111установок electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок trpc trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами. CX Codex +1 109установок tauri Помогает собирать приложения на Tauri v2 с веб-интерфейсом и бэкендом на Rust. Подключается при настройке проекта, IPC, разрешений или выпуска приложения. CX Codex +1 108установок turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок

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

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