Kalokoby

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

Podle použití

Safari, Firefox, telefony a tmavý režim v jednom běhu

Stejné flow projdete v Chromiu, WebKitu i Firefoxu, na předvolbách telefonů, tabletů i televize, ve světlém i tmavém režimu a každou kombinaci zkontrolujete na jedné plachtě.

V hlášení chyby stojí „na iPhonu je tlačítko pod klávesnicí“ a tým to zkouší v Chromu na notebooku. Kaloko projde flow v enginu Safari na obrazovce velikosti iPhonu, v barevném režimu, který zákazník používá, a postaví to vedle záchytu z Chromu.

Co nás pálí

Většina týmů kontroluje jeden prohlížeč v jedné velikosti ve světlém režimu. Safari, malé telefony, tablety, tmavý režim a omezený pohyb se řeší, až si zákazník stěžuje, a pak ručně na jednom zařízení.

Co se změní s Kalokem

Prohlížeče, předvolby zařízení, barevné schéma, omezený pohyb, vynucené barvy i režim nainstalované aplikace jsou rozměry běhu, stejně jako jazyky a viewporty. Každá kombinace se zachytí a zkontroluje; plachta mezi nimi přepíná vedle jazyka a stejný krok z jiného prohlížeče ukáže vedle sebe.

Jak to funguje

  1. Jednou nainstalujte enginy

    npx kaloko browser install --browsers webkit,firefox na každém počítači nebo v úloze CI.

  2. Vyjmenujte, co potřebujete

    ve scénáři (browsers: [chromium, webkit], color_schemes: [light, dark], viewports: [iphone-se, pixel-8, ipad-landscape, laptop]) nebo pro jeden běh: kaloko start … --browsers chromium,webkit --color-schemes light,dark --viewports iphone-se,desktop-hd.

  3. Projděte

    kaloko walk projde běh jednou pro každý engine a profil zařízení. kaloko walk --browsers webkit projde jen záchyty běhu ve WebKitu.

  4. Vyberte předvolby

    kaloko devices vypíše telefony od malých po velké, skládací telefony, tablety, notebook, desktop a šířky televize. Předvolba nastaví velikost obrazovky, poměr pixelů, dotyk i user agent; <předvolba>-landscape ji otočí naležato.

  5. Zkontrolujte

    na plachtě přepnete prohlížeč a schéma, otevřete rámeček zařízení, nebo stisknete G a uvidíte krok ve všech jazycích a viewportech najednou, na požádání i ve všech prohlížečích a schématech.

Skilly a prompty

Zákazník píše, že se pokladna rozbije v Safari na malém iPhonu. Projdi pokladnu na stagingu v Chromiu a WebKitu na iphone-se a obojí porovnej.

Očekávaný výsledek: běh se záchyty iphone-se a iphone-se.webkit u každého kroku a seznam kroků, které se liší, i s důkazy.

Zkontroluj stránky účtu v tmavém režimu na desktopu i mobilu a řekni mi, kde nestačí kontrast textu.

Očekávaný výsledek: tmavé záchyty každého kroku a kritéria kontrastu z packu a11y, zvlášť pro každé schéma.

Co dostanete

Otázky

Je WebKit totéž co Safari na iPhonu?

Je to engine Safari, který spouští Playwright s velikostí, poměrem pixelů, dotykem a user agentem zařízení. Chyby layoutu a enginu zachytí; zbytek zachytí skutečné zařízení.

Nebude kombinací moc?

Může být: tři viewporty, dva prohlížeče a dvě schémata dělají dvanáct screenshotů na krok a jazyk. Držte matici u toho, čeho se úkol týká; víc než 400 kombinací běh odmítne.

Jde zkontrolovat nainstalovaná PWA?

Ano. display_modes: [browser, standalone] zachytí stránku jako nainstalovanou: pravidla display-mode i matchMedia odpovídají jako standalone, ve velikosti celé obrazovky.

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