# cloudflare-workers-dev-experience

Помогает настроить локальную разработку Cloudflare Workers через Wrangler и Miniflare. Пригодится при отладке биндингов KV, D1 или R2 и настройке HMR.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 303 установки · ★ 237
- Автор: secondsky
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/cloudflare-workers/skills/cloudflare-workers-dev-experience/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/cloudflare-workers-dev-experience

## Что делает

Скилл содержит правила и шаблоны для локального запуска воркеров на базе Bun или npm. Он даёт готовую структуру `wrangler.jsonc` с раздельными привязками для KV, баз D1 и хранилищ R2. Конфигурация `tsconfig.json` ориентирована на стандарт ES2022 с резолюцией `bundler`. В репозитории есть скрипт `scripts/dev-setup.sh` и вспомогательные шаблоны.

Без указания `preview_id` в настройках KV локальный эмулятор вернёт `undefined`. Миграции D1 применяются локально. Скилл разбирает типичные сбои: неработающий HMR из-за занятых портов, пропущенные типы и ошибки симуляции бакетов. Для пошаговой отладки предлагается готовый файл `.vscode/launch.json` с инспектором на порту 9229.

Безопасность поставок вынесена в отдельный блок. Автор советует блокировать post-install скрипты через параметр `ignore-scripts` и проверять пакеты утилитой Socket CLI перед запуском `bunx create-cloudflare`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-dev-experience -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-dev-experience -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-dev-experience -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install secondsky/claude-skills cloudflare-workers-dev-experience
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-dev-experience -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/secondsky/claude-skills --path plugins/cloudflare-workers/skills/cloudflare-workers-dev-experience
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-dev-experience -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/cloudflare-workers/skills/cloudflare-workers-dev-experience/SKILL.md

## Когда брать
- настроить wrangler.jsonc с локальными привязками для KV, D1 и R2
- устранить ошибку env.KV is undefined через preview_id
- настроить отладку воркера в VS Code через инспектор на порту 9229
- подготовить tsconfig.json с типами @cloudflare/workers-types

## Примеры запросов агенту
- Помоги настроить wrangler.jsonc для локальной базы D1 и бакета R2
- Почему локально в воркере env.KV возвращает undefined?
- Сгенерируй конфиг launch.json для отладки Cloudflare Worker через Bun

## Похожие
- [cloudflare-workers](https://affpapa.org/nevibecode/skills/cloudflare-workers.md) — скилл · 314 установок
- [workers-best-practices](https://affpapa.org/nevibecode/skills/cloudflare-workers-best-practices.md) — скилл · 126100 установок
- [hono-cloudflare](https://affpapa.org/nevibecode/skills/hono-cloudflare.md) — скилл · 620 установок
- [building-mcp-server-on-cloudflare](https://affpapa.org/nevibecode/skills/building-mcp-server-on-cloudflare.md) — скилл · 2 установки
- [cloudflare-development](https://affpapa.org/nevibecode/skills/cloudflare-development.md) — скилл · 689 установок
- [cloudflare-workers-hono-angular-saas-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/cloudflare-workers-hono-angular-saas-cursorrules-prompt-file.md) — правило · ★ 41024

Из того же набора: [secondsky/claude-skills](https://affpapa.org/nevibecode/by/secondsky/claude-skills.md) — 128 карточек

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

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