Communitygithub.com

wshobson/saga-orchestration

Implementieren Sie Saga-Muster für verteilte Transaktionen und arbeitsübergreifende Workflows. Verwenden Sie diese Fähigkeit, wenn Sie verteilte Transaktionen über Microservices implementieren, bei denen 2PC nicht verfügbar ist, kompensierende Aktionen für fehlgeschlagene Bestell-Workflows über Bestands-, Zahlungs- und Versanddienste entwerfen, ereignisgesteuerte Saga-Koordinatoren für Reisebuchungssysteme erstellen, die Hotel-, Flug- und Mietwagenreservierungen atomar zurückrollen müssen, oder festgefahrene Saga-Zustände in der Produktion debuggen, bei denen Kompensationsschritte nie abgeschlossen werden.

Was ist saga-orchestration?

Diese Fähigkeit bietet eine umfassende Unterstützung zur Implementierung von Saga-Mustern für verteilte Transaktionen und Microservices-Workflows. Sie richtet sich an Entwickler, die kompensierende Aktionen entwerfen müssen, wenn der Zwei-Phasen-Commit (2PC) nicht verfügbar ist, und ermöglicht die atomare Rückabwicklung von Vorgängen über mehrere Dienste wie Bestands-, Zahlungs- und Versandsysteme. Die Fähigkeit deckt die Implementierung sowohl orchestrierter als auch choreografierter Sagas ab, einschließlich ereignisgesteuerter Koordinatoren für komplexe Szenarien wie Reisebuchungen, und unterstützt das Debuggen festgefahrener Zustände in Produktionsumgebungen. Sie ist plattformunabhängig und kann mit jedem gängigen Microservices-Framework (z. B. Spring Boot, Quarkus, Node.js) sowie Cloud-Plattformen wie AWS, Azure oder GCP eingesetzt werden. Die SKILL.md-Dokumentation enthält detaillierte Codebeispiele, Konfigurationsanleitungen und bewährte Methoden für die Fehlerbehandlung in Saga-Workflows.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/skills/saga-orchestration

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht saga-orchestration?

Implementieren Sie Saga-Muster für verteilte Transaktionen und arbeitsübergreifende Workflows. Verwenden Sie diese Fähigkeit, wenn Sie verteilte Transaktionen über Microservices implementieren, bei denen 2PC nicht verfügbar ist, kompensierende Aktionen für fehlgeschlagene Bestell-Workflows über Bestands-, Zahlungs- und Versanddienste entwerfen, ereignisgesteuerte Saga-Koordinatoren für Reisebuchungssysteme erstellen, die Hotel-, Flug- und Mietwagenreservierungen atomar zurückrollen müssen, oder festgefahrene Saga-Zustände in der Produktion debuggen, bei denen Kompensationsschritte nie abgeschlossen werden.

Übersicht

Saga-Muster ermöglichen die Verwaltung verteilter Transaktionen in Microservices-Architekturen, indem sie diese in eine Reihe lokaler Transaktionen mit Kompensationsschritten zerlegen. Diese Fähigkeit bietet Anleitungen zur Implementierung sowohl orchestrierter als auch choreografierter Sagas.

Hauptfunktionen

  • Orchestrierte Sagas: Verwendung eines zentralen Koordinators (Saga Execution Coordinator, SEC) zur Steuerung des Ablaufs.
  • Choreografierte Sagas: Ereignisgesteuerte Abwicklung durch Nachrichtenbroker und Domain-Ereignisse.
  • Kompensationslogik: Automatische Rückabwicklung von Vorgängen bei Fehlern.
  • Statusmanagement: Überwachung und Debugging von Saga-Instanzen in Produktion.

Plattformunterstützung

Diese Fähigkeit kann mit jedem gängigen Microservices-Framework verwendet werden, einschließlich:

  • Spring Boot: Mit @Saga-Annotation und SagaOrchestrator-Bean.
  • Quarkus: Unter Verwendung von quarkus-saga und CDI-Ereignissen.
  • Node.js: Mit saga-pattern-Modul und Event-Emitters.

Sie ist auch mit Cloud-Plattformen kompatibel:

  • AWS: Verwendung von Step Functions für Saga-Koordination.
  • Azure: Einsatz von Durable Functions.
  • GCP: Nutzung von Cloud Workflows.

Implementierungsbeispiel (Spring Boot)

@Component
public class OrderSaga {
    
    @Saga
    public void executeOrderSaga(OrderCommand command) {
        try {
            // Schritt 1: Bestand reservieren
            inventoryService.reserve(command.productId, command.quantity);
            
            // Schritt 2: Zahlung verarbeiten
            paymentService.processPayment(command.userId, command.amount);
            
            // Schritt 3: Versand auslösen
            shippingService.shipOrder(command.orderId);
        } catch (Exception e) {
            // Kompensationsschritte ausführen
            compensationService.compensate(command.orderId);
        }
    }
}

Konfiguration

Erforderliche Umgebungsvariablen:

export SAGA_DATA_SOURCE_URL=jdbc:postgresql://localhost:5432/saga_db
export SAGA_DATA_SOURCE_USERNAME=saga_user
export SAGA_DATA_SOURCE_PASSWORD=secure_password
export SAGA_COMPENSATION_TIMEOUT=30000

Fehlerbehandlung und Debugging

Verwenden Sie die bereitgestellten Protokollierungs- und Überwachungswerkzeuge, um festgefahrene Saga-Zustände zu identifizieren und zu beheben:

  • Saga-Statusabfrage: Über API-Endpunkte wie /saga/{id}/status.
  • Kompensations-Wiederholungsversuche: Automatische Wiederholung fehlgeschlagener Kompensationsschritte mit exponentieller Backoff-Strategie.
  • Dead-Letter-Queue: Fehlgeschlagene Kompensationen werden für manuelle Analyse in eine DLQ verschoben.

Siehe auch

Lizenz

MIT

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/before-you-build

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

Verwandte Skills