QAwalk

Všichni průvodci › Podle agenta

Podle agenta

QAwalk v CI: headless běhy, tokeny jen pro čtení, jeden komentář na scénář

Stejný průchod z GitHub Actions nebo jiného CI: vestavěné Chromium, token testera na sdílení, token jen pro čtení na čtení, výsledky v PR a na plachtě.

Průchod agenta je zároveň úloha. V CI běží tytéž čtyři příkazy proti review nebo stagingu při každém pushi a PR dostane jeden komentář na scénář, který se sám aktualizuje.

Co nás pálí

Screenshoty z CI končí jako artefakty, které nikdo nestáhne. Vizuální kontroly žijí v jiném nástroji s vlastním přihlášením a vlastní představou, co je krok.

Co se změní s QAwalkem

CI spustí qawalk start, walk, evaluate, share --pr. Artefaktem je plachta, notifikací komentář v PR, verdikty dávají lidé na plachtě a čte je zpět agent nebo další úloha.

Jak to funguje

  1. Konfigurace pro CI

    kopie qawalk.config.yml bez browser.channel, aby se použilo vestavěné Chromium (npx playwright install --with-deps chromium), prostředí omezená na to, kam CI dosáhne.

  2. Tajemství

    QAWALK_TOKEN s rolí tester na sdílení běhů; TYPESAFE_API_KEY, pokud chcete v CI vyhodnocovat sémantická kritéria. Úlohám, které jen čtou výsledky nebo exportují běhy, stačí token jen pro čtení.

  3. Úloha

    checkout, npm ci, instalace Chromia, pak čtyři příkazy s --config qawalk.ci.config.yml; qawalk export, pokud chcete zip i jako artefakt.

  4. Brána

    qawalk feedback --json vrátí verdikt běhu; úloha může před deployem počkat na accepted. Denní obnova dema QAwalku je přesně taková úloha.

Skilly a prompty

Pro CI není prompt, jen workflow. Šablonou je workflow QAwalku: demo-run.yml a scripts/demo-run.mjs.

QAWALK_TOKEN=… node scripts/demo-run.mjs

Očekávaný výsledek: nasdílený běh, komentář v PR (s --pr na větvi s pull requestem), souhrnný řádek v logu úlohy.

Co dostanete

Otázky

Jak dlouho běh v CI trvá?

Zhruba minutu na deset kroků ve dvou jazycích a dvou viewportech, plus vyhodnocení. Proti produkci jsou běhy jen pro čtení a nikdy nevytvářejí data.

Může CI běh přijmout automaticky?

Ne, a o to jde: přijetí je razítko člověka. CI může zkontrolovat, že ho člověk dal.

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 Claude Code: nainstalujte skill, ptejte se obyčejně, čtěte plachtuQA s Codexem: skill ve skills/qawalk a odkaz v AGENTS.md

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.”