# distributed-systems

Скилл distributed-systems для Claude Code — справочник паттернов для распределённых блокировок, circuit breaker, идемпотентности и ограничения запросов.

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

## Что делает

Скилл подключает набор готовых правил для надёжной архитектуры бэкенда. Внутри собрано 11 практических правил по 6 категориям: распределённые блокировки с fencing-токенами, отказоустойчивость через circuit breaker и bulkhead, ключи идемпотентности, ограничение трафика через token bucket и sliding window, а также паттерны outbox и sagas.

Каждое правило подгружается агентом из директории `rules/` по мере необходимости. Для блокировок и лимитов используются скрипты Redis Lua и отсортированные наборы, а для вызовов внешних API описаны политики повторов с экспоненциальной задержкой и джиттером.

В метаданных скилла заявлена совместимость с версией Claude Code 2.1.277 и выше. Прямой вызов пользователем отключён через `user-invocable: false`: модель обращается к файлам правил самостоятельно, когда в задаче появляется проектирование распределённых сервисов.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill distributed-systems -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill distributed-systems -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill distributed-systems -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install yonatangross/orchestkit src/skills/distributed-systems
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill distributed-systems -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/yonatangross/orchestkit --path src/skills/distributed-systems
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill distributed-systems -a opencode
```

### Claude.ai

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

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

## Когда брать
- Спроектировать распределённую блокировку в Redis с валидацией владельца и fencing-токеном
- Внедрить circuit breaker с состояниями CLOSED, OPEN и HALF_OPEN для внешнего API
- Обезопасить платежные эндпоинты через заголовки с ключами идемпотентности
- Настроить лимитер запросов token bucket с пополнением через Lua-скрипт
- Реализовать transactional outbox или сагу для надёжной доставки событий

## Примеры запросов агенту
- Добавь в FastAPI-роут обработку заголовка Idempotency-Key с дедупликацией в базе данных
- Напиши распределённую блокировку на Redis с продлением TTL через heartbeat и защитой fencing-токеном
- Сделай декоратор retry с экспоненциальным backoff и случайным jitter для вызовов стороннего сервиса

## Похожие
- [qe-chaos-resilience](https://affpapa.org/nevibecode/skills/qe-chaos-resilience.md) — скилл · 123 установки
- [release-it](https://affpapa.org/nevibecode/skills/release-it.md) — скилл · 5700 установок
- [resilience](https://affpapa.org/nevibecode/skills/resilience.md) — скилл · 4000 установок
- [marketplace-rate-limiting](https://affpapa.org/nevibecode/skills/marketplace-rate-limiting.md) — скилл · 1100 установок
- [microservices-patterns](https://affpapa.org/nevibecode/skills/microservices-patterns.md) — скилл · 13176 установок
- [microservices-architect](https://affpapa.org/nevibecode/skills/microservices-architect.md) — скилл · 5300 установок

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

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

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