К основному содержанию
скилл CX Codex

cloudflare-workers-migration — скилл для Claude Code: миграция на edge

Скилл cloudflare-workers-migration для переноса приложений на Cloudflare Workers с AWS Lambda, Vercel, Express и Node.js. Автоматически адаптирует обработчики, middleware и переменные окружения под Web API.

MIT 316 установок ★ 250 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add secondsky/claude-skills --skill cloudflare-workers-migration -a claude-code
Открыть на GitHub

Что делает cloudflare-workers-migration

Содержит дерево решений для выбора стратегии миграции: адаптер для Lambda, Hono для Express, OpenNext для Next.js. Внутри таблица совместимости Node.js API — что поддерживается через флаг nodejs_compat_v2 в wrangler.jsonc, а что требует замены (fs → R2/KV, child_process не работает). Для десяти частых ошибок (fs is not defined, Buffer is not defined, Exceeded CPU time) даны причины и решения.

В скилле примеры переписывания Lambda-обработчиков на fetch, Express middleware на Hono, замены process.env на параметр env. Лимит CPU 50 мс на запрос: длинные вычисления нужно делить на части или выносить в Durable Objects. Для фоновых задач вместо setTimeout используется ctx.waitUntil().

Чек-лист миграции включает проверку зависимостей, конвертацию CommonJS в ESM, замену файловой системы на хранилища и тестирование через wrangler dev. Скилл загружает справочники по миграции с Lambda, Vercel, Express и совместимости Node.js API по контексту задачи.

Какие задачи решает

  • перенести Lambda-функцию на Cloudflare Workers
  • адаптировать Express middleware под Workers Runtime
  • устранить ошибку fs is not defined при деплое на edge
  • заменить process.env на параметр env в обработчике
  • проверить совместимость Node.js API перед миграцией

Примеры запросов агенту

  • Перенеси Lambda-обработчик из handler.js на Workers, файл назови worker.ts
  • Адаптируй Express middleware из app.js под Hono, сохрани в src/index.ts
  • Проверь, какие Node.js API из package.json не работают в Workers

Как установить cloudflare-workers-migration

1Через Skills CLI (Vercel)

npx skills add secondsky/claude-skills --skill cloudflare-workers-migration -a claude-code

2Вручную: положить файлы

~/.claude/skills/cloudflare-workers-migration/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cloudflare-workers-migration/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cloudflare-workers-migration

Как установить cloudflare-workers-migration в Claude Code?

Выполни npx skills add secondsky/claude-skills --skill cloudflare-workers-migration -a claude-code, скилл будет установлен в ~/.claude/skills/cloudflare-workers-migration/SKILL.md.

Что делает cloudflare-workers-migration?

Переносит серверные приложения на Cloudflare Workers. Даёт паттерны адаптации Lambda-обработчиков, Express middleware и переменных окружения под Web API, таблицу совместимости Node.js API и решения для десяти частых ошибок миграции.

Какие Node.js API не работают в Workers?

fs, child_process, cluster, dgram не поддерживаются. Для файлов используй R2 или KV, для сетевых запросов — fetch или WebSocket. Модули crypto, buffer, stream и path доступны через флаг nodejs_compat_v2.

Исходный текст

SKILL.md · MIT
---
name: cloudflare-workers-migration
description: Migrate to Cloudflare Workers from AWS Lambda, Vercel, Express, and Node.js. Use when porting existing applications to the edge, adapting serverless functions, or resolving Node.js API compatibility issues.
metadata:
  version: "1.0.0"
license: MIT
---

# Workers Migration Guide

Migrate existing applications to Cloudflare Workers from various platforms.

## Migration Decision Tree

