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

functional-tests — скилл для Claude Code: что делает и как установить

Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback.

MIT ★ 234 обновлён 2026-10-05

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

Что делает functional-tests

Скилл задаёт чёткий регламент тестирования Symfony-приложений без лишних моков. Для тестирования эндпоинтов запускается WebTestCase с прямым вызовом static::createClient(), закрытые сервисы читаются через static::getContainer(), а авторизация пользователя оформляется через $client->loginUser($user) вместо заполнения формы входа. Тесты сервисов с доступом к реальной базе ведутся через KernelTestCase.

Изоляция данных опирается на PHPUnit-расширение пакета DAMADoctrineTestBundle и сброс фикстур через Foundry. Скилл прямо запрещает мокать EntityManager или репозитории в тестах, затрагивающих данные: проверяется реальное состояние базы.

Файл .env.local в тестовом окружении не читается, поэтому переменные окружения нужно определять в .env.test или .env.test.local. При проверке невалидных форм скилл ожидает статус 422 через assertResponseIsUnprocessable(), а проверка assertSessionHasFlashMessage() требует версию Symfony 8.1+.

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

  • покрыть функциональными тестами HTTP-контроллеры через WebTestCase
  • протестировать доступ к закрытым роутам с помощью loginUser
  • настроить изоляцию базы данных через DAMADoctrineTestBundle
  • составить быстрые smoke-тесты для ключевых маршрутов с data provider

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

  • Напиши функциональный тест для контроллера оформления заказа с проверкой редиректа и отправки письма
  • Проверь через WebTestCase и loginUser роут личного кабинета под ролью ROLE_ADMIN
  • Составь smoke-тесты со списком публичных URL для проверки успешных ответов

Как установить functional-tests

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a claude-code

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

~/.claude/skills/functional-tests/SKILL.md

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

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

Вопросы о functional-tests

Как установить functional-tests в Claude Code?

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a claude-code.

Что делает скилл functional-tests?

Он направляет Claude Code при генерации тестов для Symfony, выбирая нужный базовый класс (WebTestCase или KernelTestCase), настраивая изоляцию БД и проверяя DOM, редиректы и статусы ответов.

Почему скилл запрещает мокать репозитории и EntityManager?

По правилам скилла тесты, работающие с данными, обязаны использовать настоящую базу данных и настоящие репозитории, а изоляцию транзакций обеспечивает DAMA Doctrine Test Bundle.

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

SKILL.md · MIT
---
name: functional-tests
description: Write functional tests for Symfony controllers and HTTP endpoints using WebTestCase, getContainer, loginUser, and DAMA rollback
capabilities: [read, search, edit, shell]
tags: [testing]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Functional Tests (Symfony)

## Use when
- A controller or HTTP endpoint must be checked through the kernel: status, redirect, rendered DOM, form errors, emails.
- A repository or service must be tested against the real database with `KernelTestCase`.
- An authenticated or role-restricted route needs coverage via `loginUser()`.
- Key URLs need cheap smoke tests.

## Default workflow
1. Choose the base class: `WebTestCase` for HTTP, `KernelTestCase` for services, plain `TestCase` for pure logic.
2. Call `static::createClient()` directly (never `bootKernel()` first) and read private services with `static::getContainer()`.
3. Authenticate with `$client->loginUser($user)` instead of replaying the login form.
4. Assert the response and the DOM: `assertResponseIsSuccessful()`, `assertResponseRedirects()`, `assertSelectorTextContains()`, `assertEmailCount()`.
5. Isolate tests with the DAMADoctrineTestBundle `PHPUnitExtension`, plus Foundry reset for fixtures.
6. Add smoke tests with a data provider and hardcoded URLs.

## Guardrails
- Use the real database and real repositories; do not mock the EntityManager or repositories in data-touching tests.
- Invalid form submissions assert 422 with `assertResponseIsUnprocessable()` (Symfony 8.0+ behavior).
- `.env.local` is not loaded in the test environment: use `.env.test` or `.env.test.local`.
- `assertSessionHasFlashMessage()` requires Symfony 8.1+.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- Test classes with the base class chosen for each.
- The authentication and database isolation strategy.
- Status codes, DOM assertions and smoke URLs covered.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все скиллы по теме «Тесты и QA» →
ns-backend-tests nextstage-brasil Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо laravel-testing Laravel Community Скилл laravel-testing учит ассистента писать тесты для Laravel 13 на Pest 4 или PHPUnit 12 с учётом фабрик моделей и моков сервисов. CX Codex +1 1 000установок php-mcp-server-generator официальный github Скилл php-mcp-server-generator для GitHub Copilot генерирует PHP-проект MCP-сервера с инструментами, ресурсами, промптами и тестами. Собирает основу сервера под свои задачи. CX Codex +1 8 900установок

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

Весь набор →
api-platform-serialization Скилл api-platform-serialization настраивает сериализацию API Platform: группы полей на операцию, IRI вместо вложенных объектов, вычисляемые свойства и опции нормализаторов. CX Codex +1 ★ 234звёзд репо symfony-scheduler Настраивает периодические задачи через Symfony Scheduler без системного cron. Запускает генерацию отчётов, очистку данных и синхронизации через Symfony Messenger. CX Codex +1 ★ 234звёзд репо tdd-with-pest Скилл tdd-with-pest для Claude Code ведёт разработку в Symfony через RED-GREEN-REFACTOR с Pest v4. Создаёт тесты, воспроизводит баги и переносит PHPUnit-тесты на синтаксис Pest. CX Codex +1 ★ 234звёзд репо api-platform-versioning Скилл api-platform-versioning помогает менять API на API Platform без ломающих релизов: сначала депрекация с датой sunset, параллельные версии — в крайнем случае. CX Codex +1 ★ 234звёзд репо doctrine-migrations Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения. CX Codex +1 ★ 234звёзд репо symfony-messenger Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора. CX Codex +1 ★ 234звёзд репо api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо

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

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