К основному содержанию
команда CX Codex

write-query — команда для Claude Code: SQL из текста

Команда write-query генерирует SQL-запросы из описания на русском или английском. Поддерживает BigQuery, PostgreSQL, MySQL и другие диалекты — нужно только сказать, какие данные нужны.

MIT ★ 28 211 обновлён 2026-10-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add phuryn/pm-skills
/plugin install pm-data-analytics@pm-skills
Открыть на GitHub

Что делает write-query

Напишите на обычном языке, что вам нужно узнать из базы: количество активных пользователей за месяц, конверсию по когортам, тех, кто не завершил онбординг. Команда разберёт запрос, определит схему (если вы загрузите диаграмму или описание таблиц), и выдаст оптимизированный SQL с комментариями.

Внутри команда работает в четыре шага: парсит вопрос, уточняет схему базы, генерирует запрос через скилл sql-queries и показывает результат с объяснением. Если схемы нет, попросит уточнить тип БД или подтвердить примерную структуру. Все запросы содержат комментарии — их удобно делиться с аналитиками.

Команда предлагает доработку: изменить фильтры, создать связанный метрику, собрать дашборд или построить когортный анализ. Если запрос может быть медленным на больших объёмах, она предупредит и подскажет оптимизацию.

Какие задачи решает

  • Написать SQL вместо копирования вручную из документации
  • Превратить устный вопрос про данные в рабочий запрос
  • Переделать запрос для другой БД, не переучивая синтаксис
  • Выяснить, какие таблицы и колонки нужны для метрики

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

  • Покажи активных пользователей последних 30 дней по тарифам
  • Сколько зарегистрировались в прошлом месяце, но не прошли онбординг
  • [загружу схему] Какая конверсия из триала в платный по когортам

Как установить write-query

1Через маркетплейс плагинов

/plugin marketplace add phuryn/pm-skills
/plugin install pm-data-analytics@pm-skills

2Вручную: положить файлы

.claude/commands/write-query.md

Вызов — /write-query. Для всех проектов — ~/.claude/commands/

Вопросы о write-query

Как установить write-query в Claude Code?

Выполни в порядке: /plugin marketplace add phuryn/pm-skills, потом /plugin install pm-data-analytics@pm-skills, затем скопируй файл .claude/commands/write-query.md в проект.

Что делает write-query?

Генерирует SQL-запросы из описания на обычном языке. Поддерживает BigQuery, PostgreSQL, MySQL и другие диалекты, уточняет схему, если нужно, и выдаёт оптимизированный код с комментариями.

Нужна ли схема БД для работы команды?

Не обязательна, но ускорит результат. Если схемы нет, команда попросит уточнить тип БД и подтвердит примерную структуру таблиц.

Исходный текст

write-query.md · MIT
---
description: Generate SQL queries from natural language — supports BigQuery, PostgreSQL, MySQL, and more
argument-hint: "<what you want to know, in plain English>"
---

# /write-query -- SQL Query Generator

Describe what data you need in plain English and get an optimized SQL query. Supports multiple dialects and can read your schema from uploaded files.

## Invocation

```
/write-query Show me daily active users for the last 30 days, broken down by plan tier
/write-query Find users who signed up last month but never completed onboarding
/write-query [upload a schema diagram] What's the conversion rate from trial to paid by cohort?
```

## Workflow

### Step 1: Understand the Question

Parse the user's natural language request to identify:
- What data is being requested (metrics, dimensions, filters)
- Time range and granularity
- Grouping and ordering preferences
- Output expectations (raw data, aggregated, ranked)

### Step 2: Determine Schema

If a schema is available (uploaded diagram, DDL, or description):
- Map the request to specific tables and columns
- Identify necessary joins

If no schema is provided:
- Ask for the database type (BigQuery, PostgreSQL, MySQL, etc.)
- Infer a reasonable schema from the question and ask the user to confirm
- Use common SaaS data model conventions as defaults

### Step 3: Generate Query

Apply the **sql-queries** skill:

- Write the SQL query in the correct dialect
- Optimize for readability and performance
- Include comments explaining key logic
- Add CTEs for complex queries to improve readability
- Handle edge cases (NULLs, timezone considerations, duplicate handling)

### Step 4: Present and Iterate

