Локальная разработка Workers

Запускает и отлаживает Workers локально через cf dev, wrangler dev или плагин Vite, а в Local Explorer читает и наполняет данные биндингов и смотрит трейсы. Для случаев, когда локальный запрос падает или непонятно, что вернул биндинг.

DevOpsПак: Скиллы Cloudflare25 строкworkers-development
Автор
Источник
cloudflare/skills/skills/workers-development @ 5108325
Лицензия
Apache-2.0

Об этом скилле

Что делает

Скилл — про запуск и отладку Worker на своей машине. Он берёт ту команду разработки, что уже есть в проекте: cf dev в проекте на cf, иначе скрипт Wrangler или плагина Cloudflare для Vite. Главный инструмент — Local Explorer, интерфейс и API, которые dev-сервер отдаёт по адресу /cdn-cgi/local/explorer. Он читает и наполняет локальные KV, R2, D1, Durable Objects на SQLite и Workflows, умеет запускать обработчики Cron и без правок в коде записывает трейсы и логи каждого локального вызова, включая обращения к биндингам. Отсюда правило: сначала трейсы, потом новые логи.

Если dev-сервер замечает ИИ-агента, он печатает адрес API; агент забирает OpenAPI-спецификацию с /cdn-cgi/local/explorer/api и берёт из неё только нужные операции, а не угадывает эндпоинты. Если API нет, он сверяет версию Wrangler или плагина Vite с требованиями Local Explorer. Перед тем как наполнять или менять данные, агент проверяет, какие биндинги помечены remote: true: они ходят в настоящий задеплоенный ресурс, даже когда Worker запущен локально.

Для задеплоенного Worker скилл только подсказывает дорогу: к документации Workers observability по логам, трейсам и метрикам или, если подключён MCP-сервер Cloudflare, к его инструментам search и execute для Workers Observability API — с привязкой к аккаунту, Worker и окну времени. Ещё в папке лежит references/skill-feedback.md для отчёта Cloudflare об ошибке в скилле.

Когда включать и когда не надо

Чтобы понять, почему падает локальный запрос или что вернул биндинг, и чтобы наполнить локальное хранилище тестовыми данными.

Проекты он не настраивает и тесты не пишет. Он упоминает скилл cloudflare со справочником по наблюдаемости и MCP-сервер Cloudflare из плагина автора; ни то, ни другое с этой папкой не ставится.

Как поставить и вызвать

Команда установки ниже скачивает папку целиком. Запустите dev-сервер как обычно и вызовите скилл:

  • Claude Code: /workers-development или попросить скилл по имени.
  • Codex: $workers-development.
  • Cursor: наберите / в чате Agent и выберите workers-development.

Пример: /workers-development POST /orders локально отдаёт 500. Найди по трейсам Local Explorer, какой вызов биндинга падает.

Чем отличается от похожих

Wrangler CLI для Cloudflare рассматривает локальную разработку как одну задачу из многих; этот скилл разбирает, что сделал запущенный Worker. Разбор логов читает файлы логов через grep и jq в поисках первой ошибки; здесь трейсы уже записал рантайм, и агент их запрашивает. Ошибки и события в Sentry читает продовые ошибки из Sentry, а этот скилл туда не ходит.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/workers-development/SKILL.md https://anymodel.org/en/skills/cloudflare/workers-development/SKILL.md -o ~/.claude/skills/workers-development/LICENSE https://anymodel.org/en/skills/cloudflare/workers-development/LICENSE -o ~/.claude/skills/workers-development/references/skill-feedback.md https://anymodel.org/en/skills/cloudflare/workers-development/references/skill-feedback.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/workers-development/SKILL.md https://anymodel.org/en/skills/cloudflare/workers-development/SKILL.md -o ~/.agents/skills/workers-development/LICENSE https://anymodel.org/en/skills/cloudflare/workers-development/LICENSE -o ~/.agents/skills/workers-development/references/skill-feedback.md https://anymodel.org/en/skills/cloudflare/workers-development/references/skill-feedback.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/skill-feedback.md') { $p = Join-Path "$HOME\.claude\skills\workers-development" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/cloudflare/workers-development/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/skill-feedback.md') { $p = Join-Path "$HOME\.agents\skills\workers-development" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/cloudflare/workers-development/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/cloudflare/workers-development/SKILL.md

