HU
Csak a kenyérfigura a CRUMB-logóból: mosolygó kenyérszelet, a jobb felső sarkából kiharapva
Vissza a terembe

CRUMB

Generative Game Studio · Demo

Egysoros játékötlettől játszható vázlatig, az ágensek munkáját szem előtt tartva és beavatkozásra nyitva.

A CRUMB többágenses stúdió-keretrendszer casual játékok prototípusaihoz.

Tervezés és fejlesztés · AI kódoló ágensekkel építve

  • CLIHelyi demó
  • Webes StudioHelyi demó

A játékot építő ágensek elkülönítve az azt megítélő bizonyítékoktól.

Helyi stúdiódemó, amely egy egysoros játékötletet a specifikáción, a buildelésen és a végrehajtási ellenőrzéseken át visz végig. Minden lépés JSONL-átiratba kerül, egy tiszta reducer dönt a következő hatásokról, és mellékhatásokat csak a dispatcher hajt végre. A végrehajtási QA és a modell ítélete elkülönül, és így dől el, hogy sikeres-e az eredmény, vagy újratervezés, javítás vagy emberi irányítás következik.

Egy egysoros játékötletből a Claude Code, a Codex és a Gemini CLI ágensei a Planner → Builder → determinisztikus QA → Verifier láncon működnek együtt, a CRUMB Studio pedig megmutatja az eseményeket, az előrehaladást és az artefaktumokat, és természetes nyelvű beavatkozást fogad.

A nyilvános tárolóból klónozható és helyben futtatható demó.

Rendszertérkép · a nyilvános f5e17c0 commit kódútvonalai alapján
A CRUMB stúdiórendszereEgy ember a Studióból javasol és irányít egy játékot, a Studio pedig parancsokat ír egy inboxba. A koordinátor sorrendben adja át a reducernek az inbox és az átirat új eseményeit; a tiszta reducer dönt az állapotról és a következő hatásokról, mellékhatásokat pedig csak a dispatcher hajt végre. A Planner specifikációja, a Builder buildje és artefaktumai, a végrehajtási QA eredménye és a Verifier ítélete mind átirat-eseménnyé válik. A Verifier csak vetített bizonyítékot kap, a reducer pedig a QA eredményéhez méri és korrigálja a pontszámát: PASS esetén a munkamenet véget ér, PARTIAL esetén emberre vár, minden más újratervezésre vagy javításra megy vissza.Játékötlet · irányításEgy ember, helyben futtatvapackages/studioEsemények · artefaktumok nézetInbox-parancsok írásasrc/transcripttranscript.jsonl · append-onlysrc/loop/coordinator.tsEseményciklus · visszajátszás · tailsrc/reducerÁllapot → következő hatásokÍtélet szerinti irányítássession doneKész · PASS vagy leállási oksrc/dispatcher/live.tsHatások végrehajtása · szereplők indításaBírálói bemenet vetítésemodel-config · presetSzereplő → keretrendszer · modellagent actor · CLIPlanner Lead · specifikációBuilder · megírja a játékotartifacts/Játékfájlokdispatcher/qa-runner.tsVégrehajtási QA · ellenőrzésekVerifier actorVerifier · modellítéletsrc/validatorMegtévesztés elleni ellenőrzés · pontszám-korrekcióEmberek · StudioEseményvezérlésaz állapot forrása az átiratDolgozó ágensek · artefaktumokEllenőrzés · döntés1ötlet · irányítás2felhasználói események3redukálás sorrendben4hatások5szereplő beállítása6a Planner futtatása7spec8a Builder futtatása9fájlok10build-feljegyzés11qa_check12ami fut13qa.result1qa.result2csak bizonyíték3bírálói bemenet4judge.score5pontszám · QA-bizonyíték6korrigált ítélet7kész1korrigált ítélet2PARTIAL-ellenőrzés3újratervezés · javítás4kész5ötlet · irányítás1új események · visszajátszás2redukálás sorrendben3olvasás · SSE

Az ötlettől a játékig

Az ötletből specifikáció, build és végrehajtási QA-futtatás lesz. Minden lépés áthalad az átiraton; a szereplők nem hívják egymást.

  1. Játékötlet · irányításötlet · irányításInbox-parancsok írásapackages/studio

    Az egysoros játékötletet és a természetes nyelvű irányítást a Studióban adják meg, amely parancsokat ír az inboxba. A Studio soha nem szerkeszti közvetlenül az átiratot.

  2. Inbox-parancsok írásapackages/studiofelhasználói eseményekEseményciklus · visszajátszás · tailsrc/loop/coordinator.ts

    A koordinátor beolvassa az inbox-parancsokat, és felhasználói eseményként rögzíti őket az átiratban.

  3. Eseményciklus · visszajátszás · tailsrc/loop/coordinator.tsredukálás sorrendbenÁllapot → következő hatásoksrc/reducer

    Az élő eseményeket egyenként, sorból redukálja, megtartva az egyes események hatásainak sorrendjét; maga a továbbítás aszinkron fut.

  4. Állapot → következő hatásoksrc/reducerhatásokHatások végrehajtása · szereplők indításasrc/dispatcher/live.ts

    A reducer tiszta függvény, amely csak az állapotról és a következő hatásokról dönt: egy goal a Plannert, egy spec a Buildert, egy build egy qa_checket választ ki.

  5. Szereplő → keretrendszer · modellmodel-config · presetszereplő beállításasrc/dispatcher/live.ts

    Hogy egy szereplőt melyik keretrendszer, szolgáltató és modell futtat, a CLI-kapcsoló > konfiguráció > preset > ambient > fallback sorrendben dől el. Egy szereplő nem rögzített szolgáltató.

  6. Hatások végrehajtása · szereplők indításasrc/dispatcher/live.tsa Planner futtatásaPlanner Lead · specifikációagent actor · CLI

    A dispatcher vetített bemenettel futtatja a Plannert. A feltételes kutatás a Planner kutatási tervén és bizonyítékátadásán át folytatódik, ezen a térképen összecsukva.

  7. Planner Lead · specifikációagent actor · CLIspectranscript.jsonl · append-onlysrc/transcript

    A Planner specifikációja átirat-eseménnyé válik, és a reducer ebből választja ki a Buildert. A szereplők nem hívják egymást.

  8. Hatások végrehajtása · szereplők indításasrc/dispatcher/live.tsa Builder futtatásaBuilder · megírja a játékotagent actor · CLI

    A dispatcher futtatja a Buildert. Ha ugyanaz a szereplő ismételten hibázik, megszakító (circuit) nyílik, és adaptert vált, majd leáll, ha a hibák folytatódnak.

  9. Builder · megírja a játékotagent actor · CLIfájlokJátékfájlokartifacts/

    A Builder artefaktumként írja meg a belépőfájlt, a forrásokat és az asseteket.

  10. Builder · megírja a játékotagent actor · CLIbuild-feljegyzéstranscript.jsonl · append-onlysrc/transcript

    A build esemény és az artifact.created az artefaktum azonosságával együtt rögzül az átiratban.

  11. Hatások végrehajtása · szereplők indításasrc/dispatcher/live.tsqa_checkVégrehajtási QA · ellenőrzésekdispatcher/qa-runner.ts

    Egy build esemény után a reducer qa_check hatást bocsát ki, amely tartalmazza az artefaktum- és buildazonosságot és az elfogadási feltételeket, a dispatcher pedig végrehajtja.

  12. Játékfájlokartifacts/ami futVégrehajtási QA · ellenőrzésekdispatcher/qa-runner.ts

    A végrehajtási QA kód- és böngészőellenőrzésekkel futtatja a tényleges artefaktumot. Az alapértelmezett 120 másodperces időkorlát konfigurációs érték.

  13. Végrehajtási QA · ellenőrzésekdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Sikeres vagy sikertelen, az eredmény rendszerszintű qa.result eseményként rögzül. Még ha az ellenőrzés kivételt dob is, a hibás mezőket tartalmazó eredmény rögzül.

Az ellenőrzés bizalmi határa

A végrehajtási QA az artefaktum tényleges futtatásából származó bizonyíték; a Verifier egy vetített bizonyítékot megítélő modell. A reducer a kettőt összeveti, mielőtt kiválasztja a következő utat.

  1. Végrehajtási QA · ellenőrzésekdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Sikeres vagy sikertelen, az eredmény rendszerszintű qa.result eseményként rögzül. Még ha az ellenőrzés kivételt dob is, a hibás mezőket tartalmazó eredmény rögzül.

  2. transcript.jsonl · append-onlysrc/transcriptcsak bizonyítékBírálói bemenet vetítésesrc/dispatcher/live.ts

    A Verifier bemenete a legutóbbi goal, spec, build, qa.result és artifact.created, valamint a kiválasztott kutatási bizonyítékok vetítéséből áll. Szűkíti a kontextust; nem bizonyítja az elszigetelést vagy a szivárgás hiányát.

  3. Bírálói bemenet vetítésesrc/dispatcher/live.tsbírálói bemenetVerifier · modellítéletVerifier actor

    A dispatcher a vetített bemenettel futtatja a Verifiert.

  4. Verifier · modellítéletVerifier actorjudge.scoretranscript.jsonl · append-onlysrc/transcript

    A Verifier ítélete judge.score eseményként rögzül. Ez egy modell megítélése, nem a végrehajtásra vonatkozó tény.

  5. Állapot → következő hatásoksrc/reducerpontszám · QA-bizonyítékMegtévesztés elleni ellenőrzés · pontszám-korrekciósrc/validator

    judge.score esetén a reducer a QA eredményével, a Builder szolgáltatójával és a kutatási tervvel és bizonyítékokkal együtt átadja a megtévesztés elleni ellenőrzésnek.

  6. Megtévesztés elleni ellenőrzés · pontszám-korrekciósrc/validatorkorrigált ítéletÍtélet szerinti irányítássrc/reducer

    Sikeres végrehajtás nélküli PASS FAIL-lá válik, a végrehajtással kapcsolatos pontszámot pedig a determinisztikus QA korrigálja. A többi szabály feltételes korrekció, nem az igazmondás általános bizonyítéka.

  7. Ítélet szerinti irányítássrc/reducerkészKész · PASS vagy leállási oksession done

    PASS esetén a munkamenet done állapotban zárul. A keret- és megszakítóleállások szintén done állapotban zárulnak, de megtartják leállási okukat, így a done nem mindig PASS.

