Jinsi ya Kuandika Hadithi za Watumiaji (zenye Mifano na Vigezo vya Kukubalika)
Hadithi ya mtumiaji ni maelezo mafupi ya kipengele kutoka mtazamo wa mtumiaji: “Kama [aina ya mtumiaji], nataka [lengo] ili [sababu].” Chini yake unaandika vigezo vya kukubalika, masharti machache mahususi yanayopaswa kuwa kweli ili hadithi ihesabiwe kuwa imekamilika. Weka kila hadithi ndogo vya kutosha kujengwa na kujaribiwa kwa mkupuo mmoja, na uandike vigezo kwa namna ambayo mtu yeyote angeweza kuvikagua.
Hadithi za watumiaji zilipata umaarufu kutoka kwa timu za programu za agile, lakini ni muhimu vile vile unapojenga peke yako kwa zana ya AI ya kujenga programu. Hadithi nzuri ni agizo zuri.
Muundo
Hadithi ya mtumiaji ina sehemu tatu:
Kama [nani], nataka [nini] ili [kwa nini].
- Nani ni aina mahususi ya mtumiaji: mgeni wa mara ya kwanza, mwanachama anayelipa, mpokeaji wa kliniki, msimamizi. Si “mtumiaji” tu.
- Nini ni kitu anachotaka kufanya, kwa maneno yake. Si jinsi skrini inavyofanya kazi.
- Kwa nini ni matokeo anayojali. Ndicho sehemu watu wanachoruka, na ndicho kinachokuzuia kujenga kitu kisichofaa.
Mfano:
Kama mwanachama wa gym, nataka kughairi uhifadhi wa darasa kutoka kwenye simu yangu ili mtu aliye kwenye orodha ya kusubiri achukue nafasi yangu na nisitozwe ada ya kutokuja.
“Kwa nini” inakuambia mambo mawili ambayo “nini” haikuambia: lazima ifanye kazi kwenye simu, na orodha ya kusubiri pamoja na kanuni za ada zinahusika.
Vigezo vya kukubalika
Hadithi inasema kinachotakiwa. Vigezo vya kukubalika vinasema wakati kimekamilika. Vinapaswa kuwa mahususi vya kutosha kwamba watu wawili wangekubaliana kama kila kimoja kimepita.
Njia ya kawaida ya kuviandika ni Given / When / Then:
- Given hali ya mwanzo
- When mtumiaji anafanya jambo
- Then hili ni matokeo
Kwa hadithi ya uhifadhi wa gym:
- Given nina uhifadhi zaidi ya saa 12 mbele, when ninagusa Ghairi na kuthibitisha, then uhifadhi unaondolewa na ninaona “Uhifadhi umeghairiwa”.
- Given nimeghairi uhifadhi na darasa lina orodha ya kusubiri, when kughairi kunahifadhiwa, then mtu wa kwanza kwenye orodha ya kusubiri anapata nafasi na barua pepe.
- Given uhifadhi uko chini ya saa 12 mbele, when ninagusa Ghairi, then naona kwamba ada ya kughairi kwa kuchelewa inatumika kabla sijathibitisha.
- Given niko kwenye skrini ya upana wa simu, then kitufe cha Ghairi kinaonekana bila kusogeza pembeni.
Orodha rahisi ya ukaguzi pia inafanya kazi, mradi kila kipengee kinaweza kujaribiwa. “Kughairi ni rahisi” haiwezi kujaribiwa. “Kughairi kunachukua vibonyezo visivyozidi viwili kutoka kwenye orodha ya uhifadhi” kinaweza.
Hatua kwa hatua: kuandika hadithi nzuri
Hatua ya 1: Anza na mtumiaji halisi na tatizo halisi
Chagua aina moja ya mtumiaji na kitu anachopambana nacho leo. Ukiwa umefanya mahojiano na wateja, tumia maneno yao. “Mara zote nasahau kughairi na nakatwa pesa” ni mwanzo bora kuliko “ongeza kipengele cha kughairi”.
Hatua ya 2: Andika hadithi ya mstari mmoja
Jaza kiolezo. Ikiwa huwezi kuandika “ili” yenye kushawishi, uliza kama kipengele hicho kinahitajika kabisa.
Hatua ya 3: Ongeza vigezo vitatu hadi sita vya kukubalika
Funika kesi kuu iliyofanikiwa kwanza, kisha tofauti muhimu: jukumu tofauti, hali tupu, kikomo, hitilafu. Ukiandika zaidi ya sita, hadithi huenda ni kubwa mno.
Hatua ya 4: Taja kilicho nje ya upeo
Mstari mmoja unaokoa mazungumzo mengi: “Nje ya upeo: marejesho ya madarasa yaliyolipiwa; wasimamizi kughairi kwa niaba ya wanachama.” Unazuia hadithi isikue unapoijenga.
Hatua ya 5: Ikague dhidi ya INVEST
INVEST ni orodha ya kawaida ya ukaguzi wa hadithi nzuri. Hadithi inapaswa kuwa:
| Herufi | Maana | Jaribio la haraka |
|---|---|---|
| I | Huru | Inaweza kujengwa bila kusubiri hadithi nyingine |
| N | Inayojadilika | Inaeleza hitaji, si muundo uliowekwa |
| V | Yenye thamani | Mtumiaji angegundua kama ingetolewa |
| E | Inayokadirika | Unaweza kukisia kwa takriban ukubwa wake |
| S | Ndogo | Inajengwa na kujaribiwa kwa kikao kimoja |
| T | Inayoweza kujaribiwa | Kila kigezo cha kukubalika kinaweza kukaguliwa |
Huhitaji kupima kila hadithi. Ni muhimu zaidi hadithi inapoonekana si sahihi na unataka kujua kwa nini.
Mifano mizuri na mibaya
| Hadithi dhaifu | Tatizo | Hadithi bora zaidi |
|---|---|---|
| Kama mtumiaji, nataka dashibodi. | Hakuna mtumiaji mahususi, hakuna sababu, haiwezi kujaribiwa | Kama mmiliki wa duka, nataka kuona oda na mapato ya leo kwenye skrini moja ili nijue kwa haraka kama siku inaenda vizuri. |
| Kama msimamizi, nataka hifadhidata iwe na safu ya hali. | Inaeleza utekelezaji, si hitaji | Kama msimamizi, nataka kuweka oda kama zimetumwa ili wateja wasiendelee kutuma barua pepe wakiuliza zilipo. |
| Kama mteja, nataka kusimamia akaunti yangu. | Kubwa mno: inafunika vipengele vingi | Kama mteja, nataka kubadilisha barua pepe yangu ili risiti zifike kwenye kikasha changu kipya. |
| Kama mgeni, nataka tovuti iwe ya haraka. | Si hadithi; ni ubora ambao kila mtu anauhitaji | Iandike kama kigezo kwenye kila hadithi, au kama lengo tofauti la utendaji. |
Jinsi ya kugawanya hadithi kubwa
Hadithi kubwa ndipo miradi inapokwama. Njia za kawaida za kugawanya:
- Kwa jukumu la mtumiaji. Wanachama wanaghairi uhifadhi wao wenyewe; wafanyakazi wanaghairi wa yeyote.
- Kwa hatua ya mtiririko. Vinjari madarasa; hifadhi darasa; pata kikumbusho.
- Kesi rahisi kwanza. Ghairi darasa la bure sasa; shughulikia ada na marejesho kwenye hadithi ya baadaye.
- Kwa tofauti ya data. Saidia eneo moja kwanza, mengine baadaye.
- Njia kuu ya kazi, kisha makosa. Jenga inayofanya kazi, kisha ongeza ushughulikiaji wa madarasa yaliyojaa, pasi zilizoisha muda, na kadhalika.
Kila kipande bado kinapaswa kuwa kitu ambacho mtumiaji angeweza kukitumia na kukigundua.
Kutumia hadithi za watumiaji kama maagizo
Hadithi ya mtumiaji yenye vigezo vya kukubalika iko karibu sana na agizo zuri kwa zana ya AI ya kujenga programu. Inampa AI nani, nini, kwa nini na ufafanuzi wa kukamilika. Tuma hadithi moja kwa kila ujumbe:
Kama mwanachama wa gym, nataka kughairi uhifadhi wa darasa kutoka kwenye simu yangu ili mtu aliye kwenye orodha ya kusubiri achukue nafasi yangu. Vigezo vya kukubalika:
- Kughairi kunapatikana kwenye kila uhifadhi katika Uhifadhi Wangu, pamoja na hatua ya uthibitisho.
- Kughairi zaidi ya saa 12 kabla ya darasa kunaondoa uhifadhi tu.
- Chini ya saa 12 kabla, onyesha “Ada ya kughairi kwa kuchelewa ya $5 inatumika” kabla ya kuthibitisha, na urekodi ada kwenye uhifadhi.
- Ikiwa darasa lina orodha ya kusubiri, mtu wa kwanza anapata nafasi na barua pepe.
- Inafanya kazi kwenye skrini ya upana wa simu. Nje ya upeo: marejesho, wafanyakazi kughairi kwa niaba ya wanachama. Jenga hili, kisha kagua kila kigezo kwenye onyesho la kukagua na uniambie kipi kinapita.
Unaweza pia kumwomba AI aandae hadithi kutoka wazo lisilo kamili, kisha uzihariri mwenyewe:
Hii ndiyo wazo langu la app: [sentensi mbili au tatu]. Andika hadithi za watumiaji za toleo la kwanza, zilizopangwa kwa aina ya mtumiaji, kila moja ikiwa na vigezo 3 hadi 5 vya Given/When/Then. Weka alama ni zipi muhimu kwa uzinduzi na zipi zinaweza kusubiri.
Daima soma na uhariri matokeo. AI haijui watumiaji wako; wewe unajua.
Vigezo vya kukubalika pia vinatumika kama mpango wako wa majaribio. Hadithi inapojengwa, pitia kila kigezo mwenyewe. Mwongozo wetu wa kujaribu app yako kabla ya uzinduzi unajengwa juu ya hili.
Hadithi za watumiaji zinaingia wapi pamoja na nyaraka nyingine
- Hati ya mahitaji ya bidhaa inaeleza bidhaa yote: tatizo, watumiaji, upeo. Hadithi za watumiaji ni vipande vya kina ndani yake. Angalia jinsi ya kuandika PRD kwa AI.
- Ripoti ya hitilafu inaeleza kitu kilichovunjika dhidi ya hadithi iliyokwisha kujengwa. Angalia jinsi ya kuandika ripoti nzuri ya hitilafu.
- MVP ni seti ndogo kabisa ya hadithi zinazotoa thamani kuu. Angalia MVP ni nini.
Makosa ya kawaida
- “Kama mtumiaji…” Ni pana mno. Taja aina halisi ya mtumiaji.
- Kuruka “ili”. Bila sababu, huwezi kufanya maamuzi ya busara ya kubadilishana.
- Kuandika suluhisho badala ya hitaji. “Nataka dropdown” inafunga muundo kabla mtu hajafikiria.
- Vigezo visivyoweza kujaribiwa. “Rahisi”, “haraka” na “angavu” ni matakwa, si vigezo.
- Hadithi zinazokuwa epiki. “Simamia akaunti yangu” ni hadithi kumi.
- Kuandika kila hadithi mapema. Andika zinazofuata kwa kina; zilizobaki ziwe mistari mmoja hadi uzifikie.
Hadithi kwenye Mythex
Kwenye Mythex, hali ya Plan ni mahali pazuri pa kugeuza wazo kuwa hadithi: wakala anajadili mbinu kabla ya kuhariri chochote. Hadithi ikiwa tayari, badilisha kwenda Build na ibandike, hadithi moja kwa kila ujumbe. Baada ya kila moja, /test inaweza kubofya kwenye onyesho la kukagua na kukagua mtiririko, na unaweza kurudisha jibu lolote kwa Revert to this point likienda vibaya. Angalia maagizo madhubuti kwenye nyaraka, na mwongozo wetu wa kuandika maagizo kwa zana za AI za kujenga programu.
Orodha ya ukaguzi ya hadithi ya mtumiaji
- Inataja aina mahususi ya mtumiaji
- Inaeleza hitaji, si muundo
- Ina sababu halisi ya “ili”
- Ina vigezo vitatu hadi sita vinavyoweza kujaribiwa
- Inafunika angalau kesi moja maalum au hitilafu
- Inataja kilicho nje ya upeo
- Ndogo vya kutosha kujengwa na kujaribiwa kwa mkupuo mmoja
- Vigezo vimekaguliwa baada ya kujenga, kimoja kimoja
Maswali
Muundo wa hadithi ya mtumiaji ni upi?
Kiolezo cha kawaida ni: Kama [aina ya mtumiaji], nataka [lengo] ili [sababu]. Inafuatwa na vigezo vya kukubalika, orodha fupi ya masharti yanayopaswa kuwa kweli ili hadithi ihesabiwe kuwa imekamilika.
Vigezo vya kukubalika ni nini?
Vigezo vya kukubalika ni masharti mahususi yanayoweza kujaribiwa yanayofafanua wakati hadithi ya mtumiaji imekamilika. Mara nyingi huandikwa kama Given / When / Then: kwa kuzingatia hali ya mwanzo, mtumiaji anapofanya jambo fulani, basi matokeo fulani hutokea.
Hadithi ya mtumiaji inapaswa kuwa kubwa kiasi gani?
Ndogo vya kutosha kujengwa na kujaribiwa kwa kikao kimoja, na bado yenye thamani yenyewe. Ikiwa hadithi ina vigezo zaidi ya vitano au sita au inagusa skrini kadhaa, igawanye kwa aina ya mtumiaji, kwa hatua ya mtiririko, au kwa kesi rahisi kwanza na kesi maalum baadaye.
Je, hadithi za watumiaji zina manufaa ninapojenga kwa AI?
Ndiyo. Hadithi ya mtumiaji yenye vigezo vya kukubalika inakaribia kuwa agizo bora: inasema kipengele ni cha nani, anahitaji nini, na jinsi ya kuthibitisha kinafanya kazi. Kutuma hadithi moja kwa kila ujumbe pia kunaweka mabadiliko ya AI madogo na rahisi kujaribu.