Kalokoby

Všichni průvodci › Podle použití

Podle použití

Navrhujte flow se svým agentem, společně s týmem

Flow navrhnete jako živé HTML se svým agentem a skills. Tým komentuje průběžně a každá verze uloží jen to, co se změnilo.

V Kaloku navrhujete obrazovky flow jako živé HTML, společně a s agentem a design skills, které váš tým už používá. Stejný scénář pak kontroluje implementaci proti designu.

Problém

Obrázky obrazovek jsou v jednom nástroji a kód v jiném. AI artefakt ukáže jednu živou stránku, ale ne celé flow ani jeho historii, a nikdo vám později neřekne, jestli produkt designu pořád odpovídá.

Co se s Kalokem změní

Jak to funguje

  1. Přidejte designové prostředí

    do kaloko.config.yml: design: { kind: design, serve: design }.

  2. Navrhujte.

    Požádejte agenta, ať pro každý krok scénáře napíše design/<krok>/index.html, sdílené styly do design/_shared/ a tokeny do design/tokens.json.

  3. Projděte a synchronizujte.

    kaloko start --scenario qa/flows/checkout.yml --env design, kaloko walk, kaloko sync. Vykreslí se a odešlou jen změněné kroky.

  4. Revidujte společně.

    Tým otevře koncept, proklikne si kroky v režimu Živě, připíná komentáře k prvkům a označuje kroky k revizi. Agent si přečte kaloko feedback a synchronizuje znovu.

  5. Publikujte.

    kaloko share --name "Nový checkout" publikuje verzi, nebo někdo klikne na *Publikovat verzi* na plachtě.

Skills a prompty

Navrhni checkout flow do design/ podle našeho brand skillu: jedna složka na každý krok z qa/flows/checkout.yml,
sdílené CSS v design/_shared, tokeny v design/tokens.json. Pak kaloko walk a kaloko sync.
Přečti kaloko feedback na designovém prostředí, uprav, o co žádají připnuté komentáře, projdi, synchronizuj
a u každého komentáře napiš, co jsi změnil.

Jak to vypadá

Plachta konceptu ukazuje každý krok se snímkem a režimem Živě. V režimu Živě inspektor u každé hodnoty napíše její token a komentáře sedí na prvku, ke kterému patří. Karta runu vypisuje verze a referenci designu označuje hvězdičkou.

Co získáte

Další průvodci

Akceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním běhemSEO a kontrola landing pages na produkci, jen pro čtení, každý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Nainstalujte jednou, pak pracujte přes agenta

Kaloko běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev kaloko

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update kaloko.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx kaloko init --agent claude --org <your-org>

    Skill se zkopíruje do .claude/skills/kaloko. npx kaloko doctor ověří Chrome, konfiguraci a token.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    KALOKO_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator

Pak už jen zadávejte agentovi

Skill naučí vašeho agenta celou smyčku: z úkolu napíše akceptační plán a scénář, projde obrazovky, vyhodnotí je, nasdílí plachtu, přečte si připomínky a opraví je. Příkazy psát nemusíte, vy jen projdete plachtu.

Co agent spouští (nebo spusťte sami, třeba v CI)

Stejná smyčka ručně:

npx kaloko start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
npx kaloko walk        # playwright steps; agent/manual steps: kaloko capture
npx kaloko evaluate
npx kaloko share --pr
npx kaloko feedback    # what reviewers said, with ids to answer