```
What are you migrating from?
├── AWS Lambda
│   └── Node.js handler? → Lambda adapter pattern
│   └── Python? → Consider Python Workers
│   └── Container/custom runtime? → May need rewrite
├── Vercel/Next.js
│   └── API routes? → Minimal changes with adapter
│   └── Full Next.js app? → Use OpenNext adapter
│   └── Middleware? → Direct Workers equivalent
├── Express/Node.js
│   └── Simple API? → Hono (similar API)
│   └── Complex middleware? → Gradual migration
│   └── Heavy node: usage? → Compatibility layer
└── Other Edge (Deno Deploy, Fastly)
    └── Standard Web APIs? → Minimal changes
    └── Platform-specific? → Targeted rewrites
```

## Platform Comparison

| Feature | Workers | Lambda | Vercel | Express |
|---------|---------|--------|--------|---------|
| **Cold Start** | ~0ms | 100-500ms | 10-100ms | N/A |
| **CPU Limit** | 50ms/10ms | 15 min | 10s | None |
| **Memory** | 128MB | 10GB | 1GB | System |
| **Max Response** | 6MB (stream unlimited) | 6MB | 4.5MB | None |
| **Global Edge** | 300+ PoPs | Regional | ~20 PoPs | Manual |
| **Node.js APIs** | Partial | Full | Full | Full |

## Top 10 Migration Errors

| Error | From | Cause | Solution |
|-------|------|-------|----------|
| `fs is not defined` | Lambda/Express | File system access | Use KV/R2 for storage |
| `Buffer is not defined` | Node.js | Node.js globals | Import from `node:buffer` |
| `process.env undefined` | All | Env access pattern | Use `env` parameter |
| `setTimeout not returning` | Lambda | Async patterns | Use `ctx.waitUntil()` |
| `require() not found` | Express | CommonJS | Convert to ESM imports |
| `Exceeded CPU time` | All | Long computation | Chunk or use DO |
| `body already consumed` | Express | Request body | Clone before read |
| `Headers not iterable` | Lambda | Headers API | Use Headers constructor |
| `crypto.randomBytes` | Node.js | Node crypto | Use `crypto.getRandomValues` |
| `Cannot find module` | All | Missing polyfill | Check Workers compatibility |

## Quick Migration Patterns

### AWS Lambda Handler

```typescript
// Before: AWS Lambda
export const handler = async (event, context) => {
  const body = JSON.parse(event.body);
  return {
    statusCode: 200,
    body: JSON.stringify({ message: 'Hello' }),
  };
};

// After: Cloudflare Workers
export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const body = await request.json();
    return Response.json({ message: 'Hello' });
  },
};
```

### Express Middleware

```typescript
// Before: Express
app.use((req, res, next) => {
  if (!req.headers.authorization) {
    return res.status(401).json({ error: 'Unauthorized' });
  }
  next();
});

// After: Hono Middleware
app.use('*', async (c, next) => {
  if (!c.req.header('Authorization')) {
    return c.json({ error: 'Unauthorized' }, 401);
  }
  await next();
});
```

### Environment Variables

```typescript
// Before: Node.js
const apiKey = process.env.API_KEY;

// After: Workers
export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const apiKey = env.API_KEY;
    // ...
  },
};
```

## Node.js Compatibility

Workers support many Node.js APIs via compatibility flags:

```jsonc
// wrangler.jsonc
{
  "compatibility_flags": ["nodejs_compat_v2"],
  "compatibility_date": "2024-12-01"
}
```

**Supported with nodejs_compat_v2:**
- `crypto` (most methods)
- `buffer` (Buffer class)
- `util` (promisify, types)
- `stream` (Readable, Writable)
- `events` (EventEmitter)
- `path` (all methods)
- `string_decoder`
- `assert`

**Not Supported (need alternatives):**
- `fs` → Use R2/KV
- `child_process` → Not possible
- `cluster` → Not applicable
- `dgram` → Not supported
- `net` → Use fetch/WebSocket
- `tls` → Handled by platform

## When to Load References

| Reference | Load When |
|-----------|-----------|
| `references/lambda-migration.md` | Migrating AWS Lambda functions |
| `references/vercel-migration.md` | Migrating from Vercel/Next.js |
| `references/express-migration.md` | Migrating Express/Node.js apps |
| `references/node-compatibility.md` | Node.js API compatibility issues |

