QAwalk

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

Podle použití

Akceptace tasku s AI agentem přímo v pull requestu

Agent projde akceptační plán na localu nebo review, QAwalk zachytí každou obrazovku a e‑mail, ověří kritéria a dá do PR jeden odkaz na plachtu. Kontrolující ho tam přijme nebo vrátí.

Agent dokončil task ve 2:14 a PR říká „hotovo“. Větev nikdo neotevřel. QAwalk udělá z „hotovo“ plachtu toho, co skutečně vzniklo, s kritérii z tasku ověřenými jedno po druhém, a dá odkaz tam, kde se kontroluje.

Co nás pálí

Akceptace je pomalá, protože ten, kdo by mohl přijmout, si musí větev postavit, proklikat ji ve dvou jazycích a pamatovat si, co task chtěl. Tak přijímáme z diffu a screenshotů v chatu a druhý jazyk existuje, asi.

Co se změní s QAwalkem

Task dostane ACCEPTANCE.md: co má každá obrazovka splnit, v obyčejných větách. Agent z něj udělá scénář, projde ho a výsledkem je jedna plachta se všemi obrazovkami, kritérii s důkazy a místem, kde přijmout nebo vrátit. Kontrolující se dívá na plachtu, ne na diff.

Jak to funguje

  1. Napište plán

    ACCEPTANCE.md u tasku, řádek na obrazovku a kritérium. Tvar popisuje reference k akceptaci; co jde spočítat, má deterministickou kontrolu, úsudek dostane otázku.

  2. Projděte na localu nebo review

    qawalk start --scenario … --env local, pak qawalk walk pro skriptované kroky a qawalk capture pro ty, které agent řídí sám. Každý krok se zachytí stejně: desktop i mobil, HTML, konzole, e‑maily.

  3. Vyhodnoťte a nasdílejte

    qawalk evaluate ověří kritéria, qawalk share --pr běh nahraje a udržuje v pull requestu jeden komentář na scénář.

  4. Přijměte nebo vraťte

    kontrolující otevře plachtu, kroky schválí, nebo běh vrátí s poznámkou. Agent si poznámky načte příkazem qawalk feedback a v dalším běhu je opraví; komentář v PR se sám aktualizuje.

Skilly a prompty

Nainstalujte skill qawalk (npx qawalk init --agent claude) a ptejte se obyčejně. Skill ví, kdy projít, kdy se zeptat před sáhnutím na produkci a jak referovat.

Udělej z popisu TASK-123 ACCEPTANCE.md a scénář, projdi ho na localu a výsledek nasdílej do PR.

Očekávaný výsledek: ACCEPTANCE.md a qa/scenario.yml ve složce tasku, nasdílený běh, komentář v PR se souhrnným řádkem a odkazem na plachtu.

Přečti zpětnou vazbu k poslednímu běhu TASK-123, oprav, co bylo vráceno, a spusť to znovu.

Očekávaný výsledek: agent vypíše vrácené kroky s poznámkami kontrolujícího, změní kód, nasdílí nový běh; tentýž komentář v PR teď ukazuje na něj.

Co dostanete

Otázky

Musí si kontrolující něco instalovat?

Ne. Přihlásí se odkazem na pracovní e‑mail a plachtu čte v prohlížeči. CLI a token pro testera potřebuje jen ten, kdo běhy nahrává.

Co když kritérium nejde ověřit automaticky?

Označte ho manual. Na plachtě se ukáže jako „chce to člověka“ a kontrolující ho rozhodne tam; verdikt se uloží k běhu.

Může v jednom repozitáři pracovat víc agentů?

Ano. Každý si běh připne přes --run <id> nebo QAWALK_RUN a sdílený prohlížeč je na prostředí.

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

Regrese 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ý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

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