CL
gateway-workers
Создание, отладка и проверка Cloudflare Workers, вызываемых через действие Forward в политиках Gateway HTTP. Включает работу с GatewayMiddleware, типами Gateway, контекстом и продолжением выполнения.
Что делает навык
Навык предназначен для создания, отладки и проверки Cloudflare Workers, которые вызываются через действие Forward в политиках Gateway HTTP. Он обеспечивает реализацию контракта Forward через класс GatewayMiddleware, позволяя трансформировать запросы, генерировать синтетические ответы или выполнять фоновые задачи.
Когда применять
- Реализация трансформации HTTP-трафика, проходящего через политики Gateway.
- Создание синтетических ответов для определенных запросов без обращения к исходному серверу.
- Выполнение фоновых задач на основе входящих HTTP-запросов.
- Получение и использование контекста Gateway (идентификация пользователя, состояние устройства) для принятия решений.
Как работает
- Изучить текущее руководство Forward и выбрать подходящий шаблон Worker для требуемой задачи.
- Экспортировать именованный класс GatewayMiddleware, расширяющий WorkerEntrypoint из cloudflare:workers.
- Реализовать метод handle(request, context, next) и вернуть объект Response.
- Использовать второй аргумент (context) для доступа к оригинальному запросу и данным Gateway, не путая его с this.ctx или this.env.
- Вызвать next(request) не более одного раза для продолжения запроса к исходному назначению или вернуть синтетический ответ.
- При необходимости использовать fetch() для отправки запросов в другие назначения, так как next() не поддерживает редиректы или фан-аут.
Примеры запросов агенту
Создай Cloudflare Worker для обработки HTTP-запросов через действие Forward, используя шаблон трансформации.
Реализуй класс GatewayMiddleware, который проверяет контекст Gateway и возвращает синтетический ответ 403 для анонимных пользователей.
Настрой Worker, который использует next(request) для проксирования запроса к исходному серверу, но логирует данные из контекста Gateway.
Что понадобится
- Доступ к документации Cloudflare Gateway и руководству Forward.
- Среда разработки Cloudflare Workers с поддержкой TypeScript.
- Класс WorkerEntrypoint из пакета cloudflare:workers.
Описание составлено по SKILL.md навыка, сверено 17.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «gateway-workers» из репозитория:
# https://github.com/cloudflare/skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r gateway-workers/ ~/.claude/skills/gateway-workers/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.