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
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. Он разбирает индексы, ограничения, внешние ключи и изменения типов столбцов, а также помогает находить лишние индексы и проверять, покрывают ли индексы шаблоны запросов.
В комплект входят восемь файлов правил с пояснениями и примерами неверной и корректной реализации. Для операций с индексами в 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-code2Вручную: положить файлы
~/.claude/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/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 codex2Вручную: положить файлы
.agents/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill sqlalchemy-alembic-expert-best-practices-code-review -a cursor2Вручную: положить файлы
.cursor/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wispbit-ai/skills skills/sqlalchemy-alembic-expert-best-practices-code-review2Вручную: положить файлы
.github/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill sqlalchemy-alembic-expert-best-practices-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/wispbit-ai/skills --path skills/sqlalchemy-alembic-expert-best-practices-code-reviewВручную: положить файлы
.devin/skills/sqlalchemy-alembic-expert-best-practices-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill sqlalchemy-alembic-expert-best-practices-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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