ጥሩ የስህተት ሪፖርት እንዴት መጻፍ ይቻላል (ለAI ወይም ለገንቢ)

ጥሩ የስህተት ሪፖርት ሌላ ሰው — ገንቢ ወይም AI — ካንተ ምንም ሳይጠይቅ ያዩትን ተመሳሳይ ችግር እንዲያይ ያስችለዋል። የተወሰነ ርዕስ፣ እንደገና ለማባዛት ትክክለኛ ደረጃዎች፣ የሚጠበቀው፣ የተከሰተው፣ ቃል በቃል የተቀዳ የስህተት መልዕክት፣ እና የተከሰተበት ቦታ፦ የትኛው ገጽ፣ አሳሽ፣ መሳሪያ እና ተጠቃሚ ያስፈልገዋል። በአንድ ሪፖርት አንድ ስህተት፣ ቢረዳ ስክሪንሾት ጋር።

አብዛኞቹ ስህተቶች ለማስተካከል ከመረዳት በላይ ለመረዳት ይወስዳሉ። ግልጽ ሪፖርት የመረዳቱን ክፍል ያስወግዳል። ይህ በAI መሳሪያዎች ዘንድ ይበልጥ አስፈላጊ ነው፦ AI "ማጠናቀቂያው እንግዳ ነው" ሲባል ምን ማለትዎ እንደሆነ ተከታይ ጥያቄ መጠየቅ አይችልም፣ ስለዚህ ይገምታል — እና የተሳሳተ ግምት ሌላ ነገር ሊሰብር ይችላል።

አብነቱ

ይህን ቅዱና ሙሉት፦

ርዕስ፦ [ምን ችግር አለ፣ የት] — ለምሳሌ "የቀጠሮ ቅጹ ከምሽቱ 12 በኋላ ያሉ ሰዓቶችን ይቀበላል"

ችግሩን ለማባዛት ደረጃዎች፦
1. ...
2. ...
3. ...

የሚጠበቀው፦ [ምን መሆን አለበት]
የተከሰተው፦ [በምትኩ ምን ሆነ]

የስህተት መልዕክት፦ [ትክክለኛ ጽሑፍ፣ ካለ]
የት፦ [ገጽ/URL፣ አሳሽ፣ መሳሪያ፣ በየትኛው ተጠቃሚ ገብቶ]
ምን ያህል ጊዜ፦ [ሁልጊዜ / አንዳንድ ጊዜ / አንድ ጊዜ]
ስክሪንሾት ወይም ቀረጻ፦ [ተያይዟል]

የተቀረው መመሪያ እያንዳንዱን ክፍል ያብራራል።

ደረጃ 1፦ መጀመሪያ እንደገና ያባዙት

ከመጻፍዎ በፊት ስህተቱ እንደገና እንዲከሰት ይሞክሩ። የትኞቹ ደረጃዎች እንደሚያስፈልጉ እና ሁልጊዜ ይከሰት እንደሆነ ይማራሉ።

• ከንጹህ ሁኔታ ይጀምሩ፦ ያድሱ፣ ወይም ወጥተው ይግቡ።
• እያንዳንዱን ጠቅታ እና እያንዳንዱን የጻፉትን ነገር ያስተውሉ።
• ያንን የሚቀሰቅስ አጭሩን መንገድ ለማግኘት ይሞክሩ።
• ሁለተኛ አሳሽ ወይም መለያ ይሞክሩ። ለአንድ ተጠቃሚ ብቻ ከሆነ፣ ትልቅ ፍንጭ ነው።

ይህን ለበለጠ፣ AI-የተገነባ አፕን እንዴት ማረም ይቻላል ይመልከቱ።

ደረጃ 2፦ የተወሰነ ርዕስ ይጻፉ

ርዕሱ ምን እንደተበላሸና የት እንደሆነ መናገር አለበት፣ ዝርዝርን የሚያይ ሰው የትኛው ስህተት እንደሆነ ያውቅ ዘንድ።

ደረጃ 3፦ ትክክለኛ ደረጃዎችን ዘርዝሩ

ቁጥር ይስጧቸው። ቀጥተኛ ይሁኑ፦ የትኛው ገጽ፣ የትኛው ቁልፍ፣ ምን እንደጻፉ።

1. እንደ ደንበኛ ይግቡ (የሙከራ መለያ፦ customer@example.com)።
2. "Starter kit"ን ወደ ጋሪው ያክሉ።
3. የቅናሽ ኮዱን WELCOME10 ያስገቡና Applyን ይጫኑ።
4. Checkoutን ይጫኑ።

