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

api-platform-resources — скилл для Claude Code: настройка API

Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI.

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

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

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

Скилл помогает описать ресурс через #[ApiResource], выбрать операции CRUD и настроить пагинацию. Для документации API он использует типизированные объекты OpenAPI вместо массива openapiContext.

Если задана хотя бы одна операция, автоматический CRUD отключается: например, operations: [new Get()] не добавит коллекцию, Post или Delete. Скилл также помогает проверить список маршрутов и результаты тестов для объявленных операций. Для Symfony 6.4 LTS компоненты API Platform нужно закрепить на версии ~4.3.0.

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

  • объявить сущность или класс ресурсом API
  • задать точный список операций CRUD
  • настроить пагинацию коллекций
  • описать операции типизированными объектами OpenAPI
  • проверить маршруты и тесты операций

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

  • Оформи этот класс как ресурс #[ApiResource] и перечисли доступные операции.
  • Настрой пагинацию коллекции через атрибуты ресурса.
  • Замени openapiContext на типизированные объекты OpenAPI и проверь маршруты.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

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

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

Помогает настроить ресурсы API Platform: операции, пагинацию и типизированную документацию OpenAPI. Также описывает проверку маршрутов и тестов.

Что происходит с CRUD при явном списке операций?

После объявления хотя бы одной операции автоматический CRUD отключается. Например, operations: [new Get()] не создаёт операции для коллекции, Post или Delete.

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

SKILL.md · MIT
---
name: api-platform-resources
description: Configure API Platform resources (v5, 4.4, 4.3) with explicit operations, pagination, and typed OpenAPI for clean, versioned REST/GraphQL APIs
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 Resources (Symfony)

## Use when
- Exposing a new entity or class as an `#[ApiResource]`.
- Choosing exactly which of `Get`, `GetCollection`, `Post`, `Put`, `Patch`, and `Delete` the API offers.
- Tuning collection pagination (items per page, partial pagination, client control).
- Documenting operations with typed OpenAPI objects instead of `openapiContext` arrays.

## Default workflow
1. Install only the components you need: `api-platform/symfony`, `api-platform/doctrine-orm`, and optionally `api-platform/graphql`; on Symfony 6.4 LTS, pin them to `~4.3.0`.
2. List every operation in `operations:`, since declaring any one stops the automatic CRUD, and `Put` is never automatic.
3. Set `uriTemplate`, `requirements`, `status`, or `routePrefix` only where the defaults do not fit.
4. Configure pagination through resource attributes or `api_platform.defaults` in `config/packages/api_platform.yaml`.
5. Describe operations with `openapi:` model objects, set `validationContext` groups, then check the routes and the OpenAPI export.

## Guardrails
- Declaring one operation removes the default CRUD: an `operations: [new Get()]` resource has no collection, `Post`, or `Delete`.
- `openapiContext` arrays are deprecated in v4: use the typed `openapi:` option.
- `collectionOperations` and `itemOperations` no longer exist.
- `paginationClientEnabled` lets clients disable pagination: keep `paginationMaximumItemsPerPage` set.

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

## Output contract
- The resource class with its explicit operation list and the routes it produces.
- Pagination and OpenAPI settings, with the reason for each override.
- Route listing and test results for each declared operation.

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
api-designer https://github.com/Jeffallan Скилл api-designer для архитектуры REST и GraphQL API с генерацией OpenAPI 3.1 спецификаций. Помогает моделировать ресурсы, планировать версионирование и задавать стандарты обработки ошибок. CX Codex +1 7 100установок api-documenter zhaono1 Скилл api-documenter для Claude Code: описывает REST и GraphQL API в формате OpenAPI/Swagger. Превращает россыпь эндпоинтов в читаемую спецификацию. CX Codex +1 727установок api-reference-documentation aj-geddes Скилл api-reference-documentation помогает агенту собрать справочник по API: эндпоинты, аутентификация, примеры запросов и ответов, спецификация OpenAPI. CX Codex +1 501установок api-design Agent Skills Team Скилл api-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — проектирует или рефакторит контракты REST и GraphQL. Запускается, когда нужно зафиксировать форму API до начала реализации. CX Codex +1 390установок api-documentation-writer OneWave-AI Скилл api-documentation-writer формирует документацию для REST, GraphQL или gRPC API. Он создаёт спецификации OpenAPI, примеры запросов на нескольких языках и описания ошибок с лимитами. CX Codex +1 389установок api-documentation akillness Скилл api-documentation генерирует и обновляет документацию API: справочники эндпоинтов, быстрые старты, гайды по вебхукам и навигацию портала. Запускается при синхронизации документации со схемами OpenAPI или GraphQL. CX Codex +1 385установок

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

Весь набор →
api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо doctrine-fetch-modes Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку. CX Codex +1 ★ 234звёзд репо messenger-retry-failures Скилл messenger-retry-failures разбирает сбои обработчиков Symfony Messenger: когда сообщение стоит повторить, когда сразу отправить в failure transport и как потом достать его оттуда. CX Codex +1 ★ 234звёзд репо api-platform-state-providers Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine. CX Codex +1 ★ 234звёзд репо 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звёзд репо

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

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