Хэрэглэгчийн түүх хэрхэн бичих вэ (жишээ, хүлээн авах шалгууртай)

Хэрэглэгчийн түүх бол хэрэглэгчийн талаас онцлогийг товчоор тайлбарласан тодорхойлолт юм: "[хэрэглэгчийн төрөл] гэж би [зорилго]-ыг хүсдэг, ингэснээр [шалтгаан]." Түүний доор хүлээн авах шалгуур бичнэ — түүхийг дууссан гэж тооцохын тулд үнэн байх ёстой хэдэн тодорхой нөхцөл. Түүх бүрийг нэг дор бүтээж, туршиж чадах хэмжээнд жижиг байлгаж, шалгуурыг хэн ч шалгаж чадахаар бич.

Хэрэглэгчийн түүхийг сурталчилсан хөгжүүлэгчийн agile багууд түгээсэн боловч таныг AI апп builder-оор бие даан бүтээж байхад ч адил хэрэгтэй. Сайн түүх бол сайн промт.

Хэлбэр

Хэрэглэгчийн түүх гурван хэсгээс бүрддэг:

Би [хэн] гэж [юу]-ыг хүсдэг ингэснээр [яагаад].

• Хэн нь тодорхой төрлийн хэрэглэгч: анх зочилж буй хүн, төлбөр төлдөг гишүүн, эмнэлгийн регистрийн ажилтан, админ. "Хэрэглэгч" биш.
• Юу нь тэдний өөрсдийн үгээр хийхийг хүсдэг зүйл. Дэлгэц хэрхэн ажилладаг биш.
• Яагаад нь тэдний халамжилдаг үр дүн. Энэ хэсгийг хүмүүс алгасдаг бөгөөд буруу зүйл бүтээхээс сэргийлдэг.

Жишээ:

Би спорт заалны гишүүн гэж гар утаснаасаа хичээлийн захиалгаа цуцлахыг хүсдэг, ингэснээр хүлээлтийн жагсаалт дахь хэн нэгэн миний суудлыг авч, ирээгүйн торгууль надаас авагдахгүй.

"Яагаад" нь "юу" нь хэлээгүй хоёр зүйлийг хэлдэг: утсан дээр ажиллах ёстой, мөн хүлээлтийн жагсаалт болон торгуулийн дүрмүүд оролцдог.

Хүлээн авах шалгуур

Түүх нь юу хүсэгдэж байгааг хэлдэг. Хүлээн авах шалгуур нь хэзээ дууссаныг хэлдэг. Тэд хоёр хүн тус бүр тэнцсэн эсэхийг санал нийлэх хэмжээнд тодорхой байх ёстой.

Тэдгээрийг бичих түгээмэл арга бол Given / When / Then:

• Given эхлэх нөхцөл
• When хэрэглэгч ямар нэг зүйл хийвэл
• Then энэ бол үр дүн

Спорт заалны захиалгын түүхийн хувьд:

1. Given надад арван хоёр цагаас илүү хол захиалга байгаа, when би Цуцлах дээр дараад баталгаажуулвал, then захиалга устаж, "Захиалга цуцлагдлаа" гэж харагдана.
2. Given би захиалга цуцалсан ба хичээлд хүлээлтийн жагсаалт байгаа, when цуцлалт хадгалагдвал, then хүлээлтийн жагсаалтын эхний хүн суудал болон имэйл авна.
3. Given арван хоёр цагаас бага хугацааны захиалга, when би Цуцлах дарвал, then баталгаажуулахаас өмнө хожуу цуцлалтын торгууль хамаарахыг харна.
4. Given би утасны өргөнтэй дэлгэц дээр байвал, then Цуцлах товч хажуу тийш гүйлгэлгүйгээр харагдана.

Энгийн жагсаалт ч ажиллана, харин зүйл бүр туршиж чадах байх ёстой. "Цуцлах хялбар" гэдэг нь туршиж болохгүй. "Цуцлахад захиалгын жагсаалтаас хамгийн ихдээ хоёр товшилт хэрэгтэй" гэдэг нь туршиж болно.

Алхам алхмаар: сайн түүх бичих

Алхам 1: Бодит хэрэглэгч, бодит асуудлаас эхэл

