AIKraft/Skills/gateway-workers

gateway-workers

Создание, отладка и проверка Cloudflare Workers, вызываемых через действие Forward в политиках Gateway HTTP. Включает работу с GatewayMiddleware, типами Gateway, контекстом и продолжением выполнения.

CLCloudflare official Разработка ★ 3.1k

Что делает навык

Навык предназначен для создания, отладки и проверки Cloudflare Workers, которые вызываются через действие Forward в политиках Gateway HTTP. Он обеспечивает реализацию контракта Forward через класс GatewayMiddleware, позволяя трансформировать запросы, генерировать синтетические ответы или выполнять фоновые задачи.

Когда применять

  • Реализация трансформации HTTP-трафика, проходящего через политики Gateway.
  • Создание синтетических ответов для определенных запросов без обращения к исходному серверу.
  • Выполнение фоновых задач на основе входящих HTTP-запросов.
  • Получение и использование контекста Gateway (идентификация пользователя, состояние устройства) для принятия решений.

Как работает

  1. Изучить текущее руководство Forward и выбрать подходящий шаблон Worker для требуемой задачи.
  2. Экспортировать именованный класс GatewayMiddleware, расширяющий WorkerEntrypoint из cloudflare:workers.
  3. Реализовать метод handle(request, context, next) и вернуть объект Response.
  4. Использовать второй аргумент (context) для доступа к оригинальному запросу и данным Gateway, не путая его с this.ctx или this.env.
  5. Вызвать next(request) не более одного раза для продолжения запроса к исходному назначению или вернуть синтетический ответ.
  6. При необходимости использовать 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 и совместимые) подхватывает его по описанию и следует шагам.