# workers-best-practices

Проверяет код Cloudflare Workers и конфиг wrangler.jsonc по стандартам Cloudflare. Заставляет агента скачивать свежую документацию вместо устаревших знаний.

- скилл · `type=skill` · Codex, ChatGPT · 1 установка · ★ 7604
- Автор: Cloudflare · официальный репозиторий OpenAI
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/cloudflare/skills/workers-best-practices/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/workers-best-practices

## Что делает

Скилл заставляет модель перед написанием или ревью кода Workers загружать актуальные типы `@cloudflare/workers-types` и правила с сайта разработчиков Cloudflare. Память нейросетей быстро устаревает. Поиск по свежей документации защищает проект от ошибок в типах и устаревших флагов среды.

В проверку входит валидация `wrangler.jsonc`, поиск утечек секретов и отслеживание антипаттернов исполнения. Скилл запрещает сохранять данные запроса в глобальных переменных модуля. Это предотвращает утечки состояния между разными вызовами. Фоновые операции скилл требует передавать в `ctx.waitUntil()`. Деструктуризация `const { waitUntil } = ctx` ломает привязку контекста и вызывает ошибку `Illegal invocation` в рантайме.

Архитектурные правила требуют использовать прямые биндинги KV, D1 или R2 вместо вызовов Cloudflare REST API. Для внешних баз данных PostgreSQL и MySQL скилл требует подключать Hyperdrive. Проверка типов бракует интерфейсы `Env`, написанные вручную, и требует генерации через команду `wrangler types`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill workers-best-practices -a codex
```

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

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill workers-best-practices -a claude-code
```

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins workers-best-practices
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/cloudflare/skills/workers-best-practices
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- настроить wrangler.jsonc со свежими флагами совместимости
- найти повисшие промисы без await или ctx.waitUntil()
- заменить небезопасный Math.random() на Web Crypto API
- сгенерировать типизацию окружения через wrangler types
- перевести обращение к KV и R2 с REST API на нативные биндинги

## Примеры запросов агенту
- Проверь мой worker.ts на утечки памяти при чтении потоков и повисшие промисы.
- Помоги составить wrangler.jsonc для проекта с D1 и очередями по правилам Cloudflare.
- Проведи ревью кода обработчика перед деплоем и проверь типизацию Env.

## Похожие
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [lark-im](https://affpapa.org/nevibecode/skills/lark-im.md) — скилл · 472900 установок
- [lark-event](https://affpapa.org/nevibecode/skills/lark-event.md) — скилл · 466800 установок
- [caveman-discover](https://affpapa.org/nevibecode/skills/caveman-discover.md) — скилл · 104400 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок

## Другие версии с тем же именем
- [workers-best-practices · cloudflare](https://affpapa.org/nevibecode/skills/cloudflare-workers-best-practices.md) — 126100 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 596 карточек

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

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