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

postgres_syntax — скилл для Claude Code: SQL и установка

Скилл postgres_syntax сверяет SQL и DDL с грамматикой PostgreSQL. Пригодится при генерации схем, проверке синтаксиса и разборе спорных конструкций.

Apache-2.0 1 установок ★ 1 089 обновлён 2026-10-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pgplex/pgschema --skill postgres_syntax -a claude-code
Открыть на GitHub

Что делает postgres_syntax

Скилл использует грамматику PostgreSQL, чтобы разбирать структуру SQL и DDL. Он помогает понять правила для таблиц, индексов, триггеров, функций, представлений, последовательностей, типов и политик. Отдельно рассматривает сгенерированные и identity-колонки, выражения в индексах, constraint triggers и порядок операторов.

В качестве локальных источников используются internal/gram.y и internal/scan.l. По грамматике можно искать правила через grep, например для CreateTrigStmt или TriggerWhen. При генерации DDL скилл советует соблюдать порядок ключевых слов, правильно заключать идентификаторы в кавычки через ir/quote.go и проверять результат интеграционными тестами с реальным PostgreSQL.

Грамматика меняется между PostgreSQL 14–18: среди различий указаны COMPRESSION, UNIQUE NULLS NOT DISTINCT, SQL/JSON-функции и изменения MERGE. Для проверки сгенерированного DDL нужен реальный PostgreSQL.

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

  • проверить синтаксис сгенерированного DDL
  • найти правило PostgreSQL для конкретного оператора
  • разобрать структуру CREATE TRIGGER
  • отличить колонку, функцию и выражение в индексе
  • учесть различия PostgreSQL 14–18

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

  • Проверь синтаксис DDL для новой таблицы и сверь его с грамматикой PostgreSQL.
  • Разбери в internal/gram.y, как устроен CREATE TRIGGER с условием WHEN.
  • Проверь, правильно ли сформирован индекс на выражении lower(email).

Как установить postgres_syntax

1Через Skills CLI (Vercel)

npx skills add pgplex/pgschema --skill postgres_syntax -a claude-code

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

~/.claude/skills/postgres_syntax/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/postgres_syntax/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о postgres_syntax

Как установить postgres_syntax в Claude Code?

Выполните npx skills add pgplex/pgschema --skill postgres_syntax -a claude-code, затем проверьте файл ~/.claude/skills/postgres_syntax/SKILL.md.

Что делает postgres_syntax?

Скилл обращается к грамматике PostgreSQL, чтобы объяснить структуру SQL и DDL. Он помогает разбирать правила для таблиц, индексов, триггеров и других конструкций.

Какие файлы использует postgres_syntax?

Предпочтительные локальные источники — internal/gram.y, где описан синтаксис SQL, и internal/scan.l, отвечающий за разбор токенов. Для проверки результата также нужны интеграционные тесты с реальным PostgreSQL.

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

SKILL.md · Apache-2.0
---
name: postgres_syntax
description: Consult PostgreSQL's parser and grammar (gram.y) to understand SQL syntax, DDL statement structure, and parsing rules when implementing pgschema features. Use this skill when generating DDL in internal/diff/*.go, validating SQL syntax, understanding keyword precedence, or learning how PostgreSQL handles specific constructs like triggers, indexes, generated columns, or constraint triggers.
---

# PostgreSQL Syntax Reference

Reference PostgreSQL's grammar to understand SQL syntax and generate correct DDL.

## Source Files

**Local copies** (preferred):
- `internal/gram.y` - Yacc/Bison grammar defining all PostgreSQL SQL syntax
- `internal/scan.l` - Flex lexer for tokenization

**Searching the grammar**:
```bash
grep -n "CreateTrigStmt:" internal/gram.y     # Find statement rule
grep -A 10 "TriggerWhen:" internal/gram.y     # Understand an option
```

## Statement Types → Grammar Rules

| Statement | Grammar Rule | Key Sub-rules |
|-----------|-------------|---------------|
| CREATE TABLE | `CreateStmt` | `columnDef`, `TableConstraint`, `TableLikeClause` |
| ALTER TABLE | `AlterTableStmt` | `alter_table_cmd` |
| CREATE INDEX | `IndexStmt` | `index_elem` (column, function, expression) |
| CREATE TRIGGER | `CreateTrigStmt` | `TriggerActionTime`, `TriggerEvents`, `TriggerWhen` |
| CREATE FUNCTION | `CreateFunctionStmt` | `func_args`, `createfunc_opt_list` |
| CREATE VIEW | `ViewStmt` | `SelectStmt` |
| CREATE SEQUENCE | `CreateSeqStmt` | `OptSeqOptList` |
| CREATE TYPE | `CreateEnumStmt`, `CompositeTypeStmt`, `CreateDomainStmt` | |
| CREATE POLICY | `CreatePolicyStmt` | `row_security_cmd` |

