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

edgeone-makers-edge-functions — скилл для Claude Code

Скилл edgeone-makers-edge-functions для Claude Code описывает разработку Edge Functions на EdgeOne Makers. Агент подключает его при работе с файлами edge-functions/** и functions/**.

MIT 253 установок ★ 1 839 обновлён 2026-11-12

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

Что делает edgeone-makers-edge-functions

Скилл помогает писать функции EdgeOne Makers на JavaScript: настраивать маршруты, обрабатывать HTTP-запросы и ответы, читать переменные среды. Он описывает динамические маршруты, обработчики отдельных HTTP-методов и объект context с параметрами запроса и функцией waitUntil.

Среда выполнения использует V8, а не Node.js: встроенные модули Node.js, require() и npm-пакеты недоступны. Код ограничен размером 5 MB, тело запроса — 1 MB, а время CPU на вызов — 200 ms. Для KV Storage нужно включить его в консоли EdgeOne Makers, создать пространство имён и привязать его к проекту; имя KV доступно как глобальная переменная, а не через context.env.

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

  • написать обработчик GET или POST для API
  • настроить маршрут с динамическим параметром
  • добавить маршрут для всех несовпавших путей
  • читать и обновлять значения в KV Storage

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

  • Добавь обработчик GET для edge-functions/api/users.js.
  • Настрой маршрут edge-functions/api/users/[id].js, чтобы он возвращал параметр id.
  • Обнови счётчик просмотров через KV Storage в edge-functions/api/counter.js.

Как установить edgeone-makers-edge-functions

1Через Skills CLI (Vercel)

npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a claude-code

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

~/.claude/skills/makers-edge-functions/SKILL.md

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

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

Вопросы об edgeone-makers-edge-functions

Как установить edgeone-makers-edge-functions в Claude Code?

Выполни npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a claude-code. Файл скилла находится по пути ~/.claude/skills/makers-edge-functions/SKILL.md.

Что делает edgeone-makers-edge-functions?

Скилл описывает Edge Functions для EdgeOne Makers: обработчики HTTP, маршрутизацию, переменные среды и доступ к KV Storage.

Какие ограничения у Edge Functions в EdgeOne Makers?

Среда работает на V8, а не на Node.js; она не поддерживает встроенные модули Node.js и npm-пакеты. Код может занимать до 5 MB, тело запроса — до 1 MB, время CPU на вызов — 200 ms.

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

SKILL.md · MIT
---
name: edgeone-makers-edge-functions
description: >-
  V8-based lightweight edge functions on EdgeOne Makers. Covers routing, KV storage access,
  request/response handling, and environment variables at the edge.
pathPatterns:
  - edge-functions/**
  - functions/**
validate:
  - pattern: "process\\.env"
    message: "Use context.env in EdgeOne Makers runtime code."
  - pattern: "new\\s+Headers\\s*\\("
    message: "Use plain object headers for this runtime surface."
  - pattern: "fs\\.writeFile"
    message: "Edge Functions do not support filesystem writes."
  - pattern: "Response\\.json\\s*\\("
    message: "Response.json() is not available in this V8 runtime — use new Response(JSON.stringify(data), { headers: { 'Content-Type': 'application/json' } })."
metadata:
  author: edgeone
  version: "1.0.0"
---

# Edge Functions

V8-based lightweight functions running at the edge. Ideal for simple APIs, KV storage access, and ultra-low latency responses.

> **Runtime:** V8 (like Cloudflare Workers) — NOT Node.js. Do NOT use Node.js built-ins or npm packages.
>
> ⚠️ `Response.json()` is **NOT available** in this V8 runtime. Always use `new Response(JSON.stringify(data), { headers: { 'Content-Type': 'application/json' } })` instead.

## Basic function

File: `edge-functions/api/hello.js`

```javascript
export default function onRequest(context) {
  return new Response('Hello from Edge Functions!');
}
```

Access: `GET /api/hello`

## HTTP method handlers

```javascript
// edge-functions/api/users.js

// Handle all methods
export function onRequest(context) {
  return new Response('Any method');
}

// Or use specific method handlers:
export function onRequestGet(context) {
  return new Response(JSON.stringify({ users: [] }), {
    headers: { 'Content-Type': 'application/json' },
  });
}

export async function onRequestPost(context) {
  const body = await context.request.json();
  return new Response(JSON.stringify({ created: true }), {
    status: 201,
    headers: { 'Content-Type': 'application/json' },
  });
}
```

## EventContext object

```javascript
export function onRequest(context) {
  const {
    request,    // Standard Request object
    params,     // Dynamic route params, e.g. { id: "123" }
    env,        // Environment variables from Makers console
    waitUntil,  // Extend function lifetime for async tasks
  } = context;

  // GEO info available via:
  const geo = context.request.eo;
  // geo.geo.countryName, geo.geo.cityName, geo.geo.latitude, etc.

  return new Response('OK');
}
```

## Dynamic routes

```javascript
// edge-functions/api/users/[id].js
// Matches: /api/users/123, /api/users/abc

export function onRequestGet(context) {
  const userId = context.params.id;
  return new Response(JSON.stringify({ userId }), {
    headers: { 'Content-Type': 'application/json' },
  });
}
```

```javascript
// edge-functions/api/[[default]].js
// Catches all unmatched routes under /api/

export function onRequest(context) {
  return new Response('Catch-all route', { status: 404 });
}
```

## KV Storage (Edge Functions only)

> Cross-reference: if your code uses `context.store` or KV APIs, also read `../makers-storage/SKILL.md`.

⚠️ **Prerequisites**: You must enable KV Storage in the EdgeOne Makers console, create a namespace, and bind it to your project before using KV. See [../makers-storage/references/kv.md](../makers-storage/references/kv.md) for full setup instructions.

The KV namespace is a **global variable** (name is set when binding in the console) — it is **NOT** on `context.env`.

```javascript
// edge-functions/api/counter.js

export async function onRequest(context) {
  // ⚠️ my_kv is a GLOBAL variable (name set when binding namespace in console)
  // Do NOT use context.env.KV ❌
  
  // Read
  const count = await my_kv.get('page_views') || '0';
  const newCount = parseInt(count) + 1;

  // Write
  await my_kv.put('page_views', String(newCount));

  return new Response(JSON.stringify({ views: newCount }), {
    headers: { 'Content-Type': 'application/json' },
  });
}
```

For full KV Storage API reference and usage guide, see: [../makers-storage/references/kv.md](../makers-storage/references/kv.md).

## Supported Runtime APIs

Edge Functions run on V8 and support these Web Standard APIs:
- **Fetch API** — `fetch()` for outbound HTTP requests
- **Cache API** — `caches.open()`, `cache.match()`, `cache.put()`
- **Headers / Request / Response** — standard Web API objects
- **Streams** — `ReadableStream`, `WritableStream`, `TransformStream`
- **Web Crypto** — `crypto.subtle` for encryption/signing
- **Encoding** — `TextEncoder`, `TextDecoder`
- **URL / URLSearchParams** — URL parsing

⚠️ **NOT available**: Node.js built-ins (`fs`, `path`, `http`, `crypto` from Node), `require()`, npm packages.

## Limits

| Resource | Limit |
|----------|-------|
| Code package size | 5 MB |
| Request body | 1 MB |
| CPU time per invocation | 200 ms |
| Language | JavaScript (ES2023+) only |

© edgeone · MIT · TencentEdgeOne/edgeone-makers-tools

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

Каталог скиллов SKILL.md →
netlify-edge-functions netlify Учит писать, маршрутизировать и отлаживать Netlify Edge Functions на Deno. Обрабатывает Auth-middleware, геолокацию, A/B-тесты и трансформацию HTML прямо на сетевом уровне. CX Codex +1 3 500установок edgeone aahl Публикует HTML-контент на EdgeOne Pages и возвращает публичный URL. Работает без логина и без API-ключа. CX Codex +1 2 300установок tencentcloud-edgeone acedatacloud Управляет зонами Tencent Cloud EdgeOne: очищает и прогревает CDN-кэш, работает с DNS-записями и показывает настройки WAF. Выполняет задачи после деплоя и проверяет конфигурацию. CX Codex +1 217установок edge-tts aahl Озвучивает текст в MP3 через uvx edge-tts нейросетевыми голосами Microsoft Edge. Создаёт аудиоверсию текста для прослушивания во время других дел. CX Codex +1 9 000установок edge goldsky-io Помогает настроить RPC-эндпоинты Goldsky Edge для EVM-сетей, оптимизировать запросы eth_getLogs и устранить ошибки провайдеров. CX Codex +1 5 000установок edge-to-edge Google LLC Скилл помогает перевести приложение Jetpack Compose на адаптивный edge-to-edge и исправить перекрытия системными панелями и клавиатурой. CX Codex +1 4 100установок

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

Весь набор →
edgeone-makers-cli Скилл edgeone-makers-cli для Claude Code управляет командами EdgeOne CLI для разработки, сборки, развертывания и окружения. CX Codex +1 303установок edgeone-makers-cloud-functions Скилл edgeone-makers-cloud-functions для Claude Code и других платформ добавляет поддержку рантаймов Node.js, Go и Python для облачных функций. Задействуется при проектировании серверных API, бэкенд-логики и паттернов Express или Koa. CX Codex +1 299установок edgeone-makers-deploy Скилл edgeone-makers-deploy для Claude Code деплоит фронтенд- и фулстек-проекты на Tencent EdgeOne Makers. Включается при запросах на публикацию сайта, превью или анонимный деплой без создания аккаунта. CX Codex +1 285установок edgeone-makers-agents Скилл edgeone-makers-agents для Claude Code помогает создавать и проверять эндпоинты ИИ-агентов на EdgeOne Makers с пятью фреймворками. Включается при настройке LangGraph или SSE-потоков. CX Codex +1 260установок edgeone-makers-storage Скилл edgeone-makers-storage для Claude Code настраивает хранилище на платформе EdgeOne Makers. Помогает подключить KV для Edge Functions и организовать постоянное хранение данных через Blob в Cloud Functions. CX Codex +1 250установок edgeone-makers-env-adaption Скилл edgeone-makers-env-adaption для Claude Code задаёт правила работы EdgeOne Makers в изолированных средах. Включается в WorkBuddy и IDE-песочницах, где зависают запросы CLI или сеть проходит через прокси. CX Codex +1 249установок edgeone-makers-recipes Скилл edgeone-makers-recipes для Claude Code, создающий структуру проектов и шаблоны для приложений EdgeOne Makers. CX Codex +1 249установок edgeone-makers-middleware Скилл edgeone-makers-middleware для Claude Code помогает писать middleware для обработки запросов на границе сети. Он задаёт правила перенаправления, переписывания URL и проверки доступа. CX Codex +1 248установок

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

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