"በኮድ ለመክፈል ይሞክሩ" ብሎ መናገር ብዙ ጊዜ አስፈላጊ የሆኑ ዝርዝሮችን ይዘላል፦ የየትኛው ተጠቃሚ፣ የየትኛው ምርት፣ የየትኛው ኮድ፣ መጀመሪያ ተተግብሮ እንደሆነ።

ደረጃ 4፦ የሚጠበቀው እና የተከሰተው

ይህ የሪፖርቱ ዋና ነገር ነው። ሁለቱንም ይናገሩ፣ ምክንያቱም ልዩነቱ ስህተቱ ነው።

• የሚጠበቀው፦ የማጠናቀቂያ ገጹ ሲከፈት በጠቅላላው ላይ 10% ቅናሹ ይታያል።
• የተከሰተው፦ ቁልፉ ለአንድ ሰከንድ ስፒነር ያሳያል፣ ከዚያም ምንም አይሆንም። የቅናሽ ኮድ ከሌለ ማጠናቀቂያው ይሰራል።

"የሚጠበቀው" ከሌለ አንባቢው ባህሪው የተሳሳተ መሆኑን ላያውቅ ይችላል። "የተከሰተው" ከሌለ ምን እንደሚፈልጉ አያውቁም።

ደረጃ 5፦ ስህተቶችን በትክክል ይቅዱ

የስህተት መልዕክቶች ወደ ምክንያቱ በፍጥነት የሚወስዱ መንገዶች ናቸው። እንደ ጽሑፍ ቃል በቃል ይቅዷቸው — አይተረጉሙ።

የት እንደሚገኙ፦

• በስክሪን ላይ፦ አፑ የሚያሳየው ማንኛውም መልዕክት።
• የአሳሽ ኮንሶል፦ የገንቢ መሳሪያዎችን ይክፈቱ (F12፣ ወይም ቀኝ-ጠቅ → Inspect) እና ቀይ መስመሮችን ለማግኘት Console ትሩን ይመልከቱ።
• Network ትር፦ በገንቢ መሳሪያዎቹ ውስጥ ያልተሳካውን ጥያቄ ያግኙ፣ URL-ቸውንና የሁኔታ ኮዱን ያስተውሉ (ለምሳሌ POST /api/checkout → 500)።
• የሰርቨር ምዝግብ ማስታወሻዎች፣ መዳረሻ ካለዎት።

እንደ TypeError: Cannot read properties of undefined (reading 'percent') at checkout.ts:48 ያለ መስመር ብዙ ጊዜ ችግሩን በቀጥታ ይጠቁማል።

ደረጃ 6፦ አውድ ይጨምሩ

• የት፦ የገጹ URL፣ አካባቢው (ቅድመ-እይታ፣ ስቴጂንግ ወይም ቀጥታ)።
• ማን፦ የየትኛው ተጠቃሚ ወይም ሚና — አድሚን፣ አባል፣ ያልገባ።
• መሳሪያና አሳሽ፦ "Safari በiPhone" እና "Chrome በWindows" ሊለያዩ ይችላሉ።
• ዳታ፦ ስለመዝገቡ ያልተለመደ ማንኛውም ነገር — በጣም ረጅም ጽሑፍ፣ ልዩ ቁምፊዎች፣ ብዙ ንጥሎች።
• መቼ እንደጀመረ፦ "ከትናንት የቅናሽ ኮድ ለውጥ በኋላ" ወርቅ ነው።
• ምን ያህል ጊዜ፦ ሁልጊዜ፣ ወይም በአስር ሙከራ አንድ ጊዜ።

ደረጃ 7፦ አሳዩት

ችግሩ የተከበበበት ስክሪንሾት ወይም አጭር የስክሪን ቀረጻ አሻሚነትን ያስወግዳል — በተለይ ለአቀማመጥ ስህተቶች። AI መሳሪያዎ ምስል የሚቀበል ከሆነ አንዱን ያያይዙ። የግል የሆነውን ነገር ሁሉ ይቁረጡ፣ ቁልፎችንና የሌሎች ሰዎች ዳታን ጨምሮ።

ለAI ገንቢ የስህተት ሪፖርቶችን መጻፍ

ያው አወቃቀር እንደ ትዕዛዝ ይሰራል። ሁለት መጨመሪያዎች ይረዳሉ፦

• መቀየር የሌለበትን ይናገሩ፣ ማስተካከያው አዲስ ችግር እንዳያመጣ።
• ማስተካከያውን እንዲያረጋግጥ ይጠይቁ፣ መጻፍ ብቻ ሳይሆን።

እንደ ደንበኛ ገብቼ፣ "Starter kit" በጋሪው ውስጥ ሲሆን እና WELCOME10 ኮዱ ሲተገበር፣ Checkoutን ስጫን ምንም አይሆንም። የሚጠበቀው፦ የማጠናቀቂያ ገጹ ሲከፈት በጠቅላላው 10% ቅናሽ። የተከሰተው፦ ለአጭር ጊዜ ስፒነር፣ ከዚያ ምንም። Network ትሩ POST /api/checkout 500 እንደመለሰ ያሳያል። ያለ ኮድ ማጠናቀቂያው ይሰራል። ምክንያቱን ፈልገው ያስተካክሉ፣ ለትዕዛዞች ኮድ ለሌላቸው የዋጋ ስሌት ሳይቀይሩ። ከዚያ በመቶኛ ኮድ፣ በቋሚ መጠን ኮድ እና ያለ ኮድ ማጠናቀቂያውን ያረጋግጡ።

ምክንያቱ ላይ እርግጠኛ ካልሆኑ፣ መጀመሪያ ምርመራ ይጠይቁ፦

ኮዱን ገና አትቀይር። በዚህ ሪፖርት መሰረት፣ ሊሆኑ የሚችሉ ምክንያቶች ምንድን ናቸው፣ እና እያንዳንዳቸውን ምን ያረጋግጣል?

የተለመዱ ስህተቶች

• "ተበላሽቷል።" ደረጃዎች የሉም፣ የሚጠበቀው ውጤት የለም፣ የሚሰራበት ነገር የለም።
• በአንድ ሪፖርት ብዙ ስህተቶች። አንዳንዶቹ ይስተካከላሉ፣ ሌሎቹ ይጠፋሉ።
• የተተረጎሙ ስህተቶች። "አንዳንድ undefined ነገር" ጠቃሚውን ክፍል ይደብቃል።
• ተጠቃሚውን ወይም ሚናውን መዝለል። ብዙ ስህተቶች አድሚኖችን ብቻ ወይም አዲስ ተጠቃሚዎችን ብቻ ይነካሉ።
• የሚፈልጉትን ማስተካከያ ብቻ መግለጽ ("null ማረጋገጫ ጨምር") ከችግሩ ይልቅ።
• ሚስጥሮችን በስክሪንሾቶች ወይም በተለጠፉ ምዝግብ ማስታወሻዎች ማጋራት።

ዝርዝር

• ስህተቱን እንደገና አባዝቼ አጭሩን ደረጃ አግኝቻለሁ።
• ርዕሱ ምን እንደተበላሸና የት እንደሆነ ይናገራል።
• ደረጃዎቹ ቁጥር ያላቸውና ቀጥተኛ ናቸው።
• የሚጠበቀውና የተከሰተው ሁለቱም ተገልጸዋል።
• የስህተት መልዕክቶቹ በትክክል ተቀድተዋል፣ ከማንኛውም ያልተሳካ ጥያቄና የሁኔታ ኮድ ጋር።
• ገጽ፣ አካባቢ፣ ተጠቃሚ፣ መሳሪያና አሳሽ ተካትተዋል።
• ምን ያህል ጊዜ እንደሚከሰት እና መቼ እንደጀመረ ተናግሬአለሁ።
• ስክሪንሾት ወይም ቀረጻ ተያይዟል፣ የግል ዳታ ተወግዶ።
• በአንድ ሪፖርት አንድ ስህተት።

ለMythex ኤጀንት ስህተቶችን ሪፖርት ማድረግ

በMythex ፕሮጀክት ውስጥ ሪፖርቱ ራሱ ትዕዛዙ ነው። ጥቂት ባህሪያት ይረዳሉ፦

• ስክሪንሾት ያያይዙ የቅድመ-እይታውን ወይም የስህተት ስክሪኑን — በአንድ መልዕክት እስከ 5 ፋይሎች።
• /fix ኤጀንቱን ስህተት ወደ ማስተካከል ያተኩራል፤ Plan ሁነታ ከማረሙ በፊት እንዲመረምር ያስችለዋል።
• /test ኤጀንቱ ፍሰቶቹን በቅድመ-እይታው ውስጥ እንዲያባዛና የሚያየውን እንዲዘግብ ያደርገዋል።
• ወደዚህ ነጥብ ተመለስ (Revert to this point) ነገሮችን ያባሰ ማስተካከያን ይቀለብሳል።

የሰነዱ በትዕዛዞች ማረም ገጽ ተመሳሳይ ደረጃዎች/የሚጠበቀው/የተከሰተው አወቃቀር ይጠቀማል። ዙሪያውን ያለው የማስተካከያና የማረጋገጫ ዑደት ለማወቅ፣ AI-የተገነባ አፕን እንዴት መድገም እንደሚቻል ይመልከቱ።

ጥያቄዎች