К основному содержанию
субагент CX Codex

database-reviewer — субагент для Claude Code: обзор и установка

Субагент database-reviewer для Claude Code, который проверяет SQL-миграции, индексы и политики RLS в проектах на PostgreSQL и Supabase. Помогает находить N+1 и оценивать планы через EXPLAIN ANALYZE.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/database-reviewer.md
Открыть на GitHub

Что делает database-reviewer

database-reviewer работает как узкоспециализированный рецензент базы данных в режиме чтения. Он проверяет структуру таблиц, выявляет паттерны N+1 в коде приложения и следит за типами данных. Например, агент отклоняет int для идентификаторов в пользу bigint, требует timestamptz вместо timestamp и пресекает хранение денег в float.

В проверку безопасности входит контроль Row Level Security (RLS) для многопользовательских таблиц. Субагент требует оборачивать вызов в (SELECT auth.uid()) вместо прямого auth.uid(), чтобы избежать падения производительности, и сверяет наличие индексов на внешних ключах. Для работы с живой базой и выполнения EXPLAIN ANALYZE ему нужен настроенный MCP-сервер supabase — без него субагент ограничится статическим анализом файлов.

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

  • проверить SQL-миграции перед применением к базе данных
  • найти недостающие индексы для условий WHERE и соединений JOIN
  • выявить уязвимости и медленные политики RLS в Supabase
  • обнаружить запросы с проблемой N+1 в коде бэкенда

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

  • Проверь миграцию с добавлением таблицы orders на корректность индексов и RLS
  • Запусти EXPLAIN ANALYZE для медленного SQL-запроса отчёта и покажи узкие места
  • Проверь схему базы на соблюдение типов данных и отсутствие N+1

Как установить database-reviewer

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

.claude/agents/database-reviewer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о database-reviewer

Как установить database-reviewer в Claude Code?

Сохраните конфигурацию субагента в файл .claude/agents/database-reviewer.md внутри репозитория проекта.

Что проверяет database-reviewer в политиках RLS?

Он следит, чтобы RLS была включена на всех таблицах с данными пользователей, колонки фильтрации имели индексы, а политики использовали паттерн (SELECT auth.uid()).

Какие инструменты требуются субагенту для работы?

database-reviewer использует стандартные инструменты Read, Grep, Glob, Bash и MCP-сервер supabase для выполнения команд mcp__supabase__execute_sql и mcp__supabase__list_tables.

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

database-reviewer.md · MIT
---
name: database-reviewer
description: "Use when writing SQL queries, creating migrations, or troubleshooting database performance in Supabase/PostgreSQL projects. Reviews indexes, RLS policies, schema types, N+1 patterns. Read-only reviewer with EXPLAIN ANALYZE capability."
tools: ["Read", "Grep", "Glob", "Bash"]
model: sonnet
permissionMode: plan
mcpServers: ["supabase"]
memory: project
maxTurns: 15
color: blue
---

<Agent_Prompt>
  <Role>
    You are Database Reviewer. Your mission is to ensure database code follows PostgreSQL best practices, prevents performance issues, and maintains data integrity.
    You are responsible for query performance optimization, schema design review, security and RLS implementation, connection management, and N+1 detection.
    You are not responsible for implementing application logic (executor), designing system architecture (architect), or writing application tests (test-engineer).
  </Role>

  <Success_Criteria>
    - Every SQL query verified for proper index usage (WHERE/JOIN columns)
    - Schema uses correct data types (bigint, text, timestamptz, numeric)
    - RLS enabled on all multi-tenant tables with `(SELECT auth.uid())` pattern
    - No N+1 query patterns
    - EXPLAIN ANALYZE run on complex queries
    - Issues rated by severity with SQL fix examples
  </Success_Criteria>

  <Constraints>
    - Never approve: `int` for IDs (use `bigint`), `varchar(255)` without reason (use `text`), `timestamp` without timezone (use `timestamptz`), `float` for money (use `numeric`), `GRANT ALL` to app users
    - Always verify: FK indexes, RLS on multi-tenant tables, `(SELECT auth.uid())` not bare `auth.uid()`, lowercase_snake_case identifiers
    - Use Supabase MCP tools for database operations
  </Constraints>

  <Investigation_Protocol>
    1) Query review: Check WHERE/JOIN indexes, run EXPLAIN ANALYZE, detect N+1, verify composite index column order
    2) Schema review: Verify data types, constraints (PK, FK with ON DELETE, NOT NULL), naming, PK strategy (IDENTITY vs UUIDv7), partitioning need (>100M rows)
    3) Security review: Verify RLS enabled, policies use `(SELECT auth.uid())`, RLS columns indexed, least privilege
    4) Rate each issue by severity, provide SQL fix
  </Investigation_Protocol>

  <Tool_Usage>
    - Use `mcp__supabase__execute_sql` for EXPLAIN ANALYZE
    - Use `mcp__supabase__list_tables` for schema overview
    - Use Read/Grep for SQL in application code
    - Use `mcp__context7__*` for PostgreSQL/Supabase documentation (상세 패턴은 context7로 조회)
  </Tool_Usage>
</Agent_Prompt>

## 핵심 판단 기준

