✨ Cypress AI Toolkit

Открытые AI skills для Cypress, созданные командой Cypress. Работают с Claude, Cursor, GitHub Copilot и другими инструментами.

Ваш AI-инструмент умеет многое. Просто он не знает Cypress так, как знаете его вы. Этот набор инструментов решает эту проблему с помощью skills, контекста и рекомендаций, созданных командой, которая разработала Cypress.

Cypress также предоставляет AI-возможности в приложении и Cypress Cloud — например, cy.prompt(), Studio AI, Cloud MCP, Test Intent and Error Summaries и генерацию тестов UI Coverage. Подробнее см. в документации Cypress AI.

Какую задачу это решает

AI-инструменты умеют работать с Cypress. Трудность в том, чтобы применять его последовательно и правильно.

Без рекомендаций AI-инструменты скатываются к универсальным шаблонам: недостаточно используют Cypress API, неправильно применяют селекторы, пропускают лучшие практики, которые опытные разработчики Cypress усваивают со временем. В итоге получается код, который технически запускается, но на который нельзя положиться.

Cypress AI Toolkit даёт вашим AI-инструментам специфичный для Cypress контекст, необходимый для получения результата, на который действительно можно опереться — стабильно, во всей команде и во всех рабочих процессах.

Что входит в набор инструментов

Model Context Protocol (MCP)

MCP-сервер Cypress Cloud подключает ваших AI-ассистентов по программированию напрямую к Cypress Cloud, предоставляя им доступ к данным о состоянии и стабильности вашего приложения.

Подробнее о Cypress Cloud MCP читайте здесь.

Используйте штатный установщик для вашего агента, если он доступен:

Инструмент	Когда использовать
Cypress Claude Connector	Для пользователей приложения Claude Desktop
Cypress Cursor Plugin	Для пользователей Cursor
Cypress VS Code Extension (`Cypress-io.vscode-cypress-cloud-mcp`)	Для пользователей VS Code и GitHub Copilot

Примечание: По умолчанию MCP-подключение использует OAuth. Если вы предпочитаете использовать Personal Access Token (PAT), потребуется скорректировать файл .mcp.json для вашего агента.

Skills

Skills — это наборы инструкций, которые загружает ваш AI-инструмент, чтобы применять знания о Cypress при генерации или проверке тестового кода. Они заполняют разрыв между тем, что AI усвоил во время обучения, и тем, как на самом деле выглядят современные, хорошо написанные тесты Cypress.

Сейчас доступны пять skills:

cypress-author — улучшает то, как AI-инструменты создают, обновляют и исправляют тесты Cypress. Используйте, когда пишете новые тесты или исправляете сломанные.
cypress-explain — помогает понять, описать и критически оценить существующие тесты. Используйте при аудите набора тестов, адаптации нового члена команды или при разборе нестабильного теста перед его переписыванием.
cypress-docs — помогает вашему агенту эффективнее и надёжнее искать и получать информацию о Cypress.
cypress-tap — управляет запущенной сессией Cypress в open mode: запускает specs, анализирует результаты, диагностирует сбои и запрашивает данные о тестируемом приложении без взаимодействия с GUI.
cypress-cloud-cli — исследует запуски, тесты, сбои, снимки экрана и данные Test Replay в Cypress Cloud через CLI Cypress Cloud.

Skills работают с любым AI-инструментом, который принимает пользовательские инструкции, включая Claude, Cursor и GitHub Copilot.

Смотрите документацию по skills с инструкциями по установке, примерами запросов и описанием решения проблем.

Что готовится

Мы работаем над более широким набором инструментов.

Сообщество поможет определить приоритеты. Если вы уже внедряете AI-подходы в работу с Cypress, расскажите нам об этом. Откройте issue или отправьте PR.

Начало работы

Плагин

Cypress AI Toolkit публикуется как плагин для установки в вашего агента. Это самый простой способ установить и настроить различные возможности этого пакета; он также обеспечивает автообновление.

Примечание: наше размещение в официальном маркетплейсе плагинов Cursor пока находится на рассмотрении. Этот README будет обновлён, как только оно станет доступно. До тех пор репозиторий можно клонировать и установить как локальный плагин в выбранном агенте.

Claude

Плагин опубликован в маркетплейсе Claude Community Plugins — смотрите инструкции здесь по настройке вашего экземпляра Claude для использования этого маркетплейса. После настройки маркетплейса найдите плагин cypress.

Ручная установка

Если вы используете другого агента или предпочитаете выбирать отдельные части, вы можете взять из этого репозитория только то, что нужно.

Установите skills с помощью инструментов командной строки
Пакет skills:

npx skills add cypress-io/ai-toolkit

GitHub CLI:

gh skill install cypress-io/ai-toolkit

Обращайтесь к вашему AI-инструменту как обычно. Skills будут активироваться автоматически, когда это уместно, либо вызывайте нужный напрямую с помощью слэш-команды (например, /cypress-author).

Для ручной установки, примеров запросов и другого смотрите документацию по skills или документацию Cypress AI Skills.

Подключите Cypress Cloud MCP с помощью установщика для вашего агента (см. таблицу MCP выше). Также можно скопировать конфигурацию из mcp/ или следовать инструкциям по настройке.

Для кого это

Этот набор инструментов предназначен для разработчиков Cypress, которые используют AI-инструменты для программирования и хотят получать стабильный, надёжный результат — а не просто работающий код.

Он подойдёт вам, если вы хотите, чтобы ваш AI-инструмент:

Следовал соглашениям и лучшим практикам Cypress без постоянных напоминаний
Создавал рабочие процессы, которые можно повторять и развивать, а не разовые решения
Вёл себя одинаково стабильно во всей команде, независимо от того, кто формулирует запрос

Для использования не нужно быть экспертом в AI. Нужен только Cypress и AI-инструмент для программирования.

Участие в разработке

Мы приветствуем вклад любого рода: новые skills, улучшения существующих, сообщения об ошибках и идеи.

Если вы создали что-то, что делает AI-инструменты умнее в вопросах Cypress, здесь самое место, чтобы этим поделиться.

Прочитайте руководство по участию, чтобы начать.

Релизы

Проверки в PR

Любое изменение skill должно сопровождаться соответствующим обновлением semver в поле version frontmatter-блока файла SKILL.md.

Изменения любого функционального содержимого набора инструментов (skills и mcp, но, например, не документации) должны обновлять метаданные version в .cursor-plugin и .claude-plugin, чтобы маркетплейсы плагинов могли увидеть их и обновиться соответствующим образом.

Действия после PR

После слияния обновления с изменениями skills выполните gh skill publish из ветки main. Предварительно просмотрите изменения с помощью --dry-run. Версия должна соответствовать версии плагина, указанной выше — скорее всего, она не будет совпадать с версией отдельных skills, но её следует рассматривать как "версию пакета".

Лицензия

MIT