functional-tests — скилл для Claude Code: что делает и как установить
Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/functional-tests/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/functional-tests/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a codex2Вручную: положить файлы
.agents/skills/functional-tests/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a cursor2Вручную: положить файлы
.cursor/skills/functional-tests/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/functional-tests2Вручную: положить файлы
.github/skills/functional-tests/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill functional-tests -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/functional-testsВручную: положить файлы
.devin/skills/functional-tests/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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