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

sqlalchemy-code-review — скилл для Claude Code: установка

Скилл sqlalchemy-code-review проверяет SQLAlchemy-код на ошибки в сессиях, связях, запросах и миграциях. Нужен при ревью проектов на SQLAlchemy 2.0 и Alembic.

Apache-2.0 228 установок ★ 89 обновлён 2026-09-15

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

Что делает sqlalchemy-code-review

Скилл разбирает жизненный цикл Session и асинхронных сессий, настройки relationship(), ленивую загрузку и запросы N+1. Он также проверяет переход на синтаксис select(), массовые операции и миграции Alembic с upgrade() и downgrade().

Внутри есть чек-лист и ссылки на отдельные справочные материалы по сессиям, связям, запросам и миграциям. Для каждого замечания скилл требует привязать проблему к file:line: для N+1 нужно показать цикл и связь, а для миграции — конкретную операцию op.* или op.execute().

Без подтверждения через file:line находку нельзя выпускать в ревью: правила скилла требуют собрать доказательства, снизить уверенность или переформулировать замечание как вопрос.

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

  • проверить закрытие синхронных и асинхронных сессий
  • найти N+1 при загрузке связей в циклах
  • заменить устаревший query() на select()
  • оценить массовые операции ORM
  • проверить обратимость миграций Alembic

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

  • Проверь этот модуль на ошибки в жизненном цикле Session и привяжи каждое замечание к file:line.
  • Проведи ревью моделей и запросов: найди N+1, проверь relationship(), joinedload и selectinload.
  • Проверь миграции Alembic на корректные upgrade() и downgrade(), указав конкретные строки.

Как установить sqlalchemy-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill sqlalchemy-code-review -a claude-code

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

~/.claude/skills/sqlalchemy-code-review/SKILL.md

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

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

Вопросы о sqlalchemy-code-review

Как установить sqlalchemy-code-review в Claude Code?

Выполните npx skills add existential-birds/beagle --skill sqlalchemy-code-review -a claude-code, затем проверьте файл ~/.claude/skills/sqlalchemy-code-review/SKILL.md.

Что делает sqlalchemy-code-review?

Скилл проверяет сессии, связи, N+1, SQLAlchemy 2.0-запросы, массовые операции и миграции Alembic. Замечания проходят проверки с привязкой к файлам и строкам.

Что нужно указать для замечания о N+1?

Нужно показать цикл или повторный вызов, а также назвать связь либо SQL-шаблон, который выполняется на каждой итерации. Оба факта должны иметь привязку к file:line.

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

SKILL.md · Apache-2.0
---
name: sqlalchemy-code-review
description: Reviews SQLAlchemy code for session management, relationships, N+1 queries, and migration patterns. Use when reviewing SQLAlchemy 2.0 code, checking session lifecycle, relationship() usage, or Alembic migrations.
---

# SQLAlchemy Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| Session lifecycle, context managers, async sessions | [references/sessions.md](references/sessions.md) |
| relationship(), lazy loading, N+1, joinedload | [references/relationships.md](references/relationships.md) |
| select() vs query(), ORM overhead, bulk ops | [references/queries.md](references/queries.md) |
| Alembic patterns, reversible migrations, data migrations | [references/migrations.md](references/migrations.md) |

## Review Checklist

- [ ] Sessions use context managers (`with`, `async with`)
- [ ] No session sharing across requests or threads
- [ ] Sessions closed/cleaned up properly
- [ ] `relationship()` uses appropriate `lazy` strategy
- [ ] Explicit `joinedload`/`selectinload` to avoid N+1
- [ ] No lazy loading in loops (N+1 queries)
- [ ] Using SQLAlchemy 2.0 `select()` syntax, not legacy `query()`
- [ ] Bulk operations use bulk_insert/bulk_update, not ORM loops
- [ ] Async sessions use proper async context managers
- [ ] Migrations are reversible with `downgrade()`
- [ ] Data migrations use `op.execute()` not ORM models
- [ ] Migration dependencies properly ordered

## Gates (SQLAlchemy-specific)

Run **once per SQLAlchemy-related finding**, after you can anchor **`file:line`** (see [review-verification-protocol](../review-verification-protocol/SKILL.md)) and **before** the finding ships. If a step’s pass condition is not met, **do not** assert the finding as written—gather evidence, withdraw, downgrade severity, or rephrase as a question.

### Gate 1 — Session scope and lifecycle

| Step | Action | **Pass condition** |
|------|--------|---------------------|
| 1a | Open the module where the session is created or injected (not from memory). | **`file:line`** for `Session`, `sessionmaker`, `async_session`, or the factory/`Depends()` that yields a session. |
| 1b | If claiming leak, cross-request sharing, or missing cleanup: trace the session’s scope (context manager, `try`/`finally`, middleware). | **Scoped region** cited with a **`file:line` range**, or withdraw if scope is correct after the read. |

### Gate 2 — N+1, lazy loading, eager loads

