Kaloko

Všichni průvodci › Podle agenta

Podle agenta

QA s Codexem: skill ve skills/qawalk a odkaz v AGENTS.md

Jak Codex pouští Kaloko: kde skill bydlí, jak na něj ukazuje AGENTS.md, které prompty fungují a jak Codex čte zpětnou vazbu kontrolujících, než pokračuje.

Codex čte AGENTS.md a řídí se jím. kaloko init --agent codex dá skill do skills/kaloko a do AGENTS.md přidá jeden odstavec, takže akceptační průchody se stanou součástí toho, jak agent v repozitáři pracuje.

Co nás pálí

Codex je rychlý na kód a tichý k obrazovkám. S klidem mergne formulář, který na telefonu přetéká, protože ho nic nepožádalo, aby se podíval.

Co se změní s Kalokem

AGENTS.md říká: pro akceptační plány, běhy scénářů a plachtu použij skills/kaloko/SKILL.md. Skill definuje hotovo, co smí bez ptaní a co ne, a odkazuje reference pro psaní plánu, provádění kroků, čtení hodnocení a práci s prostředími.

Jak to funguje

  1. Instalace

    npm install --save-dev kaloko, npx kaloko init --agent codex --org <vaše-org>, npx kaloko doctor. Skill přistane ve skills/kaloko, AGENTS.md dostane odkaz, vznikne kaloko.config.yml.

  2. Zeptejte se

    stejné prompty jako u kteréhokoli agenta; Codex spouští příkazy CLI ze skillu ve svém sandboxu se sítí k vaší lokální aplikaci a ke službě Kaloko.

  3. Kroky, které Codex neumí naskriptovat

    označte je ve scénáři agent; Codex se řídí instrukcemi a kaloko capture --step <id> zaznamená, kam došel.

  4. Zpětná vazba

    kaloko feedback a kaloko inbox v terminálu, nebo MCP server jako zdroj HTTP nástrojů, před další iterací.

Skilly a prompty

Řiď se skills/kaloko/SKILL.md: projdi akceptační plán TASK-123 na localu, vyhodnoť, sestav a nasdílej, pak dej odkaz na plachtu do PR.
Udělej z tohoto popisu tasku ACCEPTANCE.md a qa/scenario.yml; jedno kritérium na kontrolu, sémantické otázky jen pro úsudek.

Očekávaný výsledek: soubory ve složce tasku, validní scénář (kaloko validate), nasdílený běh a jeden komentář v PR.

Co dostanete

Otázky

Sandbox a síť?

CLI mluví s vaší lokální aplikací, se sdíleným Chromem přes CDP a s kaloko.app přes HTTPS. Povolte je v sandboxu Codexu; nic dalšího není třeba.

Můžou Codex a Claude Code sdílet repozitář?

Ano: kaloko init --agent all nainstaluje obě umístění; běhy se připínají na agenta přes --run <id>.

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 Claude Code: nainstalujte skill, ptejte se obyčejně, čtěte plachtuKaloko 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