edgeone-makers-storage — скилл для Claude Code
Скилл edgeone-makers-storage для Claude Code настраивает хранилище на платформе EdgeOne Makers. Помогает подключить KV для Edge Functions и организовать постоянное хранение данных через Blob в Cloud Functions.
MIT 250 установок ★ 1 839 обновлён 2026-11-12
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a claude-codeЧто делает edgeone-makers-storage
Скилл задаёт правила хранения данных на платформе EdgeOne Makers, где отсутствуют традиционные базы данных вроде PostgreSQL, MySQL или MongoDB. Любые динамические данные проекта организуются через объектное хранилище Blob, а структуры таблиц моделируются префиксами ключей вида messages/<id>.json или users/<uid>.json.
Для легковесных задач в Edge Functions скилл подключает KV с лимитом до 25 МБ на пару. Переменная KV объявляется в консоли глобально: обращение идёт напрямую по имени без вызовов через context.env. Для Cloud Functions используется npm-библиотека @edgeone/pages-blob. Чтобы избежать чтения устаревших данных при частых записях, вызов хранилища строго требует формат getStore({ name, consistency: "strong" }).
Для локальной работы с Blob нужна авторизация через edgeone login или передача токена -t <token>. Команда запуска edgeone makers dev при использовании хранилищ требует обязательный флаг -n <project-name>, потому что без него CLI переходит в интерактивный выбор и зависает в автоматических средах.
Какие задачи решает
- сохранять файлы и динамические структуры сайта в Blob через
@edgeone/pages-blob - моделировать таблицы базы данных через префиксы ключей без использования SQL
- обращаться к быстрым счётчикам и сессиям через глобальный KV в Edge Functions
- предотвратить чтение устаревших записей за счёт строгой согласованности хранилища
Примеры запросов агенту
- Покажи, как сохранять профили пользователей в Blob хранилище EdgeOne
- Настрой чтение счётчика из KV внутри Edge Function без обращения к context.env
- Инициализируй хранилище через @edgeone/pages-blob со строгой согласованностью
Как установить edgeone-makers-storage
1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a claude-code2Вручную: положить файлы
~/.claude/skills/makers-storage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/makers-storage/
1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a codex2Вручную: положить файлы
.agents/skills/makers-storage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a cursor2Вручную: положить файлы
.cursor/skills/makers-storage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TencentEdgeOne/edgeone-makers-tools skills/edgeone-makers-tools/references/makers-storage2Вручную: положить файлы
.github/skills/makers-storage/SKILL.md1Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a gemini-cli2Командой платформы
gemini skills install https://github.com/TencentEdgeOne/edgeone-makers-tools --path skills/edgeone-makers-tools/references/makers-storageВручную: положить файлы
.devin/skills/makers-storage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об edgeone-makers-storage
Как установить edgeone-makers-storage в Claude Code?
Выполните команду npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-storage -a claude-code.
Что делает edgeone-makers-storage?
Он задаёт шаблоны работы с хранилищами EdgeOne Makers, заменяя привычные СУБД связкой из Blob для постоянных файлов и KV для быстрых данных в Edge Functions.
Что нужно для работы edgeone-makers-storage?
Требуется пакет @edgeone/pages-blob для Cloud Functions, авторизация через edgeone login или ключ -t <token>, а также передача параметра -n <project-name> в команду локальной разработки.
Исходный текст
SKILL.md · MIT
---
name: edgeone-makers-storage
description: >-
KV and Blob storage services on EdgeOne Makers. KV for edge key-value pairs,
Blob for file/object storage in Cloud Functions. Covers SDK usage, setup, and troubleshooting.
pathPatterns:
- edge-functions/**
validate:
- pattern: "context\\.env\\.[A-Za-z_]*[Kk][Vv]"
message: "KV is a console-bound global variable, not on context.env — call my_kv.get(...) directly. See makers-storage/references/kv.md."
metadata:
author: edgeone
version: "1.0.0"
---
# EdgeOne Makers Storage
> 🗄️ **There is NO managed database on this platform** — no SQL, no MongoDB, no Prisma, no ORM. Do **not** reach for `sqlite`, `pg`, `mysql`, `mongodb`, or an in-memory array (it resets on every cold start / redeploy). **Blob IS your database.** Any dynamic data a generated site needs to persist — guestbook messages, uploaded drawings, votes, leaderboards, per-user save state, form submissions — is modeled as Blob keys. Model your "tables" as **key prefixes** (`messages/<id>.json`, `users/<uid>.json`). See [references/blob.md](references/blob.md) → "Blob as your backend".
> ⚠️ **Local dev does NOT always require login.** `edgeone makers dev` runs without authentication for **pure-static** previews. Login only becomes necessary through this chain: **using Blob ⇒ the project must be `link`ed ⇒ linking requires a logged-in account first.** So if (and only if) dev/deploy must read/write **Blob** (or any credentialed backend), run `edgeone login` (browser) or pass `-t <token>` before linking/starting dev. **If your site has no backend, skip login and just run `edgeone makers dev`.** See also makers-env-adaption (Login authentication + Project linking).
>
> ⛔ **When the project uses Blob/KV, ALWAYS pass `-n <project-name>` to `edgeone makers dev`.** Bare `edgeone makers dev` drops into an interactive "Link existing / Create and link" picker that hangs in sandbox / non-interactive environments. With `-n`, the CLI auto-creates the project if the name doesn't exist yet — one command, no separate step needed.
>
> 🔒 **Every Blob store: `getStore({ name, consistency: "strong" })` — never the string form `getStore("name")`.** The string form defaults to eventual consistency and causes "I just wrote but the next read returns stale/null" bugs. Full rule and rationale: [references/blob.md](references/blob.md) → IRON RULE (top of file).
EdgeOne Makers provides two storage services. **Choose based on your runtime and data type:**
| Storage | Runtime | Data Type | SDK | Use Case |
|---------|---------|-----------|-----|----------|
| **KV** | Edge Functions only | Small key-value pairs (≤ 25 MB) | Global variable (no npm) | Counters, config, session tokens, simple CRUD |
| **Blob** | Cloud Functions (Makers Functions) | Files & objects (images, docs, uploads) | `@edgeone/pages-blob` (npm) | User uploads, AI-generated content, file management |
## Decision Tree
```
Need to persist anything (records, lists, counters, uploads, save state)?
├─ Edge Function (V8 runtime, no npm)?
│ → KV Storage (global variable) → read references/kv.md
└─ Cloud Function (Node.js, has npm)? ← default for any real backend
├─ Files / images / large objects?
│ → Blob Storage → read references/blob.md
└─ Structured data (records, lists, counters, per-user state)?
→ Blob with setJSON / key prefixes → read references/blob.md
```
## Routing
| Task | Read |
|------|------|
| KV Storage (Edge Functions, global variable, put/get/delete/list) | [references/kv.md](references/kv.md) |
| Blob Storage (Cloud Functions, npm SDK, file upload/download, pre-signed URLs) | [references/blob.md](references/blob.md) |
© edgeone · MIT · TencentEdgeOne/edgeone-makers-tools