SKILL.md

Исходник

Workers development and debugging

Use the project's existing tooling, scripts, and configuration. Installed help, the Local Explorer API schema, and current docs describe the supported operations; read them rather than guessing endpoints or flags.

Need Tools and discovery
Run locally Use the project's existing dev command: cf dev in a cf project, otherwise the Wrangler or Cloudflare Vite dev script. See local development.
Inspect or seed local binding data Local Explorer is a UI and API for local KV, R2, D1, SQLite-backed Durable Objects, and Workflows, and can trigger Cron handlers. Open /cdn-cgi/local/explorer on the dev server's origin.
Debug local requests Local Explorer captures traces and logs from every local invocation, including binding operations, without code changes. Check traces before adding logging.
Debug a deployed Worker Choose logs, traces, or metrics with Workers observability, or the cloudflare skill's observability reference when installed. If the Cloudflare MCP server is connected (bundled with this plugin), use search to find the Workers Observability API operations, then execute to call them, scoped to the target account, Worker, and time window.

Use the Local Explorer API

When the dev server detects an AI agent, including under cf dev, it prints a hint with the API URL and relevant endpoints. Fetch the OpenAPI specification from /cdn-cgi/local/explorer/api on the dev server's origin, then extract only the operations the task needs. If no hint appears, request that URL directly. If the API or an operation is missing, compare the installed Wrangler or Vite plugin version against the requirements in the Local Explorer docs.

Bindings are simulated locally by default, but a binding set to remote: true reaches the real deployed resource while the Worker runs locally. Traces also capture those remote calls. Identify which bindings are remote before seeding or writing data.

Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read references/skill-feedback.md.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Cloudflare

Лучшие практики Cloudflare Workers

Проверяет код и конфигурацию Cloudflare Workers по правилам для прода: даты совместимости, логи и трейсы, стриминг, waitUntil, биндинги вместо REST, Web Crypto, типы Env. Для случаев, когда Worker пишут, ревьюят или готовят к выкладке.

Wrangler CLI для Cloudflare

Ведёт команды и конфигурацию Wrangler в проектах с wrangler.jsonc или wrangler.toml: сверяется со справкой и документацией, бережёт секреты, окружения и Previews. Для случаев, когда Worker деплоят, настраивают или чинят через Wrangler.

Durable Objects в Cloudflare

Помогает писать и ревьюить Durable Objects в Cloudflare: объект на сущность, хранилище SQLite и миграции, RPC-методы, alarms, WebSocket и тесты на Vitest. Для случаев, когда приложению на Workers нужны общее состояние и координация.

Agents SDK от Cloudflare

Помогает строить приложения на Agents SDK от Cloudflare: агенты с состоянием на Durable Objects, RPC, расписания, очереди, Workflows, чат на AIChatAgent, MCP и почта. Для случаев, когда нужен ИИ-агент или чат на Workers.

Веб-фреймворки на Cloudflare Workers

Настраивает приложения на Astro, SvelteKit, React Router, TanStack Start, Nuxt, Hono и SPA под Cloudflare Workers, выбирая C3, Wrangler или cf по состоянию проекта. Для случаев, когда приложение создают, переносят или деплоят на Workers.

CLI cf для API Cloudflare

Находит и выполняет команды CLI cf от Cloudflare (бета) через cf cli search, cf schema и пробные прогоны, выбирает между cf и Wrangler. Для случаев, когда нужно работать с DNS, зонами, D1, KV или R2 из терминала или начать проект на Workers.

Аудит скорости сайта

Проводит аудит скорости страницы через Chrome DevTools MCP: трейс, Core Web Vitals по порогам, сеть, снимок доступности и настройки сборки, с исправлениями по приоритету. Для случаев, когда страница тормозит или оценка Lighthouse низкая.