# planetscale-best-practices-matrix

Скилл сопоставляет находки по базе с рекомендациями PlanetScale и говорит, что применимо для Vitess, а что для Postgres.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1800 установок · ★ 136
- Автор: planetscale
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/planetscale/skills/tree/HEAD/planetscale-best-practices-matrix/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/planetscale-best-practices-matrix

## Что делает

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

Внутри — разбор по темам: Query Insights, вебхуки, MCP и агенты, SQLCommenter и теги запросов, работа с рекомендациями по схеме. Для Vitess это безопасные миграции, deploy requests, дисциплина force cutover, одобрение админом, gated deployments, откат схемы, стратегия веток и обзор шардирования. Для Postgres — пользовательские роли, `pg_strict`, Traffic Control, бэкапы и PITR, PgBouncer, приватная сеть и IP-ограничения, расширения, живые соединения через `pscale branch connections top`.

На выходе агент помечает каждый пункт матрицы: применимо, текущее состояние, пробел, ценность с измеренной находкой, ID рекомендации и требование одобрения. Завершает он фразой, что изменения не применялись. Если роли управляются через Terraform и пароли не должны попадать в state, скилл советует `planetscale_postgres_redacted_branch_role` плюс отдельный сброс пароля и хранение в секрет-менеджере. В организации с одним админом одобрение само по себе не защита: тот же админ может открыть и одобрить один и тот же deploy request, поэтому нужна отдельная идентичность агента или сервисный токен без права одобрять.

## Требования
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-best-practices-matrix -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/planetscale-best-practices-matrix/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/planetscale-best-practices-matrix/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-best-practices-matrix -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/planetscale-best-practices-matrix/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-best-practices-matrix -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/planetscale-best-practices-matrix/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install planetscale/skills planetscale-best-practices-matrix
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/planetscale-best-practices-matrix/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-best-practices-matrix -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/planetscale/skills --path planetscale-best-practices-matrix
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/planetscale-best-practices-matrix/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-best-practices-matrix -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/planetscale/skills/tree/HEAD/planetscale-best-practices-matrix/SKILL.md

## Когда брать
- сопоставить находки по базе с рекомендациями PlanetScale по движку
- не пропустить поверхности безопасности и наблюдаемости при оценке
- разложить рекомендации по Vitess и Postgres отдельно
- зафиксировать пробелы с измеренным влиянием, а не общими рисками
- отметить, где нужно одобрение перед изменением базы

## Примеры запросов агенту
- пройди по матрице planetscale-best-practices-matrix и отметь, что применимо к нашей Postgres-базе
- оцени нашу Vitess-базу по planetscale-best-practices-matrix и выпиши пробелы
- собери отчёт по planetscale-best-practices-matrix с ID рекомендаций и требованиями одобрения

## Похожие
- [neki](https://affpapa.org/nevibecode/skills/neki.md) — скилл · 1600 установок
- [vitess](https://affpapa.org/nevibecode/skills/vitess.md) — скилл · 1600 установок
- [neon-postgres](https://affpapa.org/nevibecode/skills/neondatabase-neon-postgres.md) — скилл · 281100 установок
- [postgres-pro](https://affpapa.org/nevibecode/agents/postgres-pro.md) — субагент · 897 установок
- [neon-postgres-branches](https://affpapa.org/nevibecode/skills/neon-postgres-branches.md) — скилл · 31200 установок
- [creating-amazon-aurora-db-cluster-with-instances](https://affpapa.org/nevibecode/skills/creating-amazon-aurora-db-cluster-with-instances.md) — скилл · 6000 установок

Из того же набора: [planetscale/skills](https://affpapa.org/nevibecode/by/planetscale/skills.md) — 14 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md