QAwalk

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í QAwalk: 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 qawalk 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 QAwalkem

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 github:sinfin/qawalk#v0.1.0, pak npx qawalk init --agent claude --org <vaše-org> zkopíruje skill do .claude/skills/qawalk a vytvoří qawalk.config.yml. npx qawalk 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 qawalk browser start).

  4. Uzavřete smyčku

    po nasdílení skill čte qawalk feedback a qawalk 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 QAwalk 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 qawalk 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 QAwalku.

Jak to vypadá

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

6 z 6 kroků splněno · 2026-09-24Otevřít běh v QAwalku ↗

Další průvodci

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

Instalace ve třech krocích

QAwalk 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 github:sinfin/qawalk#v0.1.0

    Prelaunch: repozitář je zatím soukromý. O přístup požádejte Sinfin.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx qawalk init --agent claude --org <your-org>
    npx qawalk doctor

    Skill se zkopíruje do .claude/skills/qawalk.

  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:

    QAWALK_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator
  4. Spusťte a nasdílejte
    npx qawalk start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
    npx qawalk walk        # playwright steps; agent/manual steps: qawalk capture
    npx qawalk evaluate
    npx qawalk share --pr

    Nebo požádejte agenta: “Projdi akceptační plán TASK-123 s QAwalk na localu a nasdílej výsledek.”