QAwalk

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

Podle použití

E‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Potvrzení registrace, účtenka objednávky, reset hesla. QAwalk zachytí e‑mail z Mailpitu nebo letter_openeru jako krok flow, ověří předmět a odkazy a ukáže ho na plachtě vedle formuláře.

Formulář funguje. E‑mail říká „Dobrý den {{first_name}}“. Každý tým to jednou poslal; QAwalk dělá ze zprávy krok flow, takže se na ni dívá spolu s obrazovkami kolem.

Co nás pálí

E‑maily žijí mimo prohlížeč, takže je end‑to‑end testy přeskočí nebo ověří jen předmět. Vykreslenou zprávu v obou jazycích nevidí nikdo, dokud ji nevidí zákazník.

Co se změní s QAwalkem

Krok typu email ve scénáři. qawalk mail počká na zprávu v testovací schránce (Mailpit na stagingu, letter_opener lokálně v Rails projektech), zachytí ji jako obrazovku a kritéria ověří předmět, odesílatele, odkazy a text. Na plachtě e‑mail sedí hned za formulářem, který ho vyvolal.

Jak to funguje

  1. Unikátní adresa na běh

    qawalk start vypíše testovací adresu (qa+<běh>@…); agent ji použije ve formuláři, aby běh našel své zprávy.

  2. Vyvolejte a zachyťte

    po kroku s formulářem qawalk mail --step confirmation --locale cs počká na zprávu a uloží ji s vykresleným HTML i prostým textem.

  3. Ověřte

    deterministická kritéria na předmět a odkazy (potvrzovací odkaz musí vést na váš host), sémantická otázka na tón a úplnost, screenshot pro lidi.

  4. Kontrola

    kontrolující vidí formulář a e‑mail vedle sebe po jazycích a schválí nebo vrátí je jako kterýkoli jiný krok.

Skilly a prompty

Projdi registrační flow na localu včetně potvrzovacího e‑mailu v cs a en a ověř, že odkaz v mailu otevře stránku účtu.

Očekávaný výsledek: obrazovky formuláře a účtu, e‑mailový krok na jazyk s předmětem a odesílatelem, kritéria na cíl odkazu, nasdílená plachta.

Co dostanete

Otázky

Které schránky jsou podporované?

Mailpit (mail.provider: mailpit s URL) a Rails letter_opener (mail.provider: letter_opener, složka tmp/letter_opener). Jiné přes malý adaptér; ozvěte se.

Může agent kliknout na odkaz v e‑mailu?

Ano: tělo zprávy má skript kroku k dispozici, takže Playwright krok odkaz otevře a další obrazovka je samostatný krok.

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ý den

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