| Step | Action | **Pass condition** |
|------|--------|---------------------|
| 2a | Identify the loop or repeated call site (ORM attribute access, `execute` in a loop). | **`file:line`** for the loop or hot path. |
| 2b | If claiming N+1: name the relationship or query pattern emitted per iteration. | **Relationship or per-iteration SQL pattern** with **`file:line`**, or rephrase as a question if unclear. |

### Gate 3 — Migrations (Alembic)

| Step | Action | **Pass condition** |
|------|--------|---------------------|
| 3a | Open the revision file (e.g. under `versions/`, or the project’s Alembic layout). | **Repo-relative path** + **`file:line`** for `revision` / `upgrade` / `downgrade`. |
| 3b | If claiming broken `downgrade()` or risky data migration: point at the `op.*` / `op.execute()` involved. | **Snippet or line range** in that file for each claimed op, or withdraw. |

## When to Load References

- Reviewing session creation/cleanup → sessions.md
- Reviewing model relationships → relationships.md
- Reviewing database queries → queries.md
- Reviewing Alembic migration files → migrations.md

## Review Questions

1. Are all sessions properly managed with context managers?
2. Are relationships configured to avoid N+1 queries?
3. Are queries using SQLAlchemy 2.0 `select()` syntax?
4. Are all migrations reversible and properly tested?

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Код-ревью и рефакторинг» →
sqlalchemy-alembic-expert-best-practices-code-review wispbit Скилл sqlalchemy-alembic-expert-best-practices-code-review для Claude Code помогает писать и проверять модели SQLAlchemy, миграции Alembic и запросы к БД. Активируется при изменениях схемы и оптимизации запросов. CX Codex +1 2 200установок sqlalchemy bobmatnyc Скилл подсказывает, как описывать модели SQLAlchemy, связывать таблицы и строить запросы. Пригодится при работе с Python-приложением и базой данных. CX Codex +1 322установок sqlalchemy-postgres cfircoo Скилл sqlalchemy-postgres настраивает асинхронную работу с SQLAlchemy 2.0, Pydantic v2 и PostgreSQL. Помогает спроектировать модели, настроить сессии для FastAPI и управлять миграциями Alembic. CX Codex +1 510установок SQLAlchemy ORM Expert Customer Support Tech Enablement Team Скилл SQLAlchemy ORM Expert для Claude Code и других агентов: SQLAlchemy 2.0+ для систем поддержки — async-запросы, модели тикетов, сессии и PostgreSQL. Покрывает бэкенд на FastAPI. CX Codex +1 472установок fastapi-backend-template rebyteai-template Скилл fastapi-backend-template для Claude Code разворачивает каркас API на FastAPI с асинхронной SQLAlchemy 2.0, PostgreSQL, Alembic и Docker. Создаёт основу бэкенда. CX Codex +1 244установок sqlmodel-expert bilalmk Скилл sqlmodel-expert для Claude Code описывает проектирование моделей SQLModel, связи таблиц и миграции Alembic. Помогает устранять проблемы с N+1 запросами. CX Codex +1 159установок

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

Весь набор →
adr-writing Скилл adr-writing для Claude Code, который оформляет архитектурные решения в документы ADR по шаблону MADR и проверяет их полноту по чек-листу E.C.A.D.R. Работает также в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 254установок swift-code-review Скилл swift-code-review для Claude Code проверяет Swift-код на ошибки конкурентности, обработки ошибок и управления памятью. Подключается при ревью файлов .swift, в том числе с async/await, actors и Sendable. CX Codex +1 253установок review-verification-protocol Скилл review-verification-protocol обязывает проверить каждую находку перед тем, как внести её в отчёт — читать исходный код, искать контекст, отличать баги от стиля. Снижает ложные срабатывания в ревью. CX Codex +1 252установок pytest-code-review Скилл pytest-code-review проверяет тесты pytest на корректность асинхронных вызовов, скоуп фикстур, параметризацию и пути для моков. Помогает находить утечки и ошибки патчинга до запуска CI. CX Codex +1 239установок pydantic-ai-common-pitfalls Скилл pydantic-ai-common-pitfalls разбирает типичные ошибки в агентах на PydanticAI и подсказывает, что править: декораторы инструментов, зависимости, схемы вывода, стриминг. CX Codex +1 221установок agent-architecture-analysis Скилл agent-architecture-analysis проверяет кодовую базу ИИ-агента по методике 12-Factor Agents и выдаёт отчёт с оценкой каждого фактора и ссылками на файлы. CX Codex +1 220установок pydantic-ai-agent-creation Скилл pydantic-ai-agent-creation помогает создавать типобезопасных агентов на PydanticAI: со структурированным выводом, зависимостями и настройками модели. Нужен при сборке AI-агентов и чат-систем. CX Codex +1 219установок ai-elements Скилл ai-elements для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode: помогает собирать интерфейсы чата, очереди задач, отображение инструментов и подтверждений. CX Codex +1 211установок

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

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