AIKraft/AI/Войти
AIKraft/Skills/Эксперт по лучшим практикам и код-ревью SQLAlchemy Alembic

Эксперт по лучшим практикам и код-ревью SQLAlchemy Alembic

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.

wispbit-ai official Документы

Что делает навык

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

Когда применять

  • Написание или рефакторинг миграций Alembic для изменений схемы БД
  • Создание или модификация моделей SQLAlchemy ORM
  • Ревью кода миграций на предмет безопасности и производительности
  • Оптимизация паттернов запросов и управление индексами
  • Добавление индексов, ограничений или внешних ключей через Alembic

Как работает

  1. Определить приоритет категории задачи (управление индексами, безопасность ограничений, оптимизация или эффективность индексов)
  2. Применить соответствующие правила, такие как only-concurrent-indexes для параллельных операций с индексами или split-foreign-key для безопасного добавления внешних ключей
  3. Использовать многоэтапный подход для изменения типов колонок (change-column-type) во избежание блокировок таблицы
  4. Проверять, что запросы SQLAlchemy имеют соответствующие индексы (verify-query-patterns-are-indexed)
  5. Избегать избыточных индексов, покрываемых составными (ensure-index-not-covered), и ограничивать несоставные индексы тремя колонками
  6. Читать файлы правил из директории rules/ для получения подробных объяснений и примеров кода

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

Напиши миграцию Alembic для добавления индекса на таблицу users, используя лучшие практики безопасности
Проведи код-ревью модели SQLAlchemy и проверь, правильно ли настроены внешние ключи и ограничения
Рефакторинг существующей схемы: измени тип колонки в базе данных без блокировки таблицы

Что понадобится

  • Репозиторий https://github.com/wispbit-ai/skills с файлами правил в директории rules/

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «sqlalchemy-alembic-expert-best-practices-code-review» из репозитория: # https://github.com/wispbit-ai/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r sqlalchemy-alembic-expert-best-practices-code-review/ ~/.claude/skills/sqlalchemy-alembic-expert-best-practices-code-review/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.