# db-expert

Субагент db-expert проверяет схемы, миграции и запросы на риск потери данных, блокирующие локи и N+1, перед тем как изменение попадёт в мастер.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 267 у репозитория
- Автор: NYCU-Chung
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/db-expert.md
- Обновлён: 2026-04-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/db-expert

## Что делает

Субагент работает только на чтение: анализирует `prisma/schema.prisma`, SQL-миграции или `db/schema.rb`, читает запросы к изменённым таблицам и сверяет их с `EXPLAIN`, если доступна дев-база. Он ищет отсутствующие индексы на колонках из `WHERE` и внешних ключах, `DROP COLUMN` и `ALTER TABLE` без `CONCURRENTLY`, которые блокируют большую таблицу, N+1 в циклах `await ... in for ...`, гонки без `SELECT ... FOR UPDATE`.

Отдельно разбирает особенности ORM: в Prisma — `findMany` без `take` и цепочки `include`, в TypeORM — lazy loading и `cascade: true`, в Sequelize — `paranoid: true`, не срабатывающий в сырых запросах. Каждая находка привязана к файлу и строке, с описанием последствия и направлением фикса; пункты без проблем помечаются как чистые.

Отчёт заканчивается оценкой риска миграции: вероятность потери данных, длительность блокировки, обратная совместимость и путь откатаНи одна миграция не считается одобренной без проверки этого отката. Сам файл не правит — это задача инженера, которому передаётся отчёт.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add NYCU-Chung/my-claude-devteam
```
В чате агента (не в терминале):
```text
/plugin install devteam@my-claude-devteam
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/db-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/db-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/db-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/db-expert.md

## Когда брать
- найти отсутствующие индексы на FK и WHERE-колонках
- проверить миграцию на потерю данных перед продом
- выявить N+1 запросы в циклах и include-цепочках ORM
- оценить риск блокировки ALTER TABLE на большой таблице
- разобрать гонки и проблемы изоляции транзакций в запросах

## Примеры запросов агенту
- Проверь миграцию `migrations/20260410_add_email.sql` перед деплоем
- Прогони ревью схемы `prisma/schema.prisma` на недостающие индексы
- Разбери запросы в `src/api/orders.ts` на N+1

## Похожие
- [db-enforcer](https://affpapa.org/nevibecode/skills/db-enforcer.md) — скилл · 109 установок
- [prisma-driver-adapter-implementation](https://affpapa.org/nevibecode/skills/prisma-driver-adapter-implementation.md) — скилл · 425600 установок
- [prisma](https://affpapa.org/nevibecode/plugins/prisma.md) — плагин
- [prisma-patterns](https://affpapa.org/nevibecode/skills/prisma-patterns.md) — скилл · 6300 установок
- [prisma-development](https://affpapa.org/nevibecode/skills/prisma-development.md) — скилл · 741 установка
- [prisma-expert](https://affpapa.org/nevibecode/skills/sickn33-prisma-expert.md) — скилл · 4200 установок

Из того же набора: [nycu-chung/my-claude-devteam](https://affpapa.org/nevibecode/by/nycu-chung/my-claude-devteam.md) — 13 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
