Nakama-jutalmak duplikációvédelme
Követhetővé és biztonságosan újrapróbálhatóvá teszi a jutalmazást. Minden jóváírást ellenőrzött eredményhez köt, hogy egy időtúllépés ne változtasson egy győzelmet több játékpénz-jutalommá.
nakama-rewards-idempotency
Nézd meg, miben segítMikor hasznos?
Akkor használd, ha pénztárca- vagy teljesítési frissítésnek újrapróbáláskor sem szabad kétszer jóváírnia az eredményt.
Miben segít neked?
- Stabil azonosítót ad a hiteles szerver által igazolt eredménynek.
- Atomi módon vagy kifejezett egyeztetéssel rögzíti a jutalmat és teljesítést.
- Elkülöníti a pénztárcarekordot az értesítéstől és bizonytalan választól.
Például ezt kérheted
A főellenfél-legyőzésért stabil eredményazonosítóval adj érmét. Sikeres írás után veszítsd el a választ, csatlakozz újra és küldd ugyanazt a kérést. Egy jutalom járjon, a nyilvántartás legyen követhető, az értesítés kézbesítése pedig ne döntse el a jóváírás létét.
Részletes dokumentáció
Itt a skill eredeti útmutatóját, példáit és ellenőrzési szempontjait olvashatod az eredeti nyelven.
Összecsukás
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.
Csomagban lévő fájlok 1
SKILL.md