# rate-limiting

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 234 у репозитория
- Автор: dev-toolings
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/rate-limiting/SKILL.md
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/rate-limiting

## Что делает

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

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

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

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/rate-limiting/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/rate-limiting/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/rate-limiting/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/rate-limiting/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dev-toolings/superpowers-symfony content/skills/rate-limiting
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/rate-limiting/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill rate-limiting -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/rate-limiting
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/rate-limiting/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/rate-limiting/SKILL.md

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

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

## Похожие
- [rate-limiting-abuse-protection](https://affpapa.org/nevibecode/skills/rate-limiting-abuse-protection.md) — скилл · 333 установки
- [API Rate Limiting taste](https://affpapa.org/nevibecode/prompts/api-rate-limiting-taste.md) — промпт · ★ 178201 у репозитория
- [api-rate-limiting](https://affpapa.org/nevibecode/skills/secondsky-api-rate-limiting.md) — скилл · 515 установок
- [rate-limiting-implementation](https://affpapa.org/nevibecode/skills/rate-limiting-implementation.md) — скилл · 508 установок
- [api-gateway-backend-security-and-rate-limiting](https://affpapa.org/nevibecode/skills/api-gateway-backend-security-and-rate-limiting.md) — скилл · 360 установок
- [setup-rate-limiting](https://affpapa.org/nevibecode/commands/setup-rate-limiting.md) — команда · 247 установок

Из того же набора: [dev-toolings/superpowers-symfony](https://affpapa.org/nevibecode/by/dev-toolings/superpowers-symfony.md) — 51 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
