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

sqlalchemy-alembic-expert-best-practices-code-review — скилл

Скилл sqlalchemy-alembic-expert-best-practices-code-review для Claude Code помогает писать и проверять модели SQLAlchemy, миграции Alembic и запросы к БД. Активируется при изменениях схемы и оптимизации запросов.

MIT 2 200 установок ★ 9 обновлён 2026-02-11

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

Что делает sqlalchemy-alembic-expert-best-practices-code-review

Скилл подсказывает, как безопаснее менять схемы и работать с запросами SQLAlchemy. Он разбирает индексы, ограничения, внешние ключи и изменения типов столбцов, а также помогает находить лишние индексы и проверять, покрывают ли индексы шаблоны запросов.

В комплект входят восемь файлов правил с пояснениями и примерами неверной и корректной реализации. Для операций с индексами в PostgreSQL правила требуют конкурентного создания через autocommit-блоки; для внешних ключей и ограничений CHECK предлагают сначала добавлять ограничение как NOT VALID, а проверять отдельно.

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

  • проверить миграцию Alembic перед изменением схемы
  • найти запросы SQLAlchemy без подходящих индексов
  • разбить добавление внешнего ключа на безопасные шаги
  • убрать индекс, который уже покрывает составной индекс

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

  • Проверь миграцию Alembic для новой модели SQLAlchemy.
  • Найди запросы без подходящих индексов и предложи исправления.
  • Проверь безопасный порядок добавления внешнего ключа.

Как установить sqlalchemy-alembic-expert-best-practices-code-review

1Через Skills CLI (Vercel)

npx skills add wispbit-ai/skills --skill sqlalchemy-alembic-expert-best-practices-code-review -a claude-code

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

~/.claude/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.md

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

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

Вопросы о sqlalchemy-alembic-expert-best-practices-code-review

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

Выполни npx skills add wispbit-ai/skills --skill sqlalchemy-alembic-expert-best-practices-code-review -a claude-code.

Что делает sqlalchemy-alembic-expert-best-practices-code-review?

Он применяет правила для моделей SQLAlchemy, миграций Alembic и шаблонов запросов. В комплекте есть рекомендации по индексам, ограничениям и безопасному изменению схем.

Как скилл предлагает добавлять внешний ключ?

Сначала добавить его как NOT VALID, затем выполнить проверку отдельно.

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

SKILL.md · MIT
---
name: sqlalchemy-alembic-expert-best-practices-code-review
description: SQLAlchemy ORM and Alembic migration best practices for building safe, performant database schemas. This skill should be used when writing, reviewing, or refactoring SQLAlchemy models, Alembic migrations, or database query patterns. Triggers on tasks involving SQLAlchemy ORM, Alembic migrations, database schema changes, or query optimization.
license: MIT
metadata:
  author: wispbit
  version: "1.0.0"
---

# SQLAlchemy & Alembic Expert Best Practices

Simple, pragmatic, opinionated. Only what matters for writing production-grade SQLAlchemy and Alembic code.

## When to Apply

Reference these guidelines when:
- Writing Alembic migrations for schema changes
- Creating or modifying SQLAlchemy models
- Adding indexes, constraints, or foreign keys via Alembic
- Reviewing database migration code for safety
- Refactoring existing database schemas
- Optimizing query patterns or database performance

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Index Management | CRITICAL-HIGH | `only-concurrent-indexes`, `verify-query-patterns-are-indexed` |
| 2 | Constraint Safety | HIGH | `unique-constraint`, `split-foreign-key`, `change-column-type` |
| 3 | Optimization | MEDIUM | `split-check-constraint`, `limit-non-unique-index` |
| 4 | Index Efficiency | LOW | `ensure-index-not-covered` |

## Quick Reference

- `only-concurrent-indexes` - Always use `postgresql_concurrently=True` with autocommit blocks for index operations
- `verify-query-patterns-are-indexed` - Ensure SQLAlchemy queries have appropriate indexes defined
- `unique-constraint` - Split unique constraint creation into concurrent index + constraint steps
- `split-foreign-key` - Add foreign keys with `NOT VALID` first, then validate separately
- `change-column-type` - Use multi-step approach for column type changes to avoid table locks
- `split-check-constraint` - Add check constraints with `NOT VALID` first, then validate separately
- `limit-non-unique-index` - Limit non-unique indexes to maximum three columns for efficiency
- `ensure-index-not-covered` - Prevent redundant indexes that are already covered by composite indexes

## How to Use

Read individual rule files for detailed explanations and code examples:

```
rules/only-concurrent-indexes.md
rules/verify-query-patterns-are-indexed.md
rules/unique-constraint.md
rules/split-foreign-key.md
rules/change-column-type.md
rules/split-check-constraint.md
rules/limit-non-unique-index.md
rules/ensure-index-not-covered.md
```

Each rule file contains:
- Brief explanation of why it matters
- Impact level and description
- Incorrect SQLAlchemy/Alembic example with explanation
- Correct implementation with best practices
- Additional context for safe migrations

© wispbit · MIT · wispbit-ai/skills

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

Все скиллы по теме «Данные и базы» →
alembic Customer Support Tech Enablement Team Скилл alembic для Claude Code помогает управлять миграциями базы данных в системах поддержки. Подключается к задачам со схемой, версиями и переносом данных. CX Codex +1 645установок sqlalchemy bobmatnyc Скилл подсказывает, как описывать модели SQLAlchemy, связывать таблицы и строить запросы. Пригодится при работе с Python-приложением и базой данных. CX Codex +1 322установок SQLAlchemy ORM Expert Customer Support Tech Enablement Team Скилл SQLAlchemy ORM Expert для Claude Code и других агентов: SQLAlchemy 2.0+ для систем поддержки — async-запросы, модели тикетов, сессии и PostgreSQL. Покрывает бэкенд на FastAPI. CX Codex +1 472установок sqlalchemy-code-review existential-birds Скилл sqlalchemy-code-review проверяет SQLAlchemy-код на ошибки в сессиях, связях, запросах и миграциях. Нужен при ревью проектов на SQLAlchemy 2.0 и Alembic. CX Codex +1 228установок sqlalchemy-postgres cfircoo Скилл sqlalchemy-postgres настраивает асинхронную работу с SQLAlchemy 2.0, Pydantic v2 и PostgreSQL. Помогает спроектировать модели, настроить сессии для FastAPI и управлять миграциями Alembic. CX Codex +1 510установок db-wasp-drone Legion Code Inc. Субагент db-wasp-drone для Claude Code разбирает архитектуру PostgreSQL: схемы, индексы, миграции и ORM. Проектирует и ревьюит слой данных. CX Codex ★ 96звёзд репо

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

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

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