Навыки saga-orchestration
🧭

saga-orchestration

Безопасно 🌐 Доступ к сети⚙️ Внешние команды

Проектирование saga-рабочих процессов для распределенных сервисов

Распределенные рабочие процессы не работают, когда шаги не координируются или не откатываются корректно. Этот навык предоставляет четкие паттерны и шаблоны saga для оркестрации шагов и компенсаций для надежных многосервисных транзакций.

Поддерживает: Claude Codex Code(CC)
📊 71 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «saga-orchestration». Спроектируйте saga обработки заказов с компенсациями и тайм-аутами.

Ожидаемый результат:

  • Шаги: зарезервировать товары на складе, обработать оплату, создать отправку, отправить подтверждение.
  • Компенсации: освободить резервирование, вернуть оплату, отменить отправку.
  • Политика тайм-аута: завершить шаг неудачно через 5 минут и начать компенсацию.
  • События: SagaStepCompleted, SagaStepFailed, SagaCompensationCompleted.

Использование «saga-orchestration». Сравните оркестрацию и хореографию для обработки платежей.

Ожидаемый результат:

  • Оркестрация: центральный оркестратор отправляет команды, получает ответы.
  • Хореографии: сервисы генерируют события, другие подписываются и реагируют.
  • Преимущества оркестрации: явный поток, более простая отладка, четкое владение.
  • Преимущества хореографии: слабая связность, отсутствие единой точки отказа.

Использование «saga-orchestration». Как обработать шаг saga, который никогда не завершается?

Ожидаемый результат:

  • Реализуйте тайм-ауты для каждого шага в оркестраторе.
  • При тайм-ауте пометьте шаг как неудавшийся и запустите компенсацию.
  • Используйте запланированные задачи для периодической проверки статуса шага.
  • Логируйте события тайм-аута для мониторинга и оповещений.

Аудит безопасности

Безопасно
v4 • 1/17/2026

Pure documentation skill containing code templates for saga pattern implementation. Contains no executable code, filesystem access, network calls, or command execution. All static findings are false positives triggered by documentation text containing technical terminology that scanners incorrectly flag as cryptographic terms, C2 indicators, or shell commands.

2
Просканировано файлов
659
Проанализировано строк
2
находки
4
Всего аудитов

Факторы риска

🌐 Доступ к сети (3)
skill-report.json:6 SKILL.md:481 SKILL.md:482
⚙️ Внешние команды (9)
SKILL.md:23-34 SKILL.md:34-50 SKILL.md:50-237 SKILL.md:237-241 SKILL.md:241-326 SKILL.md:326-330 SKILL.md:330-416 SKILL.md:416-420 SKILL.md:420-462
Проверено: claude Посмотреть историю аудитов →

Оценка качества

38
Архитектура
100
Сопровождаемость
85
Контент
29
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Поток обработки заказов

Спроектируйте многосервисный рабочий процесс заказа с шагами компенсации и обработкой сбоев.

Длительные процессы утверждения

Смоделируйте рабочие процессы утверждения с тайм-аутами и поведением отката.

Обзор паттерна saga

Согласуйте команды по поводу компромиссов между оркестрацией и хореографией.

Попробуйте эти промпты

Базовый дизайн saga 
Спроектируйте оркестрацию saga для оформления заказа со шагами проверки наличия товаров, оплаты и доставки. Включите компенсации и переходы состояний.
Добавить тайм-ауты 
Расширьте оркестратор saga с тайм-аутами на каждый шаг и обработкой сбоев. Опишите, как тайм-ауты запускают компенсацию.
Вариант хореографии 
Предоставьте основанную на хореографии saga для обработки заказов и перечислите имена событий и обработчики.
Продвинутый план обработки сбоев 
Составьте план saga для многоэтапного процесса адаптации с повторными попытками, компенсациями и рекомендациями по аудиторскому логированию.

Лучшие практики

  • Делайте шаги идемпотентными для безопасных повторных попыток
  • Проектируйте компенсации для каждого необратимого действия
  • Используйте корреляционные ID для трассировки между сервисами

Избегать

  • Предполагать, что шаги завершаются мгновенно
  • Пропускать тестирование компенсаций
  • Тесно связывать сервисы с прямыми вызовами

Часто задаваемые вопросы

Совместимо ли это с Claude, Codex и Claude Code?
Да. Руководство является платформенно-нейтральным и работает с любым ассистентом, который может следовать шаблонам проектирования.
В чем заключаются ограничения этого навыка?
Предоставляются паттерны и шаблоны, а не готовые к использованию сервисы, хранилища или реализации обмена сообщениями.
Как интегрироваться с моей шиной сообщений?
Сопоставьте вызовы публикации и подписки с API вашей шины и сохраняйте состояние saga в вашем слое хранения данных.
Получает ли этот навык доступ к моим данным или секретам?
Нет. Содержит только статическую документацию и примеры шаблонов.
Что проверить, если шаги никогда не завершаются?
Проверьте доставку событий, сохранение состояния saga и планирование тайм-аутов.
Как это сравнивается с чистой хореографией?
Оркестрация централизует управление, в то время как хореография распределяет логику между сервисами и полагается на события.

Сведения для разработчиков

Автор

wshobson

Лицензия

MIT

Репозиторий

https://github.com/wshobson/agents/tree/main/plugins/backend-development/skills/saga-orchestration

Ссылка

main

Структура файлов

📄 SKILL.md