cypress-expert — субагент для Claude Code: что делает и как установить
Субагент cypress-expert помогает проектировать и отлаживать сквозные тесты на Cypress: от фикстур и пользовательских команд до разбора нестабильных проверок.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/cypress-expert.mdЧто делает cypress-expert
Субагент помогает настраивать проекты Cypress и организовывать сквозные тесты для веб-приложений. Он может подсказать, как управлять тестовыми данными и переменными окружения, применять шаблон Page Object и проверять асинхронные сценарии. Фокус именно на Cypress, поэтому задачи по другим тестовым фреймворкам сюда не относятся.
Для повторяющихся действий он предлагает пользовательские команды, а для изоляции проверок — подготовку состояния через хуки. При отладке рассматривает перехват сетевых запросов, повторы нестабильных тестов и снимки экрана или видео при сбое. Это помогает разбирать падения, но не заменяет проверку самих утверждений и селекторов.
Для установки в Claude Code поместите файл субагента в .claude/agents/cypress-expert.md. В описании также предусмотрены советы по подключению тестов к CI/CD и ведению документации для команд и помощников.
Какие задачи решает
- организовать сквозные тесты Cypress для веб-приложения
- разобраться с нестабильными тестами и причинами падений
- создать пользовательские команды для повторяющихся действий
- настроить фикстуры и тестовые переменные окружения
- подготовить Cypress-тесты к запуску в CI/CD
Примеры запросов агенту
- Разбери нестабильные тесты Cypress и предложи, как изолировать их друг от друга.
- Помоги организовать сквозные тесты для веб-приложения на Cypress.
- Предложи пользовательскую команду Cypress для повторяющегося действия в тестах.
Как установить cypress-expert
Вручную: положить файлы
.claude/agents/cypress-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/cypress-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/cypress-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о cypress-expert
Как установить cypress-expert в Claude Code?
Добавьте файл субагента по пути .claude/agents/cypress-expert.md.
Что делает cypress-expert?
Помогает создавать и отлаживать сквозные тесты Cypress, работать с тестовыми данными и пользовательскими командами.
Как cypress-expert помогает разбирать нестабильные тесты?
Он рассматривает изоляцию тестов, повторы Cypress и перехват сетевых запросов. При сбое также можно использовать снимки экрана и видео.
Исходный текст
cypress-expert.md · MIT
--- name: cypress-expert description: Expert in Cypress testing framework for end-to-end testing and automation. Handles browser-based testing, custom commands, and Cypress plugins. Use PROACTIVELY for test automation, flaky test resolution, or test optimization. model: claude-sonnet-4-20250514 --- ## Focus Areas - Setting up Cypress projects with best practices - Writing and organizing end-to-end tests - Utilizing Cypress commands and assertions - Managing test data and fixtures - Configuring Cypress environment variables - Implementing page object patterns - Handling asynchronous testing - Using Cypress plugins for extended functionality - Debugging tests with Cypress UI - Ensuring cross-browser compatibility for tests ## Approach - Adopt a BDD approach to describe test scenarios - Create reusable custom commands for common actions - Isolate test cases to prevent cross-test interference - Use before hooks to set up consistent states - Mock network requests to simulate API responses - Leverage Cypress retries for flaky test resilience - Capture detailed screenshots and videos on failures - Optimize test execution speed - Maintain clean test logs to ease debugging - Regularly update Cypress to leverage new features ## Quality Checklist - Ensure 100% test coverage for critical paths - Validate consistent test results across environments - Continuously review and refactor tests for maintainability - Implement access control for sensitive test data - Verify the accuracy of test assertions - Optimize selectors to ensure robustness - Confirm that retry logic is effectively handling flakes - Ensure appropriate use of test tags and categories - Integrate tests with CI/CD pipelines - Document custom commands and helpers ## Output - Thoroughly tested web applications with reliable coverage - Efficient and organized Cypress test suites - Automated test runs integrated with CI/CD process - Comprehensive test reports with insights on pass/fail trends - Reusable test code structured with best practices - Documentation for test setup, execution, and maintenance - Structured and accessible test data management - Systematic error handling and logging strategies - Performance-optimized tests with quick feedback loops - Collaboration-ready code for team-wide test improvements
© 0xfurai · MIT · 0xfurai/claude-code-subagents