Kaloko

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

Podle použití

SEO a kontrola landing pages na produkci, jen pro čtení, každý den

Readonly běh veřejných stránek jako návštěvník: nadpisy, metadata, hreflang, Open Graph, strukturovaná data, přetečení, konzole. Nasdílený, porovnaný se včerejškem, opravený dřív, než si toho všimne někdo jiný.

Landing page je jediná obrazovka, na kterou má názor každý a po úterním deployi ji nekontroluje nikdo. Kaloko ji projde jako návštěvník každý den, v každém jazyce a viewportu, a ukáže, co se hnulo.

Co nás pálí

Metadata se rozbíjejí potichu: description se zkrátí, hreflang ukáže na špatný jazyk, s novým skriptem přibude chyba v konzoli. Dozvíme se to z reportu za pár týdnů.

Co se změní s Kalokem

Scénář vašich veřejných stránek s počitatelnými kritérii: právě jeden H1, description aspoň 50 znaků, hreflang pro každý jazyk, žádné vodorovné přetečení, žádné chyby v konzoli, odkaz na podmínky. K tomu pár otázek na úsudek: je primární akce jasná, říká stránka, co se stane po registraci. Produkce je v Kaloku vždy jen pro čtení, cestou se nic nemůže změnit.

Jak to funguje

  1. Popište stránky

    scénář typu flow s readonly: true, krok na veřejnou stránku, path po jazycích, deterministické kontroly metadat a rozložení, sémantické otázky na srozumitelnost. Šablonou je scénář veřejných stránek Kaloka.

  2. Spusťte proti produkci

    kaloko start --scenario qa/flows/public.yml --env production, kaloko walk, kaloko evaluate, kaloko share. CLI na produkci odmítne cokoli kromě GET a blokuje cesty, které uvedete.

  3. Porovnejte se včerejškem

    kaloko compare nebo výběr *Porovnat* ukáže změněné verdikty, důkazy a pixely; tabulka metadat v lightboxu označí chybějící a duplicitní tagy.

  4. Naplánujte to

    malá úloha v CI pouští tytéž čtyři příkazy denně; na čtení výsledků stačí token jen pro čtení, na sdílení token testera. Kaloko to přesně tak dělá sám sobě.

Skilly a prompty

Napiš readonly scénář našich veřejných stránek (home, ceník, registrace, podmínky) v cs a en s kritérii na SEO a rozložení, spusť ho na produkci a nasdílej.

Očekávaný výsledek: qa/flows/public.yml s cestami po jazycích, nasdílený běh, souhrnný řádek a seznam nesplněných nebo neposouzených kritérií s důkazy.

Porovnej dnešní běh veřejných stránek se včerejším a řekni mi jen, co se změnilo v metadatech nebo rozložení.

Očekávaný výsledek: krátký seznam z porovnání; nezměněné stránky jsou pojmenované jako nezměněné.

Co dostanete

Otázky

Nahrazuje to Search Console nebo Lighthouse?

Ne. Ukazuje, co se na stránkách skutečně vykresluje a co se změnilo; pozice a výkon jsou z jiných nástrojů. Balíček pro výkon a přístupnost je v plánu.

Ukládá běh osobní údaje?

Veřejné stránky jako návštěvník žádné neobsahují; produkční scénáře držte u veřejných stránek a nikdy se tam nepřihlašujte.

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

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ěhemE‑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