## Grammar Syntax Guide

gram.y uses Yacc/Bison notation:
- **UPPERCASE**: Terminal tokens (keywords like `CREATE`, `TRIGGER`)
- **lowercase**: Non-terminal rules (references to other grammar rules)
- **`|`**: Alternative syntax options
- **`opt_*`**: Optional elements (can be empty)
- **`*_list`**: Recursive list constructs

Example:
```yacc
CreateTrigStmt:
    CREATE opt_or_replace TRIGGER name TriggerActionTime TriggerEvents ON
    qualified_name TriggerReferencing TriggerForSpec TriggerWhen
    EXECUTE FUNCTION_or_PROCEDURE func_name '(' TriggerFuncArgs ')'
```

## Key Constructs for pgschema

### Column Definitions
- Regular: `column_name type [constraints]`
- Generated: `column_name type GENERATED ALWAYS AS (expr) STORED`
- Identity: `column_name type GENERATED {ALWAYS|BY DEFAULT} AS IDENTITY`

### Index Elements
Three forms — note extra parens for arbitrary expressions:
1. Column: `CREATE INDEX idx ON t (col)`
2. Function: `CREATE INDEX idx ON t (lower(col))`
3. Expression: `CREATE INDEX idx ON t ((col + 1))`

### Trigger WHEN Clause
```yacc
TriggerWhen:
    WHEN '(' a_expr ')'
    | /* EMPTY */
```

### Constraint Triggers
```yacc
CREATE opt_or_replace CONSTRAINT TRIGGER name ...
    -- Can be DEFERRABLE / NOT DEFERRABLE
    -- Can be INITIALLY DEFERRED / INITIALLY IMMEDIATE
```

### Table LIKE Clause
```yacc
LIKE qualified_name [INCLUDING|EXCLUDING] {COMMENTS|CONSTRAINTS|DEFAULTS|IDENTITY|GENERATED|INDEXES|STATISTICS|STORAGE|ALL}
```

## Operator Precedence (from gram.y top)

```
%left OR
%left AND
%right NOT
%nonassoc IS ISNULL NOTNULL
%nonassoc '<' '>' '=' LESS_EQUALS GREATER_EQUALS NOT_EQUALS
```

## Keywords

- **Reserved**: Cannot be identifiers without quoting (`SELECT`, `TABLE`, `CREATE`)
- **Unreserved**: Can be used as identifiers (`ABORT`, `ACCESS`, `ACTION`)

When generating DDL, quote identifiers that match reserved keywords.

## Version Differences (14-18)

- PG 14: `COMPRESSION` clause for tables
- PG 15: `UNIQUE NULLS NOT DISTINCT`
- PG 16: SQL/JSON functions
- PG 17: `MERGE` enhancements

Check gram.y git history to see when features were added. Add version detection in pgschema if needed.

## Applying to pgschema

When generating DDL in `internal/diff/*.go`:
- Follow gram.y syntax exactly for keyword ordering
- Include all required elements
- Quote identifiers correctly via `ir/quote.go`
- Test generated DDL against real PostgreSQL via integration tests

© pgplex · Apache-2.0 · pgplex/pgschema

Похожие скиллы

Все скиллы по теме «Данные и базы» →
postgres-query civitai Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev. CX Codex +1 105установок neon-postgres neondatabase Скилл neon-postgres для Claude Code помогает работать с базой Neon: подключениями, схемой и ветками. Агент подключает его при запросах к существующей базе, SQL или поиску. CX Codex +1 315 000установок neon-postgres-egress-optimizer neondatabase Скилл neon-postgres-egress-optimizer находит запросы Postgres, которые передают в приложение лишние данные, и предлагает исправления для снижения сетевого трафика. CX Codex +1 35 100установок postgres-patterns affaan-m Скилл postgres-patterns для Claude Code собирает практики PostgreSQL для проектирования схем и настройки запросов: индексы, типы данных, RLS и диагностика медленных запросов. CX Codex +1 7 200установок postgres tigerdata Скилл для PostgreSQL на Claude Code: проектирование таблиц, индексы, pgvector, PostGIS, TimescaleDB и миграции. Агент подгружает справочники по задаче — от чтения схем до векторного поиска и безопасных миграций. CX Codex +1 1 500установок design-postgres-tables tigerdata Скилл design-postgres-tables для Claude Code проектирует таблицы PostgreSQL: типы данных, индексы, ограничения, JSONB и партиционирование. Включается при создании или изменении схемы. CX Codex +1 680установок

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

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

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