sql-helper

# SQL Helper > Генерация SQL-запросов из текстового вопроса и DDL-схемы. Загружай этот скилл когда нужно **превратить вопрос на естественном языке в SQL**: для быстрых запросов к базе, разбора плана выполнения или форматирования SQL. ## 🎯 When to use Use this skill when: - Есть DDL-файл (CREATE TABLE) и вопрос, по которому нужен SQL-запрос - Нужно быстро собрать SELECT/JOIN/GROUP BY/COUNT по шаблону - Просят «сгенерируй sql», «напиши sql», «sql запрос», «sql helper» - Нужно посмотреть план выполнения запроса (EXPLAIN) в читаемом виде Do NOT use when: - Нужна только проверка синтаксиса без схемы — достаточно обычного редактора - Нужна миграция или генерация DDL — это отдельный инструмент - Вопрос не про SQL (анализ данных, CSV, скрейпинг) — это другие скиллы ## 📦 Files - `SKILL.md` — этот файл - `scripts/sql_helper.py` — генератор SQL + EXPLAIN (Python 3 stdlib) - `references/canonical-patterns.md` — канонические аналоги text-to-SQL и разбор недостающих техник ## Canonical analogues Полный разбор — в `references/canonical-patterns.md`. Ключевые каноны, на которые опирается дизайн скилла: - **Anthropic Cookbook `capabilities/text_to_sql`** — эталон интроспекции схемы (sqlite_master + PRAGMA table_info) и execution-based валидации через promptfoo-ассерты. - **sqlsure / sql-semantic-check** — семантические правила FANOUT/JOIN_KEY/ADDITIVITY и интроспекция PK/FK вместо эвристик join. - **Vanna.ai** — контур train → retrieve (few-shot) → generate_sql → run_sql → verify....