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

ports-and-adapters — скилл для Claude Code

Скилл ports-and-adapters помогает внедрить гексагональную архитектуру в проектах на Symfony, отделяя чистую доменную логику от Doctrine и внешних библиотек.

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

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

Что делает 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-code

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

~/.claude/skills/ports-and-adapters/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и API» →
clean-architecture Giuseppe Trisciuoglio Скилл clean-architecture раскладывает PHP-проект на слои Domain, Application, Adapter и Infrastructure и даёт шаблоны сущностей, value objects и портов без привязки к Symfony. CX Codex +1 ★ 372звёзд репо php-software-architect-expert Giuseppe Trisciuoglio php-software-architect-expert — субагент для Claude Code, который разбирает архитектуру PHP-проектов. Его подключают для проверки Clean Architecture, DDD и решений по структуре кода. CX Codex ★ 372звёзд репо audit-ports-adapters Quintin Henry (https://github.com/qdhenry/) Команда audit-ports-adapters проверяет, как Rust-код использует порты и адаптеры: где объявлены трейты, есть ли их реализации и зависят ли сценарии от абстракций. CX Codex +1 ★ 1 357звёзд репо architecture-patterns Seth Hobson Скилл architecture-patterns помогает спроектировать слои backend-сервиса и разделить бизнес-логику с инфраструктурой. Пригодится при создании микросервиса, рефакторинге монолита и поиске циклических зависимостей. CX Codex +1 24 144установок php-pro https://github.com/Jeffallan Скилл php-pro задаёт правила разработки на PHP 8.3+ для Laravel и Symfony: включает strict_types, анализ в PHPStan на уровне 9 и тесты PHPUnit или Pest. CX Codex +1 16 400установок sentry-php-sdk getsentry Скилл sentry-php-sdk помогает настроить мониторинг Sentry в проектах на чистом PHP, Laravel или Symfony. Распознаёт фреймворк, очереди и планировщики, после чего предлагает нужные пакеты и конфигурацию. CX Codex +1 2 400установок

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

Весь набор →
twig-components Собирает переиспользуемые компоненты на Symfony UX Twig Components: props, слоты, анонимные шаблоны и CVA-варианты. Использует один и тот же фрагмент Twig на разных страницах. CX Codex +1 ★ 234звёзд репо cqrs-and-handlers Скилл cqrs-and-handlers помогает внедрить CQRS в Symfony через Symfony Messenger с разделением шин команд и запросов. CX Codex +1 ★ 234звёзд репо daily-workflow Скилл daily-workflow для Claude Code и Codex задаёт порядок повседневной работы с Symfony — от запуска проекта до проверки изменений перед коммитом. Охватывает миграции, отладку и рутинные задачи. CX Codex +1 ★ 234звёзд репо bootstrap-check Скилл bootstrap-check проверяет конфигурацию Symfony-проекта перед работой: .env, сервисы, Doctrine, роуты. Показывает, что сломано, и чем это чинить. CX Codex +1 ★ 234звёзд репо config-env-parameters Скилл config-env-parameters для Claude Code помогает менять переменные окружения, параметры и секреты Symfony с учётом разных сред. Задаёт значения и внедряет их в приложение. CX Codex +1 ★ 234звёзд репо doctrine-fixtures-foundry Скилл doctrine-fixtures-foundry для Claude Code учит создавать тестовые данные Doctrine через фабрики Zenstruck Foundry v2: состояния, последовательности и связи. Срабатывает при написании фикстур и миграции фабрик с Foundry v1. CX Codex +1 ★ 234звёзд репо doctrine-transactions Скилл doctrine-transactions настраивает транзакции в Doctrine ORM 3, блокировки и границы сброса изменений в Symfony. Пригодится при параллельной правке строк и сбоях flush. CX Codex +1 ★ 234звёзд репо doctrine-batch-processing Скилл doctrine-batch-processing для Claude Code обрабатывает большие наборы данных через Doctrine без загрузки всех сущностей в память. Выполняет импорт, экспорт и массовые изменения. CX Codex +1 ★ 234звёзд репо

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

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