ReskillSQL — скилл
ReskillSQL разбирает неудачные SQL-запросы агента и выпускает версии скилла query-writing после проверки на отложенной выборке.
- 184 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Схема и вопросы уходят выбранному LLM-провайдеру.
- Скилл меняется автоматически по результатам прогонов, поэтому патчи стоит просматривать.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/reskillsqlОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Схема и вопросы уходят выбранному LLM-провайдеру.
- Скилл меняется автоматически по результатам прогонов, поэтому патчи стоит просматривать.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ReskillSQL, Text-to-SQL агент с обновляемыми скиллами, ищет причину ошибки в неверном запросе: лишние столбцы в выборке, не та агрегация, формат значения, путь соединения таблиц. Из найденных причин готовится патч скилла `query-writing`, который проходит SQL-проверку до включения. В репозитории лежат два скилла, `query-writing` и `schema-exploration`, их версии в `skills/query-writing/versions` и воспроизводимые бенчмарки. Модель не дообучается: меняются только версионируемые инструкции и политики вызова инструментов. SQLite выполняется в режиме чтения с ограничением по времени. Опционально включается память опыта, по умолчанию она выключена.
Для кого. Исследователям и инженерам, которые настраивают Text-to-SQL агента и хотят улучшать его инструкции по данным о реальных ошибках, а не вручную.
Подходит, если
- Агент пишет SQL, и одни и те же ошибки повторяются от запроса к запросу.
- Нужна история версий скилла с причиной каждого изменения.
- Команда сравнивает обновление скилла с памятью опыта на отложенной выборке.
- В агента подключают скиллы `query-writing` и `schema-exploration` для SQLite.
Не подходит, если
- Нужен готовый плагин, который ставится одной командой в Claude Code.
- База данных работает на другой СУБД, не на SQLite.
- Требуются опубликованные цифры точности: в репозитории их нет.
Пример запроса к агенту
Разбери провалы этого прогона Text-to-SQL, назови категорию каждой ошибки и предложи патч для скилла `query-writing`.Ограничения
Проект исследовательский: официальной таблицы точности нет, отчеты хранятся локально в `reports/`. Основной протокол рассчитан на BIRD-подобный набор и Gemini 2.5 Flash. Для оценки по умолчанию нужен доступ к LLM-провайдеру, а память опыта дополнительно требует совместимый эндпоинт эмбеддингов. Режим работы как сервиса описан в документации, но проект прямо не заявляет о нагрузочных испытаниях. Скиллы нужно копировать в каталог агента вручную: готового установщика для Claude Code в репозитории нет. Принятые патчи стоит просматривать глазами, потому что скилл меняется автоматически.
Как отключить. Удалите папки скиллов из настроек агента и каталог проекта. Локальные отчеты, базы памяти и ключи провайдеров удалите отдельно.
Частые вопросы
Дообучает ли ReskillSQL модель?
Нет. Меняются только версионируемые скиллы и политики использования инструментов, веса модели остаются прежними.
Как проверить работу без ключей?
Запустите `uv run text2sql-demo`. Демо детерминировано и обходится без LLM, а отчет собирается командой `uv run text2sql-render-report`.
Что решает шлюз проверки?
Он сравнивает точность до и после патча, смотрит на целевую категорию ошибок и регрессии. Принятый патч получает новую версию, отвергнутый остается как свидетельство.
Включена ли память опыта?
Нет, по умолчанию она выключена. Для нее нужен эндпоинт эмбеддингов, а обучение идет только на выборках update и validation.
Безопасно ли исполнение SQL?
SQLite открывается только на чтение, а запрос ограничен по времени, поэтому ошибочный SQL не повесит прогон.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыsqlsure проверяет SQL по заявленным фактам схемы и ловит задвоение сумм после join до запуска запроса.
Скилл Neon с советами по Postgres 14–18: схема, индексы, оптимизация запросов, миграции и типичные ошибки.
31 скилл для Claude Code и Codex на весь путь аналитика: проверка данных, когорты, воронки, A/B-тесты, дашборды, резюме
Скиллы Probabl для экспериментов по машинному обучению: пайплайн на scikit-learn и skrub, оценка, аудит и подключение к Skore Hub
Скилл и CLI для анализа таблиц: чистка с записанными решениями, статистика на нужном уровне, PDF-отчет и отдельный аудит.
CLI импортирует CSV и JSON в SQLite, выполняет SQL и меняет схему, чтобы агент готовил локальные наборы данных для анализа.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ReskillSQL (эта карточка) | нет | 184 | |
| Self-Improving Agent | нет | 790 | фиксирует уроки агента в общем виде; ReskillSQL специализирован под SQL и проверяет патч шлюзом |
| Анализатор SQL/1С-запросов | нет | 0 | анализирует готовые запросы; ReskillSQL учит агента, как писать запросы |
Коротко о README
Обновление скилла проходит три шага: диагностика ошибки, кандидатный патч, проверка шлюзом. Выборки update, validation и holdout разделены, чтобы оценивать перенос на новые задачи.