Kaloko

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

Podle použití

Akceptace tasku s AI agentem přímo v pull requestu

Agent projde akceptační plán na localu nebo review, Kaloko zachytí každou obrazovku a e‑mail, ověří kritéria a dá do PR jeden odkaz na plachtu. Kontrolující ho tam přijme nebo vrátí.

Agent dokončil task ve 2:14 a PR říká „hotovo“. Větev nikdo neotevřel. Kaloko udělá z „hotovo“ plachtu toho, co skutečně vzniklo, s kritérii z tasku ověřenými jedno po druhém, a dá odkaz tam, kde se kontroluje.

Co nás pálí

Akceptace je pomalá, protože ten, kdo by mohl přijmout, si musí větev postavit, proklikat ji ve dvou jazycích a pamatovat si, co task chtěl. Tak přijímáme z diffu a screenshotů v chatu a druhý jazyk existuje, asi.

Co se změní s Kalokem

Task dostane ACCEPTANCE.md: co má každá obrazovka splnit, v obyčejných větách. Agent z něj udělá scénář, projde ho a výsledkem je jedna plachta se všemi obrazovkami, kritérii s důkazy a místem, kde přijmout nebo vrátit. Kontrolující se dívá na plachtu, ne na diff.

Jak to funguje

  1. Napište plán

    ACCEPTANCE.md u tasku, řádek na obrazovku a kritérium. Tvar popisuje reference k akceptaci; co jde spočítat, má deterministickou kontrolu, úsudek dostane otázku.

  2. Projděte na localu nebo review

    kaloko start --scenario … --env local, pak kaloko walk pro skriptované kroky a kaloko capture pro ty, které agent řídí sám. Každý krok se zachytí stejně: desktop i mobil, HTML, konzole, e‑maily.

  3. Vyhodnoťte a nasdílejte

    kaloko evaluate ověří kritéria, kaloko share --pr běh nahraje a udržuje v pull requestu jeden komentář na scénář.

  4. Přijměte nebo vraťte

    kontrolující otevře plachtu, kroky schválí, nebo běh vrátí s poznámkou. Agent si poznámky načte příkazem kaloko feedback a v dalším běhu je opraví; komentář v PR se sám aktualizuje.

Skilly a prompty

Nainstalujte skill kaloko (npx kaloko init --agent claude) a ptejte se obyčejně. Skill ví, kdy projít, kdy se zeptat před sáhnutím na produkci a jak referovat.

Udělej z popisu TASK-123 ACCEPTANCE.md a scénář, projdi ho na localu a výsledek nasdílej do PR.

Očekávaný výsledek: ACCEPTANCE.md a qa/scenario.yml ve složce tasku, nasdílený běh, komentář v PR se souhrnným řádkem a odkazem na plachtu.

Přečti zpětnou vazbu k poslednímu běhu TASK-123, oprav, co bylo vráceno, a spusť to znovu.

Očekávaný výsledek: agent vypíše vrácené kroky s poznámkami kontrolujícího, změní kód, nasdílí nový běh; tentýž komentář v PR teď ukazuje na něj.

Co dostanete

Otázky

Musí si kontrolující něco instalovat?

Ne. Přihlásí se odkazem na pracovní e‑mail a plachtu čte v prohlížeči. CLI a token pro testera potřebuje jen ten, kdo běhy nahrává.

Co když kritérium nejde ověřit automaticky?

Označte ho manual. Na plachtě se ukáže jako „chce to člověka“ a kontrolující ho rozhodne tam; verdikt se uloží k běhu.

Může v jednom repozitáři pracovat víc agentů?

Ano. Každý si běh připne přes --run <id> nebo KALOKO_RUN a sdílený prohlížeč je na prostředí.

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

Regrese 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 poslalaMobilní aplikace: projděte obrazovky Androidu a iOS jako webové stránky

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