Jak napsat uživatelské příběhy (s příklady a kritérii přijetí)

Uživatelský příběh je krátký popis funkce z pohledu uživatele: „Jako [typ uživatele] chci [cíl], abych [důvod].“ Pod něj napíšete kritéria přijetí, několik konkrétních podmínek, které musí platit, aby se příběh považoval za hotový. Každý příběh držte dost malý na to, aby se dal postavit a otestovat najednou, a kritéria formulujte tak, aby je mohl zkontrolovat kdokoli.

Uživatelské příběhy se proslavily v agilních softwarových týmech, ale jsou stejně užitečné, když stavíte sami s AI nástrojem na tvorbu aplikací. Dobrý příběh je dobrý prompt.

Formát

Uživatelský příběh má tři části:

Jako [kdo], chci [co], abych [proč].

• Kdo je konkrétní typ uživatele: návštěvník, který přichází poprvé, platící člen, recepční v klinice, administrátor. Ne „uživatel“.
• Co je věc, kterou chce udělat, vlastními slovy. Ne to, jak funguje obrazovka.
• Proč je výsledek, na kterém mu záleží. Je to část, kterou lidé přeskakují, a právě ona brání tomu, abyste stavěli špatnou věc.

Příklad:

Jako člen posilovny chci zrušit rezervaci lekce z telefonu, abych umožnil někomu z čekací listiny zabrat moje místo a nebyl mi účtován poplatek za nedostavení se.

„Proč“ vám řekne dvě věci, které z „co“ nevyplynuly: musí to fungovat na telefonu a jsou zapojena pravidla čekací listiny a poplatků.

Kritéria přijetí

Příběh říká, co se chce. Kritéria přijetí říkají, kdy je hotovo. Musí být dost konkrétní, aby se dva lidé shodli, zda každé z nich prošlo.

Obvyklý způsob zápisu je Za předpokladu / Když / Pak:

• Za předpokladu, že výchozí situace
• Když uživatel něco udělá
• Pak nastane tento výsledek

Pro příběh o rezervaci v posilovně:

1. Za předpokladu, že mám rezervaci více než 12 hodin předem, když klepnu na Zrušit a potvrdím, pak se rezervace odstraní a zobrazí se „Rezervace zrušena“.
2. Za předpokladu, že zruším rezervaci a lekce má čekací listinu, když se zrušení uloží, pak první člověk na čekací listině dostane místo a e-mail.
3. Za předpokladu, že rezervace je méně než 12 hodin předem, když klepnu na Zrušit, pak před potvrzením vidím, že se účtuje poplatek za pozdní zrušení.
4. Za předpokladu, že jsem na obrazovce šířky telefonu, pak je tlačítko Zrušit vidět bez posouvání do stran.

Funguje i prostý seznam, pokud je každá položka ověřitelná. „Rušení je jednoduché“ ověřitelné není. „Zrušení zabere nejvýš dvě klepnutí ze seznamu rezervací“ ověřitelné je.

Krok za krokem: jak napsat dobrý příběh

Krok 1: Začněte u skutečného uživatele a skutečného problému

Vyberte jeden typ uživatele a něco, s čím dnes bojuje. Pokud jste dělali rozhovory se zákazníky, použijte jejich slova. „Vždycky zapomenu zrušit a pak mi něco strhnou“ je lepší výchozí bod než „přidat funkci rušení“.

Krok 2: Napište příběh na jeden řádek

Vyplňte šablonu. Pokud nedokážete napsat přesvědčivé „abych“, zeptejte se, zda funkce vůbec potřebujete.

Krok 3: Přidejte tři až šest kritérií přijetí

Nejdřív pokryjte hlavní úspěšný případ, pak důležité variace: jinou roli, prázdný stav, limit, chybu. Pokud píšete víc než šest, příběh bude pravděpodobně příliš velký.

Krok 4: Poznamenejte, co je mimo rozsah

Jeden řádek ušetří hodně zbytečného dohadování: „Mimo rozsah: vrácení peněz za placené lekce; administrátoři rušící rezervace členům.“ Zabrání tomu, aby příběh během stavby narůstal.

Krok 5: Zkontrolujte ho podle INVEST

INVEST je běžný kontrolní seznam pro dobré příběhy. Příběh má být:

Nemusíte bodovat každý příběh. Nejvíc se hodí, když vám příběh připadá špatný a chcete vědět proč.

Dobré a špatné příklady

Jak rozdělit příběh, který je příliš velký

Velké příběhy jsou místo, kde projekty uvíznou. Běžné způsoby dělení:

• Podle role uživatele. Členové ruší vlastní rezervace; zaměstnanci ruší rezervace kohokoli.
• Podle kroku v postupu. Procházet lekce; rezervovat lekci; dostat připomínku.
• Nejdřív jednoduchý případ. Zrušit bezplatnou lekci hned; poplatky a vrácení peněz řešit v pozdějším příběhu.
• Podle variace dat. Nejdřív podpořit jednu pobočku, později více.
• Nejdřív šťastná cesta, pak chyby. Nejdřív ať to funguje, pak přidejte zpracování plných lekcí, propadlých permanentek a podobně.

Každý díl by měl být pořád něco, co by uživatel mohl použít a všiml by si toho.

Uživatelské příběhy jako prompty

Uživatelský příběh s kritérii přijetí je velmi blízko dobrému promptu pro AI nástroj na tvorbu aplikací. Dává AI kdo, co, proč a definici hotového. Posílejte jeden příběh v každé zprávě:

Jako člen posilovny chci zrušit rezervaci lekce z telefonu, abych umožnil někomu z čekací listiny zabrat moje místo. Kritéria přijetí:

1. Zrušit je u každé rezervace v Mých rezervacích, s krokem potvrzení.
2. Zrušení více než 12 hodin před lekcí rezervaci jen odstraní.
3. Méně než 12 hodin předem zobrazte před potvrzením „Účtuje se poplatek za pozdní zrušení 5 $“ a poplatek zapište k rezervaci.
4. Pokud má lekce čekací listinu, první člověk dostane místo a e-mail.
5. Funguje na obrazovce šířky telefonu. Mimo rozsah: vrácení peněz, rušení za členy zaměstnanci. Postav to, pak v náhledu zkontroluj každé kritérium a řekni mi, která prošla.

AI můžete také požádat, aby z hrubé myšlenky navrhla příběhy, a pak je upravte sami:

Tady je můj nápad na aplikaci: [dvě nebo tři věty]. Napiš uživatelské příběhy pro první verzi, seskupené podle typu uživatele, každý s 3 až 5 kritérii přijetí ve tvaru Za předpokladu/Když/Pak. Označ, které jsou nezbytné pro spuštění a které mohou počkat.

Výsledek vždy přečtěte a upravte. AI nezná vaše uživatele, vy ano.

Kritéria přijetí slouží zároveň jako váš testovací plán. Až je příběh hotový, projděte každé kritérium sami. Náš průvodce testováním aplikace před spuštěním na tom staví.

Kde se uživatelské příběhy hodí mezi ostatní dokumenty

• Specifikace produktu (PRD) popisuje celý produkt: problém, uživatele, rozsah. Uživatelské příběhy jsou podrobné části uvnitř ní. Viz jak napsat PRD s AI.
• Hlášení chyby popisuje něco, co je rozbité oproti příběhu, který už byl postaven. Viz jak napsat dobré hlášení chyby.
• MVP je nejmenší sada příběhů, která přináší hlavní hodnotu. Viz co je MVP.

Časté chyby

• „Jako uživatel…“ Příliš vágní. Pojmenujte skutečný typ uživatele.
• Vynechání „abych“. Bez důvodu nejde rozumně vybírat kompromisy.
• Psaní řešení místo potřeby. „Chci rozbalovací seznam“ zamkne návrh dřív, než o něm kdokoli přemýšlel.
• Kritéria, která nejdou otestovat. „Snadné“, „rychlé“ a „intuitivní“ jsou přání, ne kritéria.
• Příběhy, které jsou ve skutečnosti epiky. „Spravovat můj účet“ jsou deset příběhů.
• Psát všechny příběhy předem. Podrobně napište další několik; zbytek nechte jako jednořádková shrnutí, dokud se k nim nedostanete.

Příběhy v Mythexu

V Mythexu je režim Plan dobré místo, kde převést nápad na příběhy: agent probere postup, než cokoli upraví. Až je příběh připravený, přepněte do režimu Build a vložte ho, jeden příběh v jedné zprávě. Po každém z nich může /test proklikat náhled a zkontrolovat postup a kteroukoli odpověď můžete vrátit tlačítkem Vrátit na tento bod, pokud to šlo špatným směrem. Viz účinné prompty v dokumentaci a náš průvodce psaním promptů pro AI nástroje na tvorbu aplikací.

Kontrolní seznam uživatelského příběhu

• Pojmenovává konkrétní typ uživatele
• Popisuje potřebu, ne návrh
• Obsahuje skutečný důvod v části „abych“
• Má tři až šest ověřitelných kritérií přijetí
• Pokrývá alespoň jeden okrajový případ nebo chybu
• Uvádí, co je mimo rozsah
• Je dost malý na to, aby se postavil a otestoval na jeden zátah
• Kritéria jsou po postavení zkontrolována jedno po druhém

Otázky