← Zurück zu Kairo
AgentKairo

Skill · Version 1.0.0

Nakama-Belohnungen deduplizieren

Macht verdiente Belohnungen nachvollziehbar und sicher wiederholbar. Bindet jede Vergabe an ein geprüftes Ergebnis, damit ein Timeout einen Sieg nicht in mehrere Spielwährungszahlungen verwandelt.

nakama-rewards-idempotency

Entdecke, wie der Skill hilft

Wann ist der Skill hilfreich?

Nutze ihn für Wallet- oder Abschlussänderungen ohne doppelte Gutschrift bei Wiederholung.

Wobei hilft er dir?

  • Vergibt stabile Kennungen für servergeprüfte Ergebnisse.
  • Schreibt Belohnung und Abschluss atomar oder mit ausdrücklichem Abgleich.
  • Trennt Wallet-Einträge von Benachrichtigungen und unklaren Antworten.

Das könntest du fragen

Vergib nach unserem Boss-Raid Münzen mit einer stabilen Ergebniskennung. Verliere nach erfolgreichem Schreiben die Antwort, verbinde neu und wiederhole dieselbe Anfrage. Es gibt eine Belohnung, ein nachvollziehbares Journal und keine Abhängigkeit der Gutschrift von der Benachrichtigungszustellung.

Ausführliche Dokumentation

Hier findest du die ursprüngliche Anleitung, Beispiele und Prüfschritte des Skills in ihrer Originalsprache.

Details…Weniger anzeigen

Nakama — rewards idempotency

Use when implementing Nakama match rewards, purchases already authorized by the user, wallets or durable game outcomes.

Version and project gate

Inspect Nakama server and client SDK versions, chosen Go/TypeScript/Lua runtime, compiled module deployment, database topology, match handlers, RPC registrations, auth/session handling, storage collections and permission rules. Never turn a task into an engine upgrade without the user’s intent. Read the version-matching official reference when an API decision depends on it.

Work

Assign a stable operation/outcome identifier and validate the result on the authority. Define one atomic or reconciled commit boundary for reward and completion state. Preserve pending/committed/unknown distinctions and inspect uncertain outcomes before retrying. Separate accounting records from client-facing notifications.

Deliver

An outcome ledger/idempotency contract with bounded reconciliation behavior. Keep the change in the existing project structure; separate actual observations from the proposed acceptance scenario below.

Failure to prevent

A client acknowledgement or a broadcast is not evidence of a committed wallet change; never repeat an uncertain credit blindly.

Acceptance scenario

Interrupt after a durable mutation but before reply, repeat the same operation identifier and confirm one recorded outcome. Follow the project’s execution and verification permissions. If execution or a target device is unavailable, provide the reproduction steps and name the remaining uncertainty; do not mark it passed.

Scope and sources

This skill belongs to Kairo. Agent selection is restricted by Orqestria’s assigned-agent policy, including forced skill selection; instruction text alone is not an access control. These are original task workflows researched from official documentation, not a copied or endorsed vendor skill.

Enthaltene Dateien 1

  • SKILL.md