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

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

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

Что делает 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-code

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

~/.claude/skills/makers-storage/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и API» →
azure-storage-blob-ts Microsoft Скилл azure-storage-blob-ts учит агента работать с хранилищем Azure Blob Storage через библиотеку @azure/storage-blob на Node.js и TypeScript. Пригодится при загрузке файлов и настройке токенов SAS. CX Codex +1 1установок azure-blob-storage MicrosoftDocs Разработки. Помогает настраивать Azure Blob Storage, выбирать уровни доступа, отлаживать BlobFuse2 и писать код интеграций. CX Codex +1 348установок tencentcloud-edgeone acedatacloud Управляет зонами Tencent Cloud EdgeOne: очищает и прогревает CDN-кэш, работает с DNS-записями и показывает настройки WAF. Выполняет задачи после деплоя и проверяет конфигурацию. CX Codex +1 217установок azure-storage Microsoft Скилл azure-storage помогает работать с хранилищами Azure: загружать блобы, выбирать уровни доступа и настраивать очереди. Пригодится при настройке инфраструктуры и работе с SDK. CX Codex +1 3установок edgeone aahl Публикует HTML-контент на EdgeOne Pages и возвращает публичный URL. Работает без логина и без API-ключа. CX Codex +1 2 300установок firebase sickn33 Помогает проектировать архитектуру Firebase, настраивать правила безопасности Firestore и писать Cloud Functions под реальные сценарии запросов. CX Codex +1 1 600установок

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

Весь набор →
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-edge-functions Скилл edgeone-makers-edge-functions для Claude Code описывает разработку Edge Functions на EdgeOne Makers. Агент подключает его при работе с файлами edge-functions/** и functions/**. CX Codex +1 253установок 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установок edgeone-makers-migration Скилл edgeone-makers-migration для Claude Code, который переносит существующие проекты агентов на платформу EdgeOne Makers. Автоматизирует адаптацию структуры, API-маршрутов и интеграцию с инструментами платформы. CX Codex +1 152установок

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

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