database-optimizer - Оптимизация запросов и нагрузки базы

Когда звать

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

Зачем нужен Database Optimizer

Database Optimizer задаёт агенту порядок работы с медленной базой: сначала получить исходные замеры и план выполнения запроса, затем найти причину задержки. В область скилла входят PostgreSQL и MySQL, индексы, настройки памяти, разделение таблиц и конкуренция за блокировки.

Это подходящий выбор, если проблема шире одного SQL-запроса. Например, чтение может ускориться после нового индекса, а запись стать тяжелее. Автор требует учитывать такую нагрузку и задержку репликации. Если нужен прежде всего сложный запрос для отчёта, рядом есть SQL Pro.

Как агент должен разбирать проблему

В основном файле описана последовательность: сохранить показатели, разобрать неэффективные запросы и настройки, предложить изменения, применять их по одному и повторять измерение. Одновременная смена нескольких параметров запрещена: иначе нельзя установить, что именно повлияло на результат.

Для PostgreSQL приведены запросы к статистике медленных операций, чтение плана через EXPLAIN (ANALYZE, BUFFERS) и проверка использования индексов. Примеры помогают искать расхождение между ожидаемым и фактическим количеством строк, чтение с диска и сортировку, которая не помещается в память. В справочниках отдельно разобраны настройка PostgreSQL, настройка MySQL, индексы, запросы и наблюдение за нагрузкой.

Автор просит записать исходное время, причину проблемы с подтверждением из плана, выбранное изменение и повторные показатели. Быстрый ответ на маленькой тестовой таблице сам по себе не доказывает ускорение рабочей системы. Передавайте агенту также объём таблиц и характер обычной нагрузки.

Подключение и первая задача

В проверенной папке находятся SKILL.md и пять файлов references. Команды установки набора приведены в QUICKSTART автора. Для одного скилла можно перенести только папку skills/database-optimizer, сохранив справочники, в каталог скиллов своего клиента. Инструкция для Claude Code есть в статье как установить скилл.

Начните с обезличенной схемы и сохранённого плана. Готовая формулировка: «Разберите этот план, назовите возможную причину задержки и предложите одно проверяемое изменение. Запросы к базе пока не выполняйте». В ответе должны быть основания из плана, способ сравнения и условие отката. Если агент сразу предлагает индекс без исходных данных, порядок из скилла не соблюдён.

Доступ к данным и ограничения

Скилл является текстовой инструкцией и сам не создаёт подключение к базе. Однако агент с уже выданными правами способен менять индексы и настройки. Начинайте на копии данных; разрешение на чтение не должно незаметно превращаться в разрешение на изменение схемы.

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

На 22 октября 2026 года проверены файл скилла версии 1.1.1, состав папки и лицензия MIT в указанном коммите. Установку и оптимизацию настоящей базы мы не проводили. Это проверка первоисточника, а не отчёт об измеренном ускорении.