## Migration Checklist

1. **Analyze Dependencies**: Check for unsupported Node.js APIs
2. **Convert to ESM**: Replace require() with import
3. **Update Env Access**: Use env parameter instead of process.env
4. **Replace File System**: Use R2/KV for storage
5. **Handle Async**: Use ctx.waitUntil() for background tasks
6. **Test Locally**: Verify with wrangler dev
7. **Performance Test**: Ensure CPU limits aren't exceeded

## See Also

- `workers-runtime-apis` - Available APIs in Workers
- `workers-performance` - Optimization techniques
- `cloudflare-worker-base` - Basic Workers setup

© secondsky · MIT · secondsky/claude-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
cloudflare-workers devops-skills Помогает писать и деплоить edge-функции на Cloudflare Workers через Wrangler. Закрывает API, cron-задачи и middleware. CX Codex +1 352установок cloudflare-development Mindrally Скилл cloudflare-development для Claude Code с правилами разработки на edge-платформе Cloudflare: Workers, Pages, KV, D1, R2 и Durable Objects. Пишет код для воркеров и настраивает wrangler.toml. CX Codex +1 737установок cloudflare cloudflare Подбирает продукты Cloudflare под архитектуру проекта и диагностирует ошибки 52x или 403. Включается при создании сайтов, настройке API и отладке проксирования. CX Codex +1 159 200установок openai-cloudflare-deploy OpenAI Скилл openai-cloudflare-deploy для Claude Code автоматизирует развёртывание приложений и инфраструктуры на Cloudflare: Workers, Pages, хранилища, базы данных и сервисы безопасности. CX Codex +1 ★ 540звёзд репо Cloudflare Workers Bindings cloudflare MCP-сервер Cloudflare Workers Bindings для Claude Code управляет ресурсами Cloudflare Workers и помогает искать документацию. Через агента можно просматривать и менять привязки и данные проекта. CX Codex +1 115установок Cloudflare Workers Builds docker MCP-сервер Cloudflare Workers Builds для сборок Cloudflare Workers: агент видит статус билдов и может ими управлять, не переключаясь в веб-панель. CX Codex +1

Из того же набора138

Весь набор →
cloudflare-workers-observability Скилл cloudflare-workers-observability для Claude Code: наблюдаемость Cloudflare Workers — структурированные логи, Analytics Engine, Tail Workers, метрики, алерты. Разбирает падение воркера в проде без видимых логов. CX Codex +1 322установок xss-prevention Скилл xss-prevention для Claude Code помогает закрывать XSS санитизацией ввода, кодированием вывода и CSP. Разбирает XSS-риски в пользовательском HTML, комментариях и rich text. CX Codex +1 320установок cloudflare-workers-multi-lang Скилл cloudflare-workers-multi-lang настраивает Cloudflare Workers на Rust, Python и WebAssembly. Помогает перенести вычисления в WASM и настроить сборку через wasm-pack. CX Codex +1 317установок cloudflare-r2 Работа с Cloudflare R2, S3-совместимым хранилищем объектов. Управляет бакетами, загрузками, CORS и подписанными ссылками. CX Codex +1 316установок tanstack-query Скилл помогает агенту работать с TanStack Query v5: получать данные, настраивать кэш, мутации и разбирать ошибки миграции с v4. CX Codex +1 314установок zustand-state-management Скилл zustand-state-management помогает настраивать глобальный стейт на Zustand в проектах на React 18+ и TypeScript 5+. Предотвращает ошибки гидратации в Next.js и зацикливание рендеров. CX Codex +1 301установок nextjs Скилл для работы с Next.js 16, React 19.2 и современными паттернами серверных компонентов, Server Actions и кэширования. Помогает при миграции с версии 15, ошибках async params и настройке Partial Prerendering. CX Codex +1 299установок feature-dev Скилл feature-dev для Claude Code ведёт разработку функции через семь фаз — от изучения кодовой базы до проверки результата. Охватывает многофайловые задачи и спорные архитектурные решения. CX Codex +1 294установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой