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

api-platform-serialization — скилл для Claude Code

Скилл api-platform-serialization настраивает сериализацию API Platform: группы полей на операцию, IRI вместо вложенных объектов, вычисляемые свойства и опции нормализаторов.

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

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

Что делает api-platform-serialization

Скилл показывает агенту, как управлять составом полей в ответах API Platform. Он учит назначать normalizationContext и denormalizationContext отдельно для списка, чтения, создания и обновления, помечать свойства атрибутом #[Groups] и форсировать IRI вместо вложенных объектов через readableLink: false и writableLink: false. Для вычисляемых полей скилл предлагает кастомные нормализаторы, для динамических групп — декоратор api_platform.serializer.context_builder, для предотвращения циклов — #[MaxDepth] с enable_max_depth.

Скилл различает атрибуты Symfony Serializer (Attribute) и старые аннотации (Annotation): агент будет использовать первые. Он напоминает, что связанная сущность встраивается, только если у неё есть общая группа с родителем; без неё она рендерится как IRI. Секретные поля агент скроет атрибутом #[Ignore], а пароль добавит только в группу создания.

Выход работы — матрица полей по операциям, зарегистрированные нормализаторы и контекст-билдеры, тесты или OpenAPI с результирующим набором полей.

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

  • Выставить разные поля для списка, чтения и записи ресурса API Platform
  • Заменить вложенные объекты на IRI в ответе
  • Добавить вычисляемое или зависящее от роли поле
  • Задать формат даты или другие опции нормализатора для свойства
  • Предотвратить циклы сериализации в связанных сущностях

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

  • Настрой группы сериализации: список товаров должен возвращать id, name и price, а запрос на создание принимать name, price и categoryId, но не id
  • Замени вложенный объект category на IRI в ответе GET /products
  • Добавь вычисляемое поле discountedPrice в ответ для операции чтения

Как установить api-platform-serialization

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a claude-code

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

~/.claude/skills/api-platform-serialization/SKILL.md

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

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

Вопросы об api-platform-serialization

Как установить api-platform-serialization в Claude Code?

Выполни npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a claude-code, скилл будет доступен в ~/.claude/skills/api-platform-serialization/SKILL.md.

Что делает скилл api-platform-serialization?

Он учит агента управлять составом полей в API Platform: назначать группы на операцию, форсировать IRI для связей, добавлять вычисляемые поля через нормализаторы и предотвращать циклы.

Как заменить вложенный объект на IRI?

Примени #[ApiProperty(readableLink: false, writableLink: false)] к свойству-связи. Вложенный объект появится, только если у связанной сущности есть общая группа с родителем.

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

SKILL.md · MIT
---
name: api-platform-serialization
description: "Control API Platform serialization with groups, #[Context], IRI links (readableLink/writableLink), and custom context builders"
capabilities: [read, search, edit, shell]
tags: [api-platform]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Api Platform Serialization (Symfony)

## Use when
- Operations must expose different fields (list, read, create, update).
- A related resource must render as an IRI or be embedded.
- A response needs computed or role-dependent fields.
- A property needs normalizer options such as a date format.

## Default workflow
1. Name groups `entity:operation` and set `normalizationContext` and `denormalizationContext` per operation.
2. Tag properties with `#[Groups]` from the Serializer `Attribute` namespace, not the old `Annotation` one.
3. Control relations with `#[ApiProperty(readableLink: false, writableLink: false)]` to force IRIs.
4. Apply per-property options with `#[Context]` instead of writing a normalizer.
5. Add computed fields in a custom normalizer, and dynamic groups in a decorator of `api_platform.serializer.context_builder`.
6. Prevent cycles with `#[MaxDepth]` and `enable_max_depth`, and hide secrets with `#[Ignore]`.

## Guardrails
- Use separate read and write groups: for example `password` only in the create group, `id` only in read groups.
- A related resource is embedded only when it shares a group with the parent; otherwise it renders as an IRI.
- `#[MaxDepth]` has no effect unless `enable_max_depth` is true in the context.
- Keep entities clean: computed fields belong in normalizers.

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

## Output contract
- The groups and contexts per operation, as a field matrix.
- Normalizers or context builders added, and how they are registered.
- Tests or OpenAPI output showing the resulting fields.

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
serialization Aaronontheweb Скилл serialization помогает агенту выбрать формат сериализации для .NET: схему вместо рефлексии, System.Text.Json с генераторами для JSON. Пригодится при проектировании API, обмена сообщениями и хранения событий. CX Codex +1 608установок flutter-implement-json-serialization flutter Скилл flutter-implement-json-serialization учит агента создавать Dart-модели с методами fromJson и toJson через библиотеку dart:convert. Пригодится при ручном разборе простых структур данных в Flutter. CX Codex +1 40 800установок portable-text-serialization sanity Скилл portable-text-serialization подсказывает агенту, как рендерить и сериализовать Portable Text в React, Svelte, Vue, Astro, HTML, Markdown и чистый текст. CX Codex +1 3 100установок ue-serialization-savegames quodsoler Скилл ue-serialization-savegames для Claude Code помогает писать сохранения и загрузку в Unreal Engine C++. Он подключается к задачам со слотами, сериализацией и переносом старых сохранений. CX Codex +1 1 400установок recoup-platform-api-access recoupable Скилл recoup-platform-api-access для Claude Code даёт агенту доступ к REST API платформы Recoup и внешним коннекторам. Он выгружает данные артистов, обновляет документы и отправляет письма. CX Codex +1 5 500установок server-serialization tech-leads-club Правило server-serialization для Claude Code помогает сокращать данные, которые React передаёт с сервера на клиент. Оно срабатывает при работе с границей Server/Client в React. CX Codex +1 ★ 7 191звёзд репо

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

Весь набор →
symfony-cache Помогает настроить пулы Symfony Cache, срок жизни записей и сброс по тегам. Защищает от одновременного пересчёта истёкшего ключа. CX Codex +1 ★ 234звёзд репо test-doubles-mocking Скилл test-doubles-mocking помогает создавать тестовые двойники с PHPUnit для изолированного тестирования Symfony-приложений. CX Codex +1 ★ 234звёзд репо rate-limiting Скилл rate-limiting помогает настроить ограничение частоты запросов в Symfony через компонент RateLimiter, атрибуты контроллеров и заголовок Retry-After. CX Codex +1 ★ 234звёзд репо api-platform-tests Скилл api-platform-tests помогает писать функциональные тесты ресурсов API Platform на Symfony: проверять ответы, фильтры, схемы JSON и доступ. Пригодится при добавлении или изменении API-эндпоинтов. 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звёзд репо functional-tests Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback. CX Codex +1 ★ 234звёзд репо

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

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