```
## SQL Query: [What It Does]

**Dialect**: [BigQuery / PostgreSQL / MySQL / etc.]
**Tables used**: [list]

### Query
[SQL code block with comments]

### What This Returns
[Description of the output: columns, rows, expected result shape]

### Assumptions
- [Schema assumptions made]
- [Business logic assumptions]

### Notes
- [Performance considerations for large datasets]
- [Edge cases handled or flagged]
```

Offer:
- "Want me to **modify this** — add filters, change grouping, extend the time range?"
- "Should I **create a companion query** for a related metric?"
- "Want me to **build a dashboard** around this query?"
- "Need a **cohort analysis** version of this?"

## Notes

- Always include comments in the SQL — PMs share queries with analysts who need to understand intent
- Default to readable over clever — CTEs over nested subqueries
- Flag queries that might be slow on large datasets and suggest optimization
- If the request is ambiguous (e.g., "active users"), ask the user to define the metric precisely
- Offer to generate the query in multiple dialects if the user is unsure which database they're using

© Paweł Huryn · MIT · phuryn/pm-skills

Похожие слэш-команды

Все слэш-команды по теме «Данные и базы» →
SQL Query Builder & Optimiser sivasaiyadav8143 Промпт SQL Query Builder & Optimiser ведёт модель по семи шагам: от брифа по запросу до готового SQL с индексами и разбором плана выполнения. GP ChatGPT ★ 178 201звёзд репо sql-query-optimization aj-geddes Скилл sql-query-optimization для Claude Code, Cursor, Codex и других платформ — анализирует медленные SQL-запросы и переписывает их быстрее. Запускается по требованию для PostgreSQL и MySQL. CX Codex +1 529установок sql-pro https://github.com/Jeffallan Скилл sql-pro оптимизирует медленные SQL-запросы, проектирует схемы баз данных и устраняет проблемы производительности. Пригодится при разборе планов EXPLAIN и миграции диалектов. CX Codex +1 6 900установок postgres-query civitai Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev. CX Codex +1 105установок relational-database-mcp-cloudbase TencentCloudBase Скилл relational-database-mcp-cloudbase управляет существующей MySQL-базой CloudBase через инструменты MCP: запросы, схема, права доступа, удаление. Для новых проектов рекомендован PostgreSQL. CX Codex +1 962установок database-design MoizIbnYousaf Скилл database-design для Claude Code и Codex: проектирование схем, миграции и оптимизация запросов для PostgreSQL, MySQL и NoSQL. Даёт агенту готовые SQL-шаблоны вместо общих рассуждений. CX Codex +1 624установок

Из того же набора120

Весь набор →
privacy-policy Команда privacy-policy генерирует черновик политики конфиденциальности с учётом GDPR и CCPA, чек-листом комплаенса и пометками для юриста. Пригодится при запуске сервисов и приложений. CX Codex +1 ★ 28 211звёзд репо tailor-resume Команда tailor-resume подстраивает резюме под конкретную вакансию: сопоставляет ключевые слова, переписывает пункты опыта и показывает пробелы. CX Codex +1 ★ 28 211звёзд репо red-team-prd Команда red-team-prd находит предположения, которые убьют ваш план, и предлагает дешёвый тест для каждого. Вместо того чтобы узнать о провале на запуске, проверьте ставки на этой неделе. CX Codex +1 ★ 28 211звёзд репо generate-data Команда generate-data создаёт тестовые наборы данных в CSV, JSON или SQL через Python-скрипт с учётом связей и распределений. CX Codex +1 ★ 28 211звёзд репо value-proposition Команда value-proposition структурирует ценностное предложение по шаблону JTBD: кто нужен продукт, зачем, какие боли сейчас, как вы их решаете, что получится, почему вы лучше альтернатив. CX Codex +1 ★ 28 211звёзд репо test-scenarios Команда test-scenarios генерирует тестовые сценарии с граничными случаями и проверками ошибок по пользовательским историям или спецификациям фич. CX Codex +1 ★ 28 211звёзд репо meeting-notes Команда meeting-notes собирает расшифровку встречи или черновые записи в структурированный протокол с решениями, задачами и вопросами для продолжения. CX Codex +1 ★ 28 211звёзд репо review-resume Команда review-resume проверяет резюме product manager против лучших практик: метрики результатов, формула XYZ+S, PM-терминология, структура и ключевые слова. Даёт конкретные рекомендации с примерами переделки. CX Codex +1 ★ 28 211звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой