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
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/makers-edge-functions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/makers-edge-functions/
1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a codex2Вручную: положить файлы
.agents/skills/makers-edge-functions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a cursor2Вручную: положить файлы
.cursor/skills/makers-edge-functions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TencentEdgeOne/edgeone-makers-tools skills/edgeone-makers-tools/references/makers-edge-functions2Вручную: положить файлы
.github/skills/makers-edge-functions/SKILL.md1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a gemini-cli2Командой платформы
gemini skills install https://github.com/TencentEdgeOne/edgeone-makers-tools --path skills/edgeone-makers-tools/references/makers-edge-functionsВручную: положить файлы
.devin/skills/makers-edge-functions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-edge-functions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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