Hiba és emberi irányítás

A PARTIAL emberhez, a Critical újratervezésre, az Important vagy Minor javításra kerül, a keret- vagy megszakítóleállások pedig leállási okot hagynak.

  1. Megtévesztés elleni ellenőrzés · pontszám-korrekciósrc/validatorkorrigált ítéletÍtélet szerinti irányítássrc/reducer

    Sikeres végrehajtás nélküli PASS FAIL-lá válik, a végrehajtással kapcsolatos pontszámot pedig a determinisztikus QA korrigálja. A többi szabály feltételes korrekció, nem az igazmondás általános bizonyítéka.

  2. Ítélet szerinti irányítássrc/reducerPARTIAL-ellenőrzésJátékötlet · irányítás

    PARTIAL esetén emberi ellenőrzésre vár.

  3. Ítélet szerinti irányítássrc/reducerújratervezés · javítássrc/dispatcher/live.ts

    A FAIL és REJECT közül a Critical újratervezésre megy vissza a Plannerhez, az Important vagy Minor pedig javítási visszajelzésként a Builderhez; mind dispatcher-hatásként fut.

  4. Ítélet szerinti irányítássrc/reducerkészKész · PASS vagy leállási oksession done

    PASS esetén a munkamenet done állapotban zárul. A keret- és megszakítóleállások szintén done állapotban zárulnak, de megtartják leállási okukat, így a done nem mindig PASS.

  5. Játékötlet · irányításötlet · irányításInbox-parancsok írásapackages/studio

    Az egysoros játékötletet és a természetes nyelvű irányítást a Studióban adják meg, amely parancsokat ír az inboxba. A Studio soha nem szerkeszti közvetlenül az átiratot.

Visszajátszás és megfigyelés

Az állapot átiratból való újraépítése nem futtat hatásokat, a Studio pedig ugyanazt a feljegyzést olvassa a megjelenítéshez.

  1. transcript.jsonl · append-onlysrc/transcriptúj események · visszajátszásEseményciklus · visszajátszás · tailsrc/loop/coordinator.ts

    Az író ellenőrzi a sémát, ULID-t és időbélyeget rendel hozzá, és hozzáfűzi. Visszajátszáskor a korábbi események csak a reduceren mennek át; hatásaik nem futnak újra.

  2. Eseményciklus · visszajátszás · tailsrc/loop/coordinator.tsredukálás sorrendbenÁllapot → következő hatásoksrc/reducer

    Az élő eseményeket egyenként, sorból redukálja, megtartva az egyes események hatásainak sorrendjét; maga a továbbítás aszinkron fut.

  3. transcript.jsonl · append-onlysrc/transcriptolvasás · SSEEsemények · artefaktumok nézetpackages/studio

    A Studio olvassa az átiratot és az artefaktumokat, és SSE-n keresztül mutatja az előrehaladást, a metrikákat és az artefaktumokat. Ez nem távoli szolgáltatásnak küldött telemetria.

Minden kapcsolat azonos vastagsággal. Válasszon egy folyamatot, hogy csak annak útvonala emelődjön ki, számozott lépésekkel.

  • Folytonos · a bemenet, az eredmények és a feljegyzések iránya
  • Szaggatott · futtatás, megítélés, kérés
  • Hosszú pontozott · megfigyelés és jelentés, a megítéléstől elkülönítve
  • Vastag fekete vonal · a kiválasztott folyamat; a számok a sorrendet jelzik
  • Doboz · kód- vagy állapothatár, nevével a fejlécben
  • Belső chip · a határ egy komponense
  • Pontozott doboz · a határon kívül
  • Narancssárga körvonal · ahol egy modell dönt
  • Eseményciklus · reducer · dispatcher
  • Feljegyzések · beállítás · artefaktumok
  • Determinisztikus ellenőrzések · korrekció
  • Studio · szereplők

A nyilvános f5e17c0 commit kódútvonalai alapján rajzolva. A szereplők futásidejű szerepek, különböznek a tároló megépítéséhez használt kódoló ágensektől.

Az állapot forrása
Az átirat az állapot forrása, a reducer pedig tiszta függvény. Mellékhatásokat (szereplők futtatása, QA, fájlírás) csak a dispatcher hajt végre, így a visszajátszás hatások nélkül építi újra az állapotot.
Mire terjed ki a visszajátszás
A visszajátszás ugyanazt az állapotot adja; nem teszi determinisztikussá sem az LLM-generálásokat, sem a böngésző- és hálózati viselkedést.
Mire terjed ki egy ítélet
A végrehajtási QA csak a beállított ellenőrzéseket vizsgálja, a Verifier pontszáma pedig a bizonyítékok egyik csatornája. Egyik sem méri a játék minden viselkedését, azt, hogy szórakoztató-e, vagy a felhasználói elégedettséget.