Нэг төрлийн хэрэглэгч, тэд өнөөдөр ямар асуудалтай тулгардагийг сонго. Хэрэв та хэрэглэгчидтэй ярилцлага хийсэн бол тэдний үгийг ашигла. "Би цуцлахаа үргэлж мартаж, мөнгө авагддаг" гэдэг нь "цуцлах функц нэмэх" гэдгээс илүү сайн эхлэл.

Алхам 2: Нэг мөрийн түүхээ бич

Загварыг бөглө. Хэрэв итгэмтгий "ингэснээр" хэсгийг бичиж чадахгүй бол эхлээд тэр функц огт хэрэгтэй эсэхийг асуу.

Алхам 3: Гурваас зургаан хүлээн авах шалгуур нэм

Эхлээд гол амжилтын тохиолдлыг, дараа нь чухал хувилбаруудыг хамруул: өөр үүрэг, хоосон төлөв, хязгаар, алдаа. Хэрэв зургаагаас илүү бичиж байвал түүх, магадгүй хэтэрхий том байна.

Алхам 4: Хамрах хүрээнээс гадуур юу байгааг тэмдэглэ

Нэг мөр олон буцаж асуух асуултыг арилгана: "Хамрах хүрээнээс гадуур: төлбөртэй хичээлийн буцаалт; админ гишүүдийн оронд цуцлах." Бүтээх явцдаа түүх өсөхөөс сэргийлнэ.

Алхам 5: INVEST-ээр шалга

INVEST бол сайн түүхийн түгээмэл жагсаалт юм. Түүх дараах байх ёстой:

Түүх бүрийг оноолох шаардлагагүй. Түүх буруу мэдрэгдэх үед яагаад гэдгийг олох хамгийн их тустай.

Сайн ба муу жишээ

Хэт том түүхийг хэрхэн хуваах вэ

Томоохон түүхээс л төслүүд зогсдог. Хуваах түгээмэл арга:

• Хэрэглэгчийн үүргээр. Гишүүд өөрсдийнхөө захиалгыг цуцална; ажилтнууд хэний ч захиалгыг цуцална.
• Урсгалын алхмаар. Хичээлүүдийг харах; хичээлд бүртгүүлэх; сануулга авах.
• Энгийн тохиолдлыг эхэнд. Үнэгүй хичээлийг одоо цуцлах; төлбөр, буцаалтыг дараагийн түүхэнд хийх.
• Өгөгдлийн хувилбараар. Эхлээд нэг салбарыг дэмжих, дараа олныг.
• Зөв зам, дараа нь алдаанууд. Эхлээд ажиллуулж бүтээгээд, дараа нь дүүрсэн хичээл, дууссан картын зэрэг зохицуулалтыг нэм.

Хуваасан хэсэг бүр хэрэглэгч ашиглаж, мэдэж чадах зүйл байх ёстой.

Хэрэглэгчийн түүхийг промт болгон ашиглах нь

Хүлээн авах шалгуур бүхий хэрэглэгчийн түүх нь AI апп builder-т зориулсан сайн промтод маш ойрхон. Энэ нь AI-д хэн, юу, яагаад, мөн дууссан гэдгийн тодорхойлолтыг өгдөг. Мессеж бүрт нэг түүх илгээ:

Би спорт заалны гишүүн гэж гар утаснаасаа хичээлийн захиалгыг цуцлахыг хүсдэг, ингэснээр хүлээлтийн жагсаалт дахь хэн нэгэн миний суудлыг авч чадна. Хүлээн авах шалгуур:

1. Цуцлах нь Миний захиалгууд доорх захиалга бүрт байх ба баталгаажуулах алхамтай.
2. Хичээлээс арван хоёр цагаас илүү өмнө цуцлахад захиалга зүгээр л устана.
3. Арван хоёр цагаас бага үлдсэн бол баталгаажуулахаас өмнө "5 долларын хожуу цуцлалтын торгууль хамаарна" гэж харуулж, торгуулийг захиалгад бүртгэ.
4. Хичээлд хүлээлтийн жагсаалт байвал эхний хүн суудал болон имэйл авна.
5. Утасны өргөнтэй дэлгэц дээр ажиллана. Хамрах хүрээнээс гадуур: буцаалт, ажилтнууд гишүүдийн оронд цуцлах. Үүнийг бүтээгээд, урьдчилан харах дээр шалгуур тус бүрийг шалгаж, аль нь давсныг надад хэл.

