Njësia 7 / 11

Shkrimi dhe prioritizimi i raportit të gabimit: Regjistrime të pastra, të riprodhueshme me AI

Fitimet:

  • Aftësia për të shndërruar vëzhgimet e shpërndara në një raport që përmban një titull të qartë, hapa riprodhues përcaktues, rezultatet e pritura/aktuale dhe prova me mbështetjen e inteligjencës artificiale
  • Të jesh në gjendje t'i imponosh inteligjencës artificiale rregullin "përdor vetëm informacionin që unë jap, mos e kompenso" dhe garanton riprodhueshmëri me kontrollin e vet
  • Të jesh në gjendje të dallosh midis ashpërsisë (ndikimi teknik) dhe përparësisë (urgjenca e biznesit) dhe të japësh etiketën përfundimtare me kontekstin e biznesit

Defekti që gjen testuesi është i vlefshëm vetëm nëse rregullohet; Rregullimi i tij varet kryesisht nga cilësia e raportit të gabimeve - një regjistrim që dokumenton një defekt në një mënyrë që zhvilluesi mund ta kuptojë, riprodhojë dhe rregullojë atë. Një raport i gabimeve i shkruar keq ("hyrja nuk funksionon") do ta ngecë zhvilluesin për orë të tëra, do të çojë në korrespodencën përpara dhe mbrapa dhe shpesh mbyllet si "nuk mund të riprodhohet". Një raport i mirë përfshin hapa të qartë, rezultate të pritshme dhe aktuale, informacion rreth kontekstit dhe prova. Inteligjenca artificiale (AI) është shumë e mirë në shndërrimin e vëzhgimeve tuaja të shpërndara në një raport profesional dhe të strukturuar. Por paralajmërimi qendror vlen edhe këtu: AI nuk mund të krijojë hapa që nuk i shihni; mund të plotësojë informacionin që mungon me supozime "të arsyeshme", por të pasakta. Detyra juaj është të siguroheni që çdo rresht i raportit të bazohet në atë që keni vëzhguar në të vërtetë.

Anatomia e një raporti të mirë të gabimeve

Një raport efektiv përfshin këto komponentë:

  • Titulli: i shkurtër, specifik, i kërkueshëm. Jo "Ka një gabim"; "Nuk mund të klikoni butonin "Përfundim" me më shumë se 10 artikuj në shportë (Chrome)".
  • Hapat për të riprodhuar: Të numëruara, të gjurmueshme nga e para, përcaktuese. Zhvilluesi duhet të jetë në gjendje të shohë gabimin pasi të ketë ndjekur këto hapa.
  • Rezultati i pritshëm: Çfarë duhet të kishte ndodhur sipas kritereve të pranimit.
  • Rezultati aktual: Çfarë ndodhi (mesazh gabimi, ekran, sjellje).
  • Mjedisi: Shfletuesi/pajisja, versioni, mjedisi (test/live), roli i përdoruesit, të dhënat.
  • Dëshmi: Pamja e ekranit, video, regjistri, gjurmimi i gabimit (gjurmë në rafte).
  • Ashpërsia dhe përparësia: Detajuar më poshtë.
Këshillë: Përpara se të dërgoni një raport, pyesni "nëse ia jap këto hapa dikujt tjetër, a mund ta shohin gabimin pa ndihmën time?" pyesni. Nëse përgjigja është "jo", raporti është i paplotë. AI mund ta bëjë raportin të bukur, por vetëm ju mund të garantoni riprodhueshmëri.

Dhuna dhe përparësia: dy koncepte të ngatërruara

Ashpërsia është efekti teknik i gabimit: a prishet sistemi, humbasin të dhënat apo është një gabim shtypi? Prioriteti është se sa urgjentisht duhet të rregullohet; ka të bëjë me ndikimin e biznesit. Të dyja nuk shkojnë gjithmonë në të njëjtin drejtim: shkrimi i gabuar i emrit të kompanisë në faqen kryesore është me ashpërsi të ulët, por me prioritet të lartë (reputacion). Në një rast të rrallë, një kolaps mund të jetë me ashpërsi të lartë, por me prioritet të ulët. AI ju ndihmon të bëni këtë dallim kur jepni vëzhgimin; por etiketën përfundimtare e jep ti që e njeh kontekstin e biznesit.

dhunës

shembull

prioritet

shembull

Kritik (Bllokues)

Pagesa nuk mund të kryhet

Urgjente (P1)

Humbja e të ardhurave në jetë

E lartë (major)

Raporti jep totalin e pasaktë

E lartë (P2)

Një domosdoshmëri për lëshimin e ardhshëm

E mesme (e vogël)

Gabim i rrallë i rastit të skajit

E mesme (P3)

Në një sprint të planifikuar

E ulët (e parëndësishme)

Shtrirja e butonit është joaktiv

E ulët (P4)

Kur ka mundësi

Prompt i dobët / Prompt i fortë

E dobët: "Raporto këtë gabim: pagesa nuk funksionon."
I fortë: "Përkthe vëzhgimet e mia më poshtë në formatin standard të raportit të defekteve në kod: titulli, hapat e riprodhimit (të numëruar), rezultati i pritur, rezultati aktual, mjedisi, ashpërsia dhe rekomandimi i përparësisë (i justifikuar). Përdorni vetëm informacionin që ju jap; plotësoni fushat që mungojnë, shënoni "INFORMACIONI MUNGON: ...". Gabimi "i papërcaktuar nuk është funksion" në tastierë, nuk ka asnjë problem me 11 produkte."

Prompt i fuqishëm; imponon formatin, rregullin e "përshtatjes" dhe shënimin e informacionit që mungon. Në këtë mënyrë, raporti do të jetë i saktë dhe i sinqertë.

Zbulimi i gabimeve të dyfishta

Në ekipet e mëdha, i njëjti gabim raportohet vazhdimisht. Inteligjenca artificiale mund të krahasojë raportin tuaj të ri me defektet ekzistuese të hapura dhe të raportojë dublikatat e mundshme – kjo e mban të pastër sistemin tuaj të gjurmimit të defekteve (Jira, Azure DevOps, GitHub Issues). Por kujdes: dy gabime që duken të ngjashme në sipërfaqe mund të kenë shkaqe të ndryshme rrënjësore; Krahasoni hapat e përsëritur të prodhimit dhe mjedisin e të dy raporteve përpara se të mbyllni sugjerimin "dublikatë" të AI. Një "dublikatë" e mbyllur aksidentalisht i mungon në të vërtetë një gabim i veçantë.

Nga gjurmimi i defekteve në shkakun rrënjësor: Fuqia e AI për të lexuar regjistrat

Pjesa më teknike e një raporti të defektit është shpesh gjurmimi i gabimeve (gjurmimi i stivës - një ndarje e cilës rresht kodi, me cilin zinxhir thirrjesh, shkaktoi një gabim). Shkrimet e gjata dhe komplekse mund të lodhin edhe zhvilluesin. AI lexon një regjistër me qindra rreshta dhe përmbledh në sekonda linjat më kritike, hipotezën e mundshme të shkakut rrënjësor dhe pikën e kodit ku u shkaktua gabimi. Kjo njëkohësisht shkurton raportin dhe i jep zhvilluesit një pikënisje të drejtpërdrejtë.

Sidoqoftë, mbani mend dy kufij. Së pari, shkaku kryesor i dhënë nga AI është një hipotezë, jo provë; Zhvilluesi nuk duhet të përpiqet ta rregullojë këtë pa e verifikuar. Së dyti, regjistrat shpesh përmbajnë të dhëna personale (email, ID e përdoruesit, shenjë e sesionit); Maskojini këto zona përpara se të vendosni trungun në automjet. Një praktikë e mirë është që së pari t'i kërkohet AI të thotë "listoni fushat që duhet të maskohen në këtë regjistër" dhe më pas të analizoni regjistrin e pastruar.

Këshillë: Në vend që të ngjisni të gjithë regjistrin në raport, përfshini 3-5 rreshtat më kritikë që AI përmbledh dhe një lidhje me regjistrin e plotë. Në këtë mënyrë raporti mbetet i lexueshëm dhe zhvilluesi që ka nevojë për detaje mund të hyjë në regjistrin e plotë.

Katër shabllone të kopjueshëm

1) Nga vëzhgimi në raport:

Roli juaj: i lartë SC. Përkthejeni vëzhgimet e mëposhtme të papërpunuara në një raport standard të defekteve: Titulli / Hapat e riprodhimit (të numëruar) / E pritshme / Aktuale / Mjedisi / Shënimi i provave / Ashpërsia + Prioriteti (i justifikuar). RREGULLI: përdorni vetëm informacionin që ju jap; shëno fushën që mungon si "INFORMACIONI I MUNGON:..." Vëzhgime: [shënime të papërpunuara]

2) Kontrolli i riprodhueshmërisë:

Lexoni këtë raport të defektit nga këndvështrimi i një zhvilluesi që nuk e ka parë kurrë defektin. Ndiqni hapat dhe shënoni vendet ku nuk do të prodhojë defektin: hap i paqartë, parakusht që mungon, të dhëna të testimit që mungojnë, kusht i anashkaluar. Më tregoni se çfarë informacioni duhet të shtoj për çdo boshllëk. Raporti: [ngjit raportin]

3) Këshilltari i ashpërsisë/përparësisë:

Unë përshkruaj gabimin e mëposhtëm: [gabim + konteksti i biznesit]. Jepni sugjerime dhe arsyetime veçmas për ashpërsinë (ndikimi teknik) dhe prioritetin (urgjenca e biznesit). Shpjegoni pse të dyja mund të jenë të ndryshme. Unë do të marr vendimin përfundimtar.

4) Përmbledhja e gjurmimit të regjistrit/gabimit:

Ekzaminoni gjurmimin/login e gabimit më poshtë. Më jep një përmbledhje të (1) hipotezës së shkakut rrënjësor, (2) pikës së mundshme të kodit ku ka ndodhur gabimi, (3) 3 linjave më kritike për t'i shtuar raportit. Maskë nëse ka të dhëna personale. Regjistri: [paste log]

tre mini kuti

Rasti 1 - Çlirimi nga "Unë nuk mund të prodhoja". Në një ekip, 30% e gabimeve u mbyllën pasi "nuk mund të riprodhohen". Modeli i "kontrollit të riprodhueshmërisë" është shtuar në procesin e raportit; Përpara se çdo raport të dërgohej, AI shënonte hapat dhe parakushtet që mungonin. Tre muaj më vonë, norma "nuk mund të prodhonte" ra nga 30% në 8%. Dallimi ishte se hapat ishin të saktë që në fillim.

Rasti 2 - Rreziku i hapave të rremë. Një testues i kërkoi AI të shkruante një raport me vëzhgime jo të plota; AI shtoi një hap që nuk ka ndodhur kurrë, si p.sh. "përdoruesi ndez njoftimet nga faqja e cilësimeve". Kur zhvilluesi ndoqi atë hap, ai nuk mundi të gjente gabimin dhe humbi kohën. Ekipi zbatoi një rregull "përdorni vetëm informacionin që ju jap, mos e krijoni atë"; Hapat e sajuar eliminohen.

Rasti 3 - Dallimi i ashpërsisë/përparësisë. Kishte një gabim shtypi në sloganin e kompanisë në faqen kryesore. Testuesi do ta kalonte këtë si "të ulët"; Konsulenti i AI kujtoi se dhuna teknike është e ulët, por prioriteti i biznesit është i lartë (elementi i reputacionit që merr çdo vizitor). Defekti u rregullua në të njëjtën ditë me etiketën "prioritet i lartë".

Gabimet e zakonshme

  • Titulli i paqartë. Tituj të pakërkueshëm, jodiskriminues si "Nuk funksionon".
  • Mungojnë/kapërcehen hapat. Mos shkruani atë që është e dukshme në kontekstin tuaj; dështimi i zhvilluesit për të prodhuar.
  • Lëreni që AI të krijojë atë. Mbajtja e informacionit që mungon me një "vlerësim të arsyeshëm"; hapa të gabuar.
  • Mos shkrimi i rezultatit të pritur. Duke thënë "gabim", por duke mos specifikuar se çfarë është e drejtë.
  • Dhuna e ngatërruar dhe prioriteti. Gabimi i të dyve si një etiketë; Vlerësimi i gabuar i ndikimit të biznesit.
  • Të dhëna të ndjeshme në prova. Ndarja e të dhënave reale personale në pamjet e ekranit/regjistrat pa i maskuar ato.

Në përmbledhje

Vlera e raportit të defekteve është se zhvilluesi mund të riprodhojë dhe rregullojë defektin pa ndihmën tuaj. AI është shumë i mirë në shndërrimin e vëzhgimeve të shpërndara në një raport profesional dhe të strukturuar; Ai organizon titullin, hapat, rezultatin e pritshëm/aktual, mjedisin dhe provat, dhe ofron konsulencë për dallimin midis ashpërsisë dhe përparësisë. Por AI mund të kompensojë informacionin e munguar; Zbatoni rregullin "përdorni vetëm informacionin që ju jap, shënoni atë që mungon" dhe garantoni vetë riprodhueshmërinë. Maskojini të dhënat personale në prova.

Detyra e aplikimit

Merrni një gabim që keni gjetur kohët e fundit dhe ktheni vëzhgimet tuaja të papërpunuara në një raport duke përdorur modelin "vëzhgim për të raportuar" (me rregullin "përshtatje"). Më pas kryeni "kontrollin e riprodhueshmërisë" dhe plotësoni boshllëqet e shënuara. Jepni raportin një kolegu dhe shikoni nëse ai mund të prodhojë gabimin pa ndihmën tuaj. Së fundi, përcaktoni etiketat me "konsulentin e dhunës/përparësisë" dhe finalizoni atë sipas gjykimit tuaj. Kini parasysh çdo informacion që AI përpiqet të krijojë gjatë procesit.

listë kontrolli

  • [ ] Titulli im është specifik dhe i kërkueshëm.
  • [ ] Hapat e riprodhimit janë nga e para, përcaktuese dhe të plota.
  • [ ] Kam shkruar veçmas rezultatet e pritura dhe ato aktuale.
  • [ ] Informacioni për vendosjen dhe dëshminë është i plotë; Kam maskuar të dhënat personale.
  • [ ] Vendosa rregullin "përbëjeni, shënoni të humburit" në AI dhe i plotësova vetë boshllëqet.
  • [ ] Vlerësova veçmas ashpërsinë dhe përparësinë dhe mora vendimin përfundimtar.