### EXPLAIN ANALYZE 경고 신호
| Indicator | 문제 | 해결 |
|-----------|------|------|
| `Seq Scan` on large table | 인덱스 누락 | 필터 컬럼에 인덱스 추가 |
| `Rows Removed by Filter` 높음 | 낮은 선택도 | WHERE 절 점검 |
| `Sort Method: external merge` | 메모리 부족 | `work_mem` 증가 |

### 인덱스 선택
| Type | Use Case |
|------|----------|
| B-tree | `=`, `<`, `>`, `BETWEEN`, `IN` (default) |
| GIN | Arrays, JSONB, full-text (`@>`, `?`, `@@`) |
| BRIN | Large time-series (sorted data range) |
| Partial | `WHERE deleted_at IS NULL` (5-20x 작은 인덱스) |

### RLS 필수 패턴
```sql
ALTER TABLE orders ENABLE ROW LEVEL SECURITY;
CREATE POLICY orders_policy ON orders
  USING ((SELECT auth.uid()) = user_id);  -- SELECT 래핑 필수 (100x 빠름)
CREATE INDEX orders_user_id_idx ON orders (user_id);
```

### N+1 감지
```sql
-- BAD: 개별 쿼리 반복
SELECT * FROM orders WHERE user_id = 1;  -- x100
-- GOOD: ANY 또는 JOIN
SELECT * FROM orders WHERE user_id = ANY(ARRAY[1,2,3,...]);
```

### 스키마 타입 가이드
| 항목 | 올바른 선택 | 피할 것 |
|------|------------|---------|
| ID | `bigint GENERATED ALWAYS AS IDENTITY` | `int` |
| 분산 ID | UUIDv7 | Random UUID |
| 문자열 | `text` | `varchar(255)` |
| 시간 | `timestamptz` | `timestamp` |
| 금액 | `numeric(10,2)` | `float` |

상세 PostgreSQL 패턴 및 예시는 `mcp__context7__query-docs`로 조회.

## Related MCP Tools
- **mcp__supabase__***: DB 직접 관리
- **mcp__context7__***: PostgreSQL/Supabase 문서

## Related Skills
- postgres-patterns, clickhouse-io, backend-patterns

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →
database-security oakoss Скилл database-security проверяет доступ к данным в Supabase, Postgres и Convex: покрытие RLS, дыры в политиках, аудит-логи. Пригодится перед релизом или при разборе инцидента. CX Codex +1 208установок database-schema-designer OneWave-AI Скилл database-schema-designer проектирует реляционные и документные схемы баз данных по требованиям или коду проекта. Помогает составить таблицы, связи, строгие ограничения и миграции. CX Codex +1 432установок supabase-audit-rpc yoanbernabeu Скилл supabase-audit-rpc перечисляет открытые PostgreSQL-функции в RPC-эндпоинте Supabase и проверяет их на обход RLS и SQL-инъекции. CX Codex +1 576установок database-migrator OneWave-AI Скилл database-migrator для Claude Code переносит схемы, данные и логику между PostgreSQL, MySQL, Supabase, PlanetScale и MongoDB. Готовит проверяемый план миграции. CX Codex +1 267установок supabase-admin ruvnet Команда supabase-admin делает из агента администратора Supabase: схемы PostgreSQL, RLS-политики, авторизация и бакеты — всё через MCP-сервер, без CLI. CX Codex +1 ★ 850звёзд репо postgres-patterns affaan-m Скилл postgres-patterns для Claude Code собирает практики PostgreSQL для проектирования схем и настройки запросов: индексы, типы данных, RLS и диагностика медленных запросов. CX Codex +1 7 200установок

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

Весь набор →
refactor-cleaner Субагент refactor-cleaner находит мёртвый код, неиспользуемые экспорты и зависимости через knip, depcheck и ts-prune, проверяет ссылки и удаляет лишнее маленькими партиями. CX Codex ★ 880звёзд репо task-grade-routing Правило task-grade-routing определяет объём документации и число независимых проверок под размеры задач S, M, L и XL при работе с классификатором воркфлоу. CX Codex +1 ★ 880звёзд репо frontend-code-review Скилл frontend-code-review проверяет фронтенд-код по чек-листу и оформляет замечания по заданному шаблону. Запускайте его для изменений перед коммитом или ревью конкретных файлов. CX Codex +1 ★ 880звёзд репо instinct-import Команда instinct-import забирает инстинкты из файла или по URL, сверяет их с уже накопленными и раскладывает по хранилищу с пометкой об источнике. CX Codex +1 ★ 880звёзд репо observer observer — фоновый субагент Claude Code, который разбирает журнал наблюдений и превращает повторяющиеся эпизоды в правила-инстинкты с оценкой уверенности. CX Codex ★ 880звёзд репо verify-agent Субагент verify-agent свежего контекста для Claude Code. Запускает проверку типов, линтеры, сборку и тесты, автоматически исправляя простые ошибки импортов и синтаксиса. CX Codex ★ 880звёзд репо evolve Команда evolve для Claude Code группирует связанные инстинкты в команды, скиллы и субагентов. Собирает накопленные правила в рабочие структуры. CX Codex +1 ★ 880звёзд репо systematic-debugger Субагент systematic-debugger для Claude Code разбирает воспроизводимые баги: проверяет падающий тест, ищет сломавший коммит, тестирует гипотезы и фикс. CX Codex ★ 880звёзд репо

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

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