sql-pro - SQL Pro, быстрые запросы и схема базы

Когда звать

• Когда запрос к базе тормозит и агент советует индексы наугад, не посмотрев план выполнения и объём данных.
• Когда нужно написать сложный отчёт с группировками и накопительными итогами или перенести запрос между PostgreSQL и MySQL.

Что это

Запрос к базе тормозит - и агент первым делом предлагает «добавить индекс». Иногда это работает, но чаще это лечение без диагноза: пока не посмотрели, как база выполняет запрос и сколько строк читает, любой совет - догадка.

SQL Pro заставляет работать в порядке: разобрать схему и запросы, составить запрос через операции над наборами строк (CTE, оконные функции, нужные соединения), посмотреть план выполнения, подобрать индексы, проверить, что на больших таблицах нет полного перебора, и записать, почему выбраны именно эти индексы и каковы результаты. Если запрос не укладывается в целевые сто миллисекунд, скилл велит вернуться к индексам или переписать запрос.

Что обязательно и что запрещено

Обязательное: смотреть план до рекомендаций; обрабатывать наборы строк целиком, без цикла по строкам; фильтровать как можно раньше; проверять существование через EXISTS (не через COUNT); явно обрабатывать пустые значения; делать покрывающие индексы для частых запросов; проверять на объёмах, как в рабочей базе.

Запрещено: SELECT * в рабочих запросах, курсоры там, где хватает наборов, игнорирование особенностей конкретной базы и решения без учёта объёма данных.

В тексте скилла есть примеры: CTE для «последнего заказа клиента», оконные функции для накопительной суммы и рейтинга, пример «до и после» с заменой подзапроса на соединение и покрывающим индексом.

Как поставить

Из README и QUICKSTART автора.

В Claude Code (ставится весь набор из 67 скиллов):

/plugin marketplace add jeffallan/claude-skills
/plugin install fullstack-dev-skills@fullstack-dev-skills

В Codex отдельной инструкции у автора нет. Универсальная установка только скиллов через skills.sh описана так, мы её для Codex не запускали:

npx skills add jeffallan/claude-skills

Чтобы взять только этот скилл, скопируй вручную папку skills/sql-pro. Как это сделать в Claude Code - в статье как установить скилл.

Проверка: покажи агенту схему из двух таблиц и медленный запрос и попроси оптимизацию. Он должен начать с плана выполнения и только потом предлагать индексы.

Главная осторожность

В скилле рекомендовано всегда использовать EXPLAIN (ANALYZE, BUFFERS) в PostgreSQL. Эта команда выполняет запрос на самом деле, чтобы показать реальное время. Для запросов на чтение это нормально. Для INSERT, UPDATE, DELETE данные изменятся. Подключай агента к копии базы или к тестовому окружению, не к рабочей базе. А если всё же нужно проверить изменяющий запрос, заверни его в транзакцию и откати - агент должен делать это сам по твоей просьбе.

Для боевых баз заведи отдельного пользователя только с чтением. Пароль не вставляй в разговор: положи в переменную окружения или файл настроек клиента.

Мы прочитали SKILL.md целиком, документацию PostgreSQL по EXPLAIN и проверили версию и лицензию на 22 октября 2026 года. Сам скилл мы не запускали. Рядом по теме: API Designer для спецификации и Secure Code Guardian, если запросы строятся из пользовательского ввода.