# spring-boot-saga-pattern

Скилл для распределённых транзакций в микросервисах на Spring Boot: хореография и оркестрация, компенсирующие операции, Kafka, RabbitMQ, Axon.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3800 установок · ★ 363
- Автор: giuseppe-trisciuoglio
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/skills/spring-boot-saga-pattern/SKILL.md
- Обновлён: 2026-09-10
- HTML: https://affpapa.org/nevibecode/skills/spring-boot-saga-pattern

## Что делает

Скилл помогает разложить распределённую транзакцию на цепочку локальных транзакций с компенсациями вместо two-phase commit. Внутри — порядок работы: сначала спроектировать поток операций и для каждого шага найти обратный, потом выбрать подход. Хореография подойдёт для новой системы с небольшим числом участников, оркестрация — когда процессов много и логика уже существует.

Дальше скилл ведёт по реализации: сервисы с локальными ACID-транзакциями, идемпотентные компенсации, настройка Kafka с обработчиком ошибок, оркестратор с сохранением состояния саги, обработчики событий для хореографии. Отдельный шаг — метрики: длительность выполнения саги, число компенсаций, доля отказов и зависшие саги через Prometheus.

Компенсация обязана выполняться безопасно несколько раз — скилл советует опираться на ограничения в базе или таблицы дедупликации. Состояние саги хранится в постоянном хранилище, иначе после падения сервиса восстановить процесс не получится. Для вызовов между сервисами предлагаются circuit breakers, а для сообщений, исчерпавших лимит повторов, — dead-letter queues.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-saga-pattern -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-saga-pattern -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-saga-pattern -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install giuseppe-trisciuoglio/developer-kit spring-boot-saga-pattern
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-saga-pattern -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/giuseppe-trisciuoglio/developer-kit --path plugins/developer-kit-java/skills/spring-boot-saga-pattern
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-saga-pattern -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/skills/spring-boot-saga-pattern/SKILL.md

## Когда брать
- разложить распределённую транзакцию на локальные шаги с компенсациями
- заменить two-phase commit в микросервисах на сагу
- сделать компенсирующую операцию идемпотентной
- выбрать между хореографией и оркестрацией для конкретного процесса
- настроить метрики и алерты по зависшим сагам

## Примеры запросов агенту
- Спроектируй сагу для оформления заказа: Order → Payment → Inventory → Shipment, с компенсацией на каждом шаге
- Покажи оркестратор саги на Kafka с сохранением состояния в SagaStateRepository
- Как сделать refundPayment идемпотентным, если событие payment.failed приходит дважды?

## Похожие
- [spring-boot](https://affpapa.org/nevibecode/skills/claude-mpm-team-spring-boot.md) — скилл · 309 установок
- [spring-boot-engineer](https://affpapa.org/nevibecode/agents/spring-boot-engineer.md) — субагент · 336 установок
- [saga-orchestration](https://affpapa.org/nevibecode/skills/saga-orchestration.md) — скилл · 10700 установок
- [spring-boot-development](https://affpapa.org/nevibecode/skills/spring-boot-development.md) — скилл · 534 установки
- [321-frameworks-spring-boot-testing-unit-tests](https://affpapa.org/nevibecode/skills/321-frameworks-spring-boot-testing-unit-tests.md) — скилл · 387 установок
- [spring-boot-patterns](https://affpapa.org/nevibecode/skills/spring-boot-patterns.md) — скилл · 322 установки

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 96 карточек

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