Kaloko

Všichni průvodci › Podle agenta

Podle agenta

QA s Claude Code: nainstalujte skill, ptejte se obyčejně, čtěte plachtu

Jak Claude Code pouští Kaloko: jaký skill se nainstaluje, co smí bez ptaní, na co se zeptá, které prompty fungují a jak čte zpětnou vazbu kontrolujících a inbox.

Claude Code už funkci staví. Se skillem kaloko také projde akceptační plán, zachytí obrazovky, vyhodnotí kritéria a nasdílí plachtu, a pak si přečte, co kontrolující vrátil.

Co nás pálí

Bez skillu agent QA improvizuje: stránku jednou otevře, řekne „vypadá dobře“ a jede dál. Nikdo nevidí, na co se díval.

Co se změní s Kalokem

Skill říká Claude Code, kdy je průchod na řadě, co znamená „hotovo“ (validní scénář, každý krok zachycený nebo vysvětlený, vyhodnocení a build proběhly, odkaz je na svém místě), co smí bez ptaní (prostředí local a review, testovací data tam, mechanika scénáře) a co chce nejdřív člověka (změna akceptačních kritérií, jakýkoli běh na produkci, nahrání).

Jak to funguje

  1. Instalace

    npm install --save-dev kaloko, pak npx kaloko init --agent claude --org <vaše-org> zkopíruje skill do .claude/skills/kaloko a vytvoří kaloko.config.yml. npx kaloko doctor zkontroluje Chrome, token, prostředí a klíč evaluátoru.

  2. Zeptejte se

    „Projdi akceptační plán TASK-123 na localu a nasdílej výsledek.“ Skill vede na své reference: akceptace, provedení, hodnocení, prostředí, spolupráce.

  3. Řiďte prohlížeč po svém

    Claude Code používá sdílený prohlížeč přes Playwright skript kroku nebo přes browser nástroj po MCP (CDP endpoint vypíše kaloko browser start).

  4. Uzavřete smyčku

    po nasdílení skill čte kaloko feedback a kaloko inbox, než na tasku pokračuje. Volitelně připojte MCP server, aby agent četl běhy a zpětnou vazbu jako nástroje.

Skilly a prompty

Projdi akceptační plán TASK-123 s Kaloko na localu a výsledek nasdílej do PR.
Co vrátil kontrolující u posledního běhu TASK-123? Oprav to a spusť znovu.
Porovnej poslední běh checkoutu s referenčním a vysvětli rozdíly.

Očekávaný výsledek vždy: příkazy, které skill předepisuje, souhrnný řádek, nesplněná nebo neposouzená kritéria s důkazy a odkazy na plachtu; žádný běh na produkci bez zeptání.

Co dostanete

Otázky

Potřebuje Claude Code browser nástroj?

Ne. Skriptované kroky běží přes Playwright v CLI; u kroků s úsudkem pomůže browser MCP nebo computer use, ale kaloko capture --url funguje i jen ze shellu.

Co agent posílá AI evaluátoru?

Jen zredukovanou textovou osnovu každé stránky se zamaskovanými e‑maily a tokeny, a jen u kritérií označených semantic. Screenshoty a surové HTML z vašeho počítače neodejdou jinam než do vaší organizace v Kaloku.

Jak to vypadá

Skutečný běh Kaloka nad jeho veřejnými stránkami, obnovený každý den. Tuhle plachtu dostane váš tým.

10 z 10 kroků splněno · 2026-09-29Otevřít běh v Kaloku ↗

Další průvodci

QA s Codexem: skill ve skills/qawalk a odkaz v AGENTS.mdKaloko v CI: headless běhy, tokeny jen pro čtení, jeden komentář na scénář

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 nepíšete vy, vy kontrolujete 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