ports-and-adapters — скилл для Claude Code
Скилл ports-and-adapters помогает внедрить гексагональную архитектуру в проектах на Symfony, отделяя чистую доменную логику от Doctrine и внешних библиотек.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a claude-codeЧто делает ports-and-adapters
Скилл выстраивает код Symfony по принципам Ports and Adapters, разделяя проект на слои Domain, Application и Infrastructure. Доменные сущности описываются на чистом PHP без аннотаций ORM, а порты объявляются в виде интерфейсов. Сценарии использования реализуются через команды и обработчики, зависящие только от этих портов.
Адаптеры, базы данных и HTTP-контроллеры выносятся в инфраструктурный слой, где сущности связываются через XML-маппинг. Зависимости направляются строго внутрь: ядро ничего не знает об окружении.
Для простого CRUD без бизнес-правил такой подход только раздует структуру. Тесты домена пишутся как обычные юнит-тесты без запуска ядра Symfony.
Какие задачи решает
- отделить бизнес-логику Symfony от Doctrine и сторонних SDK
- спроектировать порты репозиториев и адаптеры инфраструктуры
- изолировать доменные сущности с помощью XML-маппинга
- написать быстрые юнит-тесты без запуска ядра фреймворка
Примеры запросов агенту
- Раздели модуль заказов на слои Domain, Application и Infrastructure с портами для репозитория
- Создай use case оформления подписки через команду и обработчик без зависимостей от Doctrine
- Настрой XML-маппинг для доменной сущности клиента и подключи адаптер в сервисах
Как установить ports-and-adapters
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a claude-code2Вручную: положить файлы
~/.claude/skills/ports-and-adapters/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ports-and-adapters/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a codex2Вручную: положить файлы
.agents/skills/ports-and-adapters/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a cursor2Вручную: положить файлы
.cursor/skills/ports-and-adapters/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/ports-and-adapters2Вручную: положить файлы
.github/skills/ports-and-adapters/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/ports-and-adaptersВручную: положить файлы
.devin/skills/ports-and-adapters/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ports-and-adapters
Как установить ports-and-adapters в Claude Code?
Выполните команду npx skills add dev-toolings/superpowers-symfony --skill ports-and-adapters -a claude-code в терминале.
Зачем нужен скилл ports-and-adapters?
Он направляет агента при проектировании архитектуры в Symfony, запрещая импортировать фреймворк или ORM внутрь src/Domain/.
Как тестируется доменная логика при таком подходе?
Тесты домена пишутся как чистые юнит-тесты без загрузки ядра Symfony, а адаптеры проверяются интеграционными тестами.
Исходный текст
SKILL.md · MIT
--- name: ports-and-adapters description: Implement Hexagonal Architecture (Ports and Adapters) in Symfony; separate domain logic from infrastructure with clear boundaries capabilities: [read, search] tags: [architecture] # projected by `bun run build` — do not edit by hand allowed-tools: - Read - Glob - Grep --- # Ports And Adapters (Symfony) ## Use when - Domain rules must not depend on Doctrine, HTTP, or a vendor SDK. - An infrastructure dependency (storage, payment, mail provider) must be swappable or faked. - Structuring a bounded context into Domain, Application and Infrastructure layers. ## Default workflow 1. Model the domain in plain PHP: entities and value objects without ORM attributes. 2. Declare ports as interfaces inside the domain, such as a repository interface. 3. Write use cases in the application layer as commands and handlers that depend only on ports. 4. Implement adapters in infrastructure (Doctrine repository, API client) and map entities outside the domain, with XML mapping. 5. Bind each port to its adapter in the service configuration; controllers live in infrastructure. ## Guardrails - Nothing under `src/Domain/` imports Symfony, Doctrine or vendor SDK classes. - Dependencies point inward: infrastructure knows the domain, never the reverse. - Do not add the layers to a CRUD module with no business rules. - Test the domain with plain unit tests and the adapters with integration tests. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - The layer layout and the port interfaces. - The adapters and their service bindings. - Domain unit tests that boot no kernel. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony