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

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

Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов.

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

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

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

Скилл задаёт порядок работы с фильтрами на операции API Platform: объявить parameters с QueryParameter и подобрать класс под каждый параметр. Атрибут #[ApiFilter] устарел с 4.4, поэтому в новом коде он не нужен.

Классы выбираются по установленной версии: PartialSearchFilter и FreeTextQueryFilter для поиска, ComparisonFilter для диапазонов, SortFilter с 4.3, ChainFilter с 4.4. Свой фильтр реализует FilterInterface и читает значение из $context['parameter']; AbstractFilter и filterProperty() тоже помечены устаревшими с 4.4, их оставляют для кода 4.3 и 3.4.

Дальше идут ограничения. Агент включает strictQueryParameterValidation, чтобы незнакомый query-параметр возвращал 400, ставит #[ORM\Index] на фильтруемые колонки и проверяет эндпоинт запросами с совпадением и без. Для id и внешних ключей нужен точный фильтр: частичное LIKE %value% индекс не использует. Значения в своих фильтрах связываются через generateParameterName() и setParameter(), без склейки строки.

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

  • добавить поиск по нескольким полям через один query-параметр
  • перевести объявления #[ApiFilter] на Parameters API
  • написать фильтр с собственной логикой запроса
  • отбивать незнакомые query-параметры ответом 400
  • поставить индексы на колонки, по которым фильтруют клиенты

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

  • Добавь фильтры в коллекцию /api/products: поиск по названию, диапазон цены и сортировку.
  • Переведи #[ApiFilter] в этом ресурсе на QueryParameter.
  • Напиши свой фильтр для поля status и включи strictQueryParameterValidation.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

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

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

Подсказывает агенту, как объявлять фильтры API Platform через QueryParameter на операции, какой класс фильтра взять под задачу и как проверить результат запросами.

Чем Parameters API отличается от #[ApiFilter]?

#[ApiFilter] помечен устаревшим с 4.4, а QueryParameter объявляется прямо в parameters операции. Скилл предлагает миграцию вручную или через api:upgrade-filter.

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

SKILL.md · MIT
---
name: api-platform-filters
description: "Implement API Platform filters - Parameters API (QueryParameter, v5/4.4/4.3) and the #[ApiFilter] attribute deprecated since 4.4 - for search, date, range, boolean, and custom filtering"
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 Filters (Symfony)

## Use when
- A collection endpoint needs search, exact match, range, date, boolean, or sort query parameters.
- One query parameter must search across several properties.
- A filter needs custom query logic that the built-in filters do not cover.
- Migrating `#[ApiFilter]` declarations (deprecated since 4.4) to the Parameters API, by hand or with `api:upgrade-filter`.

## Default workflow
1. Declare `parameters` with `QueryParameter` on the operation; keep `#[ApiFilter]` only in 3.4 code or code not yet migrated.
2. Choose a filter class per parameter, checking the installed version: `ExactFilter`, `PartialSearchFilter`, `FreeTextQueryFilter`, `OrFilter`, `IriFilter` (4.2+), `ComparisonFilter`, `SortFilter` (4.3+), `StartSearchFilter`, `EndSearchFilter`, `ChainFilter` (4.4+).
3. For a custom filter, implement `FilterInterface` and read the bound value from `$context['parameter']` (`AbstractFilter` and `filterProperty()` are deprecated since 4.4: keep them for 4.3 and 3.4 code).
4. Turn on `strictQueryParameterValidation` so unknown query parameters return 400.
5. Add `#[ORM\Index]` on filtered columns, then request the endpoint with matching and non-matching values.

## Guardrails
- Keep filter classes stateless: take request data from `$context`, not the constructor.
- Expose only the properties clients need to filter on.
- Use exact matching for ids and foreign keys: partial `LIKE %value%` cannot use an index.
- In custom filters, validate the value and bind it with `generateParameterName()` and `setParameter()`, never by string concatenation.

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

## Output contract
- The parameters per operation, with filter class and accepted syntax (for example `?price[gte]=1000`).
- Indexes added for the filtered columns.
- Tests for a match, an empty result, and an unknown parameter.

## References
- `reference.md`

© 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звёзд репо configuring-filters celigo Скилл configuring-filters для Claude Code учит настраивать фильтры Celigo на экспортах, импортах и ветках роутера: определять, какие записи идут дальше по пайплайну, отбрасываются или пропускают шаг. CX Codex +1 4 000установок pixijs-filters pixijs Скилл pixijs-filters для Claude Code, Codex, Cursor и других агентов, который учит применять фильтры в PixiJS v8: встроенные и кастомные через GLSL/WGSL. CX Codex +1 7 000установок data-table-filters openstatusHQ Строит React-таблицы с фильтрами, сортировкой и бесконечной прокруткой на базе shadcn registry. Устанавливается как набор из 15 модульных блоков через npx shadcn@latest add. CX Codex +1 501установок platform-list-view-generate forcedotcom Скилл platform-list-view-generate генерирует XML-метаданные Salesforce List View: фильтры, колонки, видимость. Проверяет совместимость операторов с типами полей и структуру файла перед деплоем. CX Codex +1 5 900установок recoup-platform-api-access recoupable Скилл recoup-platform-api-access для Claude Code даёт агенту доступ к REST API платформы Recoup и внешним коннекторам. Он выгружает данные артистов, обновляет документы и отправляет письма. CX Codex +1 5 500установок

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

Весь набор →
api-platform-resources Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI. 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звёзд репо 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звёзд репо

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

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