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

rate-limiting — скилл для Claude Code: что делает и как установить

Скилл rate-limiting помогает настроить ограничение частоты запросов в Symfony через компонент RateLimiter, атрибуты контроллеров и заголовок Retry-After.

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

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

Что делает rate-limiting

Скилл ведёт Claude Code по шагам внедрения Symfony RateLimiter. Он подбирает подходящий алгоритм под профиль трафика: скользящее окно (sliding window), корзину токенов (token bucket) или фиксированное окно (fixed window). Настройка прописывается в секции framework.rate_limiter с указанием лимитов и всплесков (burst).

Защита применяется через атрибут контроллера #[RateLimit], внутри сервиса или глобальным подписчиком событий. Скилл требует отдавать код ответа 429 с обязательным заголовком Retry-After, а также писать тесты на успешный запрос, отказ и сброс счётчика.

Позиция заложена в правилах: резервирование токенов с блокировкой процесса недопустимо в веб-запросах, а локальное хранилище в памяти одного процесса не работает при нескольких воркерах.

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

  • ограничить число попыток входа и сброса пароля
  • сконфигурировать политики в framework.rate_limiter
  • вернуть ответ 429 с заголовком Retry-After
  • написать тесты на лимиты запросов и их сброс

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

  • Настрой лимитер для эндпоинта логина через атрибут #[RateLimit]
  • Добавь политику token bucket в framework.rate_limiter для публичного API
  • Покрой тестами поведение контроллера при превышении лимита запросов

Как установить rate-limiting

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a claude-code

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

~/.claude/skills/rate-limiting/SKILL.md

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

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

Вопросы о rate-limiting

Как установить rate-limiting в Claude Code?

Выполните в терминале команду npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a claude-code.

Что делает скилл rate-limiting?

Он направляет агента при настройке Symfony RateLimiter: формулирует конфигурацию политик, расставляет проверки в контроллерах и формирует корректный ответ 429.

Почему нельзя использовать блокировку токенов в веб-запросах?

Ожидание освобождения токена подвешивает рабочий процесс PHP, поэтому веб-запросы обязаны сразу получать отказ с кодом 429.

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

SKILL.md · MIT
---
name: rate-limiting
description: "Implement rate limiting with the Symfony RateLimiter (sliding window, token bucket, fixed window) and the #[RateLimit] controller attribute"
capabilities: [read, search, edit, shell]
tags: [security]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---
# Rate Limiting (Symfony)

## Use when
- Capping how often a caller may reach an endpoint: login, password reset, public API, any public write.
- Choosing between sliding window, token bucket and fixed window.
- Applying a limiter by controller attribute, in a service, or globally through an event subscriber.
- Returning a correct 429 with `Retry-After`.
- Blocking until a token frees up, rather than refusing outright.

## Default workflow
1. Name what is limited and what identifies the caller.
2. Pick the algorithm the traffic shape calls for, and state the rate and the burst.
3. Declare the policy under `framework.rate_limiter`, one entry per limiter.
4. Apply it where the request is refused, and answer 429 with `Retry-After`.
5. Prove the limit under test: the call that passes, the one refused, the reset.

## Guardrails
- The caller identity decides who is counted. Behind a proxy, an untrusted client address counts everyone as one.
- A limiter is not authorization. It caps a rate; it never decides a right.
- Refuse with 429 and `Retry-After`, never with a silent drop or a 500.
- A limiter whose storage is per process does not limit anything across several workers.
- Reserving tokens blocks the calling process: never on a web request.

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

## Output contract
- Limiter policies, with the algorithm, the rate and the burst for each.
- Where each limiter is applied, and on what caller identity.
- The 429 response shape, headers included.
- Tests covering the accepted call, the refused one, and the reset.


## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
rate-limiting-abuse-protection patricio0312rev Скилл rate-limiting-abuse-protection добавляет в проект ограничение частоты запросов: политики на маршрут, лимиты по IP и пользователю, скользящее окно и понятные ответы об ошибке. CX Codex +1 333установок API Rate Limiting taste f Промпт API Rate Limiting taste для ChatGPT, настраивающий правила ограничения частоты запросов к API. Помогает проектировать защиту бэкенда от злоупотреблений и сбоев. GP ChatGPT ★ 178 201звёзд репо api-rate-limiting secondsky Скилл api-rate-limiting для Claude Code помогает добавить ограничения запросов к API. Он включается при защите публичных API, настройке тарифных лимитов или борьбе с перегрузкой запросами. CX Codex +1 515установок rate-limiting-implementation aj-geddes Скилл rate-limiting-implementation для Claude Code добавляет в сервис ограничение частоты запросов, квоты и backpressure для открытого наружу API и растущей нагрузки. CX Codex +1 508установок api-gateway-backend-security-and-rate-limiting официальный google Скилл api-gateway-backend-security-and-rate-limiting для Claude Code, Gemini CLI и Codex настраивает аутентификацию клиентов и бэкенда, а также квоты запросов в Google Cloud API Gateway, включая шлюзы с MCP. CX Codex +1 360установок setup-rate-limiting davila7 Слэш-команда setup-rate-limiting разбирает проект и собирает систему ограничения запросов к API: алгоритмы, квоты по пользователям, хранение счётчиков. CX Codex +1 247установок

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

Весь набор →
using-symfony-superpowers Скилл using-symfony-superpowers для Claude Code определяет версию Symfony, выбирает нужный скилл и выстраивает порядок действий для сложных задач. CX Codex +1 ★ 234звёзд репо interfaces-and-autowiring Скилл interfaces-and-autowiring настраивает внедрение зависимостей в проектах на Symfony: привязывает интерфейсы, расставляет атрибуты #[Target], #[Autowire] и декорирует сервисы без правок контейнера вручную. CX Codex +1 ★ 234звёзд репо symfony-cache Помогает настроить пулы Symfony Cache, срок жизни записей и сброс по тегам. Защищает от одновременного пересчёта истёкшего ключа. CX Codex +1 ★ 234звёзд репо test-doubles-mocking Скилл test-doubles-mocking помогает создавать тестовые двойники с PHPUnit для изолированного тестирования Symfony-приложений. CX Codex +1 ★ 234звёзд репо api-platform-tests Скилл api-platform-tests помогает писать функциональные тесты ресурсов API Platform на Symfony: проверять ответы, фильтры, схемы JSON и доступ. Пригодится при добавлении или изменении API-эндпоинтов. CX Codex +1 ★ 234звёзд репо api-platform-serialization Скилл api-platform-serialization настраивает сериализацию API Platform: группы полей на операцию, IRI вместо вложенных объектов, вычисляемые свойства и опции нормализаторов. 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звёзд репо

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

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