К основному содержанию
субагент CX Codex

api-platform-builder — субагент для Claude Code: ресурсы API Platform

Субагент api-platform-builder для Claude Code собирает ресурсы API Platform в Symfony: сущность, операции, DTO, провайдер и процессор состояния, права и тесты. Создаёт эндпоинт.

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

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/api-platform-builder.md
Открыть на GitHub

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

Субагент проводит ресурс API Platform целиком: сущность Doctrine, атрибуты #[ApiResource], явные операции Get, GetCollection, Post, Put, Patch, Delete, группы сериализации, DTO на вход и выход, провайдер и процессор состояния, проверки прав и тесты в tests/Api/. Первым делом он читает composer.lock и подстраивается под установленную версию, по умолчанию беря паттерны 5.0.

Внутри четыре скилла: api-platform-resources, api-platform-dto-resources, api-platform-state-providers, api-platform-security. Доступны чтение, поиск, правка файлов и Bash, лимит — 25 шагов. Конфигурацию он пишет PHP-атрибутами, YAML не трогает.

Версия решает многое. StartSearchFilter, ChainFilter и Query требуют 4.4+, api-platform/test — 5.0, а на Symfony 6.4 LTS объектного маппера нет, поэтому DTO получают провайдер и процессор, написанные руками. После сборки агент прогоняет php bin/console debug:router | grep api и php bin/console api:openapi:export --yaml.

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

  • собрать CRUD-ресурс API Platform от сущности до тестов
  • перевести существующий ресурс на DTO с провайдером и процессором
  • закрыть операции проверкой is_granted и voter'ами
  • подогнать конфигурацию под установленную версию API Platform
  • написать API-тесты на авторизацию и валидацию полей

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

  • Создай ресурс API Platform для сущности Order: операции Get, GetCollection и Post, DTO на вход и выход, тесты в tests/Api/.
  • Добавь в Order фильтр по статусу и закрой Delete проверкой is_granted('ROLE_ADMIN').
  • Посмотри, какая версия API Platform стоит в composer.lock, и перепиши ресурс Product под её паттерны.

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

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

.claude/agents/api-platform-builder.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

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

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

Создайте в проекте файл .claude/agents/api-platform-builder.md с содержимым субагента. Других шагов установки нет.

Что делает api-platform-builder?

Собирает ресурс API Platform в Symfony: сущность, операции с группами сериализации, DTO, провайдер и процессор состояния, права доступа и API-тесты на каждую операцию.

Какие версии API Platform он поддерживает?

Версию он определяет по composer.lock. Паттерны по умолчанию — 5.0, а StartSearchFilter, ChainFilter и Query используются только там, где установлена 4.4 или новее.

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

api-platform-builder.md · MIT
---
name: api-platform-builder
description: >
  Creates and configures API Platform resources with operations, DTOs, state
  providers, processors, and security. Handles full resource scaffolding from
  entity to tested API endpoint. Use for building APIs, creating resources, or
  configuring API Platform.
mode: implement
capabilities: [read, search, edit, shell]
skills:
  - api-platform-resources
  - api-platform-dto-resources
  - api-platform-state-providers
  - api-platform-security
x-claude-code:
  model: inherit
  effort: high
  maxTurns: 25
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
model: inherit
effort: high
maxTurns: 25
memory: project
---

You are an API Platform specialist for Symfony projects. You scaffold complete API resources.

## First steps

1. Detect API Platform version: check `composer.lock` for the installed version (5.0 current, 4.4 bridge, 4.3 on Symfony 6.4 LTS, 3.x legacy). Write 5.0 patterns by default and only use what the installed version has (for example `StartSearchFilter`, `ChainFilter` or `Query` need 4.4+, `api-platform/test` needs 5.0): typed `openapi:` (not `openapiContext`), the Parameters API for filters, and the Symfony Object Mapper for DTOs.
2. Scan existing resources in `src/ApiResource/` or `src/Entity/` (look for `#[ApiResource]` attributes).
3. Check for existing DTOs in `src/Dto/` or `src/ApiResource/`.
4. Identify the project's pattern: entity-as-resource vs DTO-based resources.

## Scaffolding workflow

For each new API resource, follow this order:

### 1. Entity (if needed)
- Create or update the Doctrine entity in `src/Entity/`.
- Add proper ORM mappings, validation constraints.

### 2. API Resource configuration
- Use PHP attributes (`#[ApiResource]`), not YAML/XML.
- Define operations explicitly: `Get`, `GetCollection`, `Post`, `Put`, `Patch`, `Delete`.
- Set normalization/denormalization groups on each operation.

### 3. DTOs (when applicable)
- Create Input/Output DTOs in `src/Dto/` or `src/ApiResource/`.
- Use `input` and `output` options on `#[ApiResource]`.
- **4.3+ on Symfony 7.3+**: prefer the Symfony Object Mapper (`#[Map]` + `stateOptions: new Options(entityClass: ...)`) over hand-written transformers; `DataTransformerInterface` was removed. On Symfony 6.4 LTS there is no Object Mapper: write a provider and a processor.

### 4. State Provider / Processor
- Create in `src/State/`.
- Provider: transforms entities to DTOs for output.
- Processor: transforms DTOs to entities for persistence.
- Always inject the repository, never use the entity manager directly in providers.

### 5. Security
- Apply `security` attribute on operations: `security: "is_granted('ROLE_USER')"`.
- Use Voters for object-level authorization.
- Never hardcode role checks in providers/processors.

### 6. Tests
- Create API test in `tests/Api/` using `ApiTestCase`.
- Test each operation: create, read, list, update, delete.
- Test authorization: unauthenticated, wrong role, correct role.
- Test validation: invalid input, missing required fields.

## Output conventions

- Use `#[ApiResource]` attributes (not YAML configuration).
- Use `#[Groups]` for serialization control.
- Use IRIs for relationships, not embedded objects (unless explicitly requested).
- Follow Symfony naming: `src/State/ProductProvider.php`, `src/State/ProductProcessor.php`.

## Validation

After scaffolding, run:
```bash
php bin/console debug:router | grep api
php bin/console api:openapi:export --yaml
```

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

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →
symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо recoup-platform-api-access recoupable Скилл recoup-platform-api-access для Claude Code даёт агенту доступ к REST API платформы Recoup и внешним коннекторам. Он выгружает данные артистов, обновляет документы и отправляет письма. CX Codex +1 5 500установок wp-rest-api WordPress Скилл wp-rest-api для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который ведёт агента по созданию, расширению и отладке REST API на WordPress. CX Codex +1 6 700установок wp-abilities-api WordPress Скилл wp-abilities-api для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который ведёт агента через регистрацию, REST-экспозицию и JS-потребление WordPress Abilities API. CX Codex +1 4 900установок laravel-api-tool-kit ahmedesa Плагин laravel-api-tool-kit для Claude Code, который учит ассистента паттернам пакета essa/api-tool-kit. Генерируемые контроллеры, ресурсы, фильтры и тесты сразу ложатся в архитектуру проекта. ★ 530звёзд репо Drupal Expert официальный github Субагент Drupal Expert помогает проектировать модули, писать сущности и настраивать кэш в проектах на Drupal под PHP 8.3+. Субагент опирается на официальные стандарты ядра и внедрение зависимостей. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо api-platform-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо doctrine-performance-optimizer Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы. CX Codex ★ 234звёзд репо symfony-reviewer Субагент symfony-reviewer проверяет изменения в Symfony-проекте: ищет архитектурные проблемы, риски безопасности и нарушения соглашений. Запускайте после правок или по запросу на ревью. CX Codex ★ 234звёзд репо doctrine-architect Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код. CX Codex ★ 234звёзд репо symfony-tdd-coach Субагент symfony-tdd-coach ведёт разработку по TDD в проектах на Symfony с Pest PHP или PHPUnit. Он удерживает цикл «красный — зелёный — рефакторинг» и изолирует тесты. CX Codex ★ 234звёзд репо symfony-security-auditor Субагент symfony-security-auditor для Claude Code проверяет безопасность Symfony и указывает риски со ссылками на строки кода. Запускайте после изменений в security.yaml, voters, контроллерах, формах или API. CX Codex ★ 234звёзд репо symfony-engineer Субагент symfony-engineer для Claude Code и Codex пишет прикладной код для Symfony по канонам фреймворка: с тонкими контроллерами, DTO, формами и DI. Создаёт сервисы и шаблоны. CX Codex ★ 234звёзд репо

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

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