# azure-cosmosdb

Скилл Claude Code разбирает partition keys, консистентность, change feed и паттерны SDK для Azure Cosmos DB; содержит примеры CRUD, иерархических ключей и cross-partition запросов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 269 установок · ★ 713 у репозитория
- Автор: alinaqi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alinaqi/maggy/tree/HEAD/skills/azure-cosmosdb/SKILL.md
- Обновлён: 2026-10-13
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/azure-cosmosdb

## Что делает

Скилл содержит примеры на TypeScript для инициализации клиента, определения типов данных и основных операций: создание, чтение по ключу, запросы с фильтрацией, пагинация, обновления с проверкой версии, удаление. Главное внимание — на проектировании partition key: показано, как выбрать ключ для равномерного распределения (userId, tenantId, deviceId), почему избегать низкой кардинальности и монотонно растущих значений, как строить иерархические ключи для multi-tenant систем.

Скилл описывает различие между point read (самое быстрое, требует id и partition key) и cross-partition queries (медленнее, но иногда необходимо). Включены паттерны работы с RU (Request Units), оптимистичного контролля версий через `_etag`, обработка ошибок 404. Для работы понадобятся переменные окружения: `COSMOS_ENDPOINT`, `COSMOS_KEY`, `COSMOS_DATABASE` или `COSMOS_CONNECTION_STRING`.

## Требования
- Работает с: Azure

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill azure-cosmosdb -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/azure-cosmosdb/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/azure-cosmosdb/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill azure-cosmosdb -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/azure-cosmosdb/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill azure-cosmosdb -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/azure-cosmosdb/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alinaqi/maggy skills/azure-cosmosdb
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/azure-cosmosdb/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill azure-cosmosdb -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/alinaqi/maggy --path skills/azure-cosmosdb
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/azure-cosmosdb/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill azure-cosmosdb -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alinaqi/maggy/tree/HEAD/skills/azure-cosmosdb/SKILL.md

## Когда брать
- Выбрать partition key, который обеспечит ровное распределение нагрузки и быстрые запросы
- Построить иерархические ключи для многоарендной системы
- Реализовать CRUD операции с type-safety на TypeScript
- Отличить point read от cross-partition запросов и понять, когда какой использовать
- Работать с пагинацией и continuation tokens при больших наборах данных

## Примеры запросов агенту
- Покажи пример partition key для системы заказов с userId
- Как сделать point read в Cosmos DB, если я знаю userId и id документа
- Напиши запрос, который вернёт все заказы пользователя, отсортированные по дате

## Похожие
- [cosmosdb-best-practices](https://affpapa.org/nevibecode/skills/cosmosdb-best-practices.md) — скилл · 1100 установок
- [azure-cosmos-ts](https://affpapa.org/nevibecode/skills/azure-cosmos-ts.md) — скилл · 1 установка
- [azure-cosmos-py](https://affpapa.org/nevibecode/skills/azure-cosmos-py.md) — скилл · 2 установки
- [cosmosdb-datamodeling](https://affpapa.org/nevibecode/skills/cosmosdb-datamodeling.md) — скилл · 8700 установок
- [azure-cosmos-db-assistant](https://affpapa.org/nevibecode/plugins/azure-cosmos-db-assistant.md) — плагин · ★ 2 у репозитория
- [azure-emulators-2025](https://affpapa.org/nevibecode/skills/azure-emulators-2025.md) — скилл · 159 установок

Из того же набора: [alinaqi/maggy](https://affpapa.org/nevibecode/by/alinaqi/maggy.md) — 61 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
