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

value-objects-and-dtos — скилл для Claude Code

Скилл value-objects-and-dtos помогает проектировать неизменяемые Value Objects и DTO в Symfony: задаёт правила валидации, равенства и передачи данных между слоями.

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

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

Что делает value-objects-and-dtos

Скилл предлагает выбирать Value Object для доменного понятия со своими правилами, а DTO — для данных, пересекающих границу приложения. Он задаёт readonly-классы с проверкой в конструкторе, равенство Value Objects по значению и операции, возвращающие новые экземпляры. Изменения через сеттеры исключены.

Для Doctrine предусмотрены embeddables, а входные DTO с ограничениями валидации отделены от выходных с атрибутами сериализатора. Скилл также требует не отдавать сущности напрямую через API и хранить деньги целым числом в младших единицах, а не float. В результате агент должен подготовить DTO, их преобразование к сущностям и обратно, а также unit-тесты инвариантов. Для хранения денег здесь нужен целочисленный формат.

В Claude Code скилл можно установить через npx skills add dev-toolings/superpowers-symfony --skill value-objects-and-dtos -a claude-code; после установки файл расположен по пути ~/.claude/skills/value-objects-and-dtos/SKILL.md. Для подробностей реализации предусмотрена ссылка на reference.md.

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

  • выделить Value Object для доменного понятия с собственными правилами
  • передать данные запроса или API через DTO
  • проверить инварианты в конструкторе класса
  • хранить объект-значение внутри Doctrine-сущности
  • сопоставить входные и выходные DTO с сущностями

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

  • Спроектируй Value Object для адреса с проверкой правил в конструкторе и тестами инвариантов.
  • Раздели входные и выходные DTO для этого API и добавь преобразование к сущностям.
  • Подготовь Value Object для денег и храни сумму целым числом в младших единицах.

Как установить value-objects-and-dtos

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill value-objects-and-dtos -a claude-code

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

~/.claude/skills/value-objects-and-dtos/SKILL.md

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

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

Вопросы о value-objects-and-dtos

Как установить value-objects-and-dtos в Claude Code?

Выполните npx skills add dev-toolings/superpowers-symfony --skill value-objects-and-dtos -a claude-code. Файл скилла находится по пути ~/.claude/skills/value-objects-and-dtos/SKILL.md.

Что делает value-objects-and-dtos?

Помогает проектировать неизменяемые Value Objects и DTO для Symfony, задаёт правила валидации и разделения входных и выходных данных.

Как скилл предлагает хранить деньги?

Как целое число в младших единицах, не как float.

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

SKILL.md · MIT
---
name: value-objects-and-dtos
description: Design Value Objects for domain concepts and DTOs for data transfer with proper immutability (readonly) and validation
capabilities: [read, search]
tags: [architecture]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Value Objects And Dtos (Symfony)

## Use when
- A domain concept with rules of its own (money, email, address) travels as raw scalars.
- Data crosses a boundary: request input, API output, message payload.
- Storing a value object inside a Doctrine entity.

## Default workflow
1. Decide: a value object for a domain concept with invariants, a DTO for data crossing a boundary.
2. Make it `readonly`, validate in the constructor, and fail fast.
3. Give value objects equality by value and operations that return new instances.
4. Persist value objects as Doctrine embeddables.
5. Keep input DTOs (validation constraints) apart from output DTOs (serializer attributes).

## Guardrails
- No setters and no mutation: a change returns a new instance.
- DTOs carry data only, with no behavior.
- Never expose entities directly as API input or output.
- Store money as an integer in minor units, never as a float.

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

## Output contract
- Value objects with their invariants and equality.
- Input and output DTOs, and their mapping to and from entities.
- Unit tests for each invariant.

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
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звёзд репо clean-architecture Giuseppe Trisciuoglio Скилл clean-architecture раскладывает PHP-проект на слои Domain, Application, Adapter и Infrastructure и даёт шаблоны сущностей, value objects и портов без привязки к Symfony. CX Codex +1 ★ 372звёзд репо php-pro https://github.com/Jeffallan Скилл php-pro задаёт правила разработки на PHP 8.3+ для Laravel и Symfony: включает strict_types, анализ в PHPStan на уровне 9 и тесты PHPUnit или Pest. CX Codex +1 16 400установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок Pimcore Expert официальный github Субагент Pimcore Expert консультирует по архитектуре Pimcore 11+, настройке Symfony 6+ и PHP 8.2+. Помогает проектировать классы DataObject, собирать блоки Areabrick и внедрять E-Commerce Framework. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
symfony-voters Выносит проверки прав в Symfony Voters и позволяет проверять их отдельно от контроллеров. Он связывает правила доступа с логикой домена. CX Codex +1 ★ 234звёзд репо quality-checks Скилл quality-checks запускает PHP-CS-Fixer для стиля кода, PHPStan для статического анализа и проверки типов. Используй перед коммитом или когда CI падает на качество. CX Codex +1 ★ 234звёзд репо writing-plans Скилл writing-plans составляет пошаговые планы реализации фич в Symfony с критериями приёмки, оценкой рисков и зависимостями шагов. CX Codex +1 ★ 234звёзд репо effective-context Скилл effective-context учит агента собирать контекст для Symfony-разработки: версии, файлы на пути ошибки, стектрейсы и ограничения проекта. CX Codex +1 ★ 234звёзд репо strategy-pattern Скилл strategy-pattern для Claude Code внедряет паттерн «Стратегия» в приложениях на Symfony с помощью тегированных сервисов. Обрабатывает растущий список алгоритмов или провайдеров. CX Codex +1 ★ 234звёзд репо executing-plans Скилл executing-plans для Claude Code ведёт по утверждённому плану реализации — от проверки тестов до отдельных коммитов по каждому шагу. Продолжает многоэтапную работу после перерыва. CX Codex +1 ★ 234звёзд репо 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звёзд репо

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

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