planetscale цикл агента рекомендаций по схеме
Safely triage PlanetScale schema recommendations and turn them into reviewed branches, migrations, issues, or pull requests without applying production changes.
AIplanetscale
official
Разработка
Что делает навык
Агент обрабатывает рекомендации по схеме PlanetScale, превращая их в безопасные планы реализации, задачи, ветки, миграции или pull request без применения изменений в production. Он анализирует тип рекомендации, затрагиваемые объекты и код приложения, чтобы предложить проверенный путь внедрения.
Когда применять
- Автоматическая триаж-обработка открытых рекомендаций по схеме (schema recommendations) из Insights.
- Генерация безопасных путей внедрения изменений для баз данных Vitess или Postgres.
- Корреляция рекомендаций с кодовой базой приложения (ORM, миграции, контроллеры).
- Создание pull request или issue с предложением миграции до получения одобрения.
Как работает
- Собрать входные данные: тип рекомендации, затронутые таблицы/ключевые пространства, предложенный DDL, доказательства из Insights и целевую ветку.
- Ответить на вопросы триажа: актуальность, паттерны запросов, пути кода, возможность тестирования на непродовой ветке и наличие плана отката.
- Выполнить корреляцию с кодовой базой: поиск определений моделей ORM, миграций и источников запросов.
- Применить проверки безопасности: заблокировать прямое применение, если рекомендация устарела, избыточна или нет плана тестирования.
- Выбрать путь реализации: для Vitess — создание ветки и deploy request; для Postgres — конвертация DDL в миграции приложения.
- Сформировать вывод с ID, типом, планом валидации, отката и требованием одобрения, завершив фразой «No schema recommendations have been applied.».
Примеры запросов агенту
Проанализируй открытые рекомендации по схеме для таблицы users и предложи безопасный путь внедрения.
Создай pull request для миграции, основанной на рекомендации PlanetScale о добавлении индекса, используя ветку development.
Оцени влияние рекомендации по удалению неиспользуемой таблицы на записи и предложи план отката.
Что понадобится
- Доступ к репозиторию приложения и системе миграций.
- Доступ к PlanetScale Insights для получения доказательств и паттернов запросов.
- Определенный движок: Vitess или Postgres.
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «planetscale-schema-recommendations-agent-loop» из репозитория:
# https://github.com/planetscale/skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r planetscale-schema-recommendations-agent-loop/ ~/.claude/skills/planetscale-schema-recommendations-agent-loop/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.