Мөн та AI-аас бүдүүлэг санаанаас түүх ноорог гаргуулж, дараа нь өөрөө засаж болно:

Миний аппын санаа: [хоёр-гурван өгүүлбэр]. Анхны хувилбарт зориулсан хэрэглэгчийн түүхүүдийг хэрэглэгчийн төрлөөр бүлэглэн бич, тус бүрд 3–5 Given/When/Then хүлээн авах шалгуур нэм. Хөөргөхөд заавал хэрэгтэй, хойшлуулж болох зүйлсийг тэмдэглэ.

Үр дүнг үргэлж уншиж, засаарай. AI таны хэрэглэгчдийг мэдэхгүй; та мэднэ.

Мөн хүлээн авах шалгуур нь таны туршилтын төлөвлөгөө болдог. Түүх бүтээгдсэний дараа шалгуур бүрийг өөрөө алхаж шалгаарай. Аппаа нээлтээс өмнө туршихтай холбоотой аппаа нээлтээс өмнө хэрхэн турших вэ гарын авлага энэ дээр суурилдаг.

Хэрэглэгчийн түүх бусад баримттай хаана таарч байна вэ

• Бүтээгдэхүүний шаардлагын баримт нь бүх бүтээгдэхүүнийг дүрсэлдэг: асуудал, хэрэглэгчид, хамрах хүрээ. Хэрэглэгчийн түүхүүд нь түүний дотор байрлах дэлгэрэнгүй хэсгүүд юм. AI-аар PRD бичих үзэх.
• Алдааны тайлан нь аль хэдийн бүтээгдсэн түүхтэй харьцуулахад эвдэрсэн зүйлийг дүрсэлдэг. Сайн алдааны тайлан бичих үзэх.
• MVP нь гол үнэ цэнийг хүргэх хамгийн бага түүхийн багц юм. MVP гэж юу вэ үзэх.

Түгээмэл алдаанууд

• "Хэрэглэгч гэж би..." Хэт ерөнхий. Хэрэглэгчийн бодит төрлийг нэрлэ.
• "Ингэснээр" хэсгийг алгасах. Шалтгаангүйгээр ухаалаг сонголт хийх боломжгүй.
• Хэрэгцээний оронд шийдлийг бичих. "Би dropdown хүсдэг" гэвэл хэн ч бодохоос өмнө дизайныг түгжинэ.
• Туршиж болохгүй шалгуур. "Хялбар", "хурдан" болон "ойлгомжтой" нь шалгуур биш, хүсэл юм.
• Үнэндээ эпик байгаа түүхүүд. "Дансаа удирдах" гэдэг нь арван түүх юм.
• Бүх түүхийг урьдчилан бүгдийг бичих. Дараагийн хэдэн түүхийг дэлгэрэнгүй бич; үлдсэнийг хүртэл нэг мөрөөр хадгал.

Mythex дээрх түүхүүд

Mythex-д санааг түүх болгох сайн газар бол Plan горим: агент ямар нэг зүйлийг засахаас өмнө арга барилаа ярилцдаг. Түүх бэлэн болсон үед Build руу шилжин буулгаж, мессеж бүрт нэг түүх оруул. Бүрийн дараа /test урьдчилан харах дээр дарж урсгалыг шалгаж болох ба буруу болбол аль ч хариултыг Энэ цэг рүү буцаах замаар буцааж болно. Баримт бичгийн үр дүнтэй промтууд болон AI апп builder-т промт бичих гарын авлагыг үз.

Хэрэглэгчийн түүхийн хяналтын жагсаалт

• Хэрэглэгчийн тодорхой төрлийг нэрлэсэн
• Дизайн биш, хэрэгцээг дүрсэлсэн
• Жинхэнэ "ингэснээр" шалтгаан орсон
• Гурваас зургаан туршиж болох хүлээн авах шалгууртай
• Ядаж нэг ирмэг тохиолдол эсвэл алдааг хамарсан
• Хамрах хүрээнээс гадуур юу байгааг заасан
• Нэг удаад бүтээж, туршиж чадах хэмжээнд жижиг
• Бүтээсний дараа шалгуурыг нэг нэгээр шалгасан

Асуултууд