Жақсы қате туралы хабарлама қалай жазылады (AI немесе әзірлеуші үшін)

Жақсы қате туралы хабарлама басқа адамға — әзірлеушіге немесе AI-ға — сіз көрген мәселені сізден ештеңе сұрамай-ақ көруге мүмкіндік береді. Оған анық тақырып, оны қайталаудың нақты қадамдары, не күткеніңіз, нақты не болғаны, қате мәтінінің сөзбе-сөз көшірмесі және қай жерде болғаны керек: қай бет, браузер, құрылғы және пайдаланушы. Әр хабарламада бір қате болсын, көмектессе скриншотпен.

Көп қатені түсіну оны түзеуден ұзағырақ алады. Анық хабарлама түсіну бөлігін алып тастайды. Бұл AI құралдарымен одан да маңызды: AI «төлем бөлімі дұрыс емес» деген сөздің нені білдіретінін сұрай алмайды, сондықтан болжайды — ал қате болжам басқа бірдеңені бұзуы мүмкін.

Үлгі

Мұны көшіріп, толтырыңыз:

Тақырып: [Не дұрыс емес, қай жерде] — мысалы, «Брондау формасы кешкі 6-дан кейінгі уақытты қабылдамайды»

Қайталау қадамдары:
1. ...
2. ...
3. ...

Күтілген: [не болуы керек]
Нақты: [оның орнына не болды]

Қате мәтіні: [дәл мәтін, егер бар болса]
Қайда: [бет/URL, браузер, құрылғы, қай пайдаланушы болып кірдіңіз]
Қанша рет: [әр уақытта / кейде / бір рет]
Скриншот немесе жазба: [қоса берілген]

Мақаланың қалған бөлігі әр бөлікті түсіндіреді.

1-қадам: Алдымен қайталаңыз

Жазбас бұрын қатені қайтадан шығаруға тырысыңыз. Сонда қай қадамдардың маңызды екенін және ол әр уақытта болатынын білесіз.

Таза күйден бастаңыз: беттерді жаңартыңыз немесе шығып, қайта кіріңіз.
Әр басуды және әр теріп жазған нәрсеңізді жазып алыңыз.
Оны іске қосатын ең қысқа жолды табуға тырысыңыз.
Екінші браузерде немесе аккаунтта көріңіз. Егер тек бір пайдаланушыда болса, бұл үлкен белгі.

Осы туралы көбірек білу үшін AI жасаған қолданбаны қалай түзету керек мақаласын қараңыз.

2-қадам: Нақты тақырып жазыңыз

Тақырып не дұрыс емес екенін және қай жерде екенін айтуы керек, сонда тізімді шолған адам қай қате екенін бірден түсінеді.

Әлсіз	Күшті
Төлем бұзылған	Себетте жеңілдік коды болғанда, төлем батырмасы ешнәрсе істемейді
Мобильді мәселе	Баға карточкалары 400px-тен тар телефондарда экраннан шығып кетеді
Сақтау кезінде қате	Атында эмодзи бар профильді сақтағанда «500 Internal Server Error» көрсетеді

3-қадам: Нақты қадамдарды тізіңіз

Оларды нөмірлеңіз. Дәл болыңыз: қай бет, қай батырма, не теріп жазғаныңыз.

Клиент ретінде кіріңіз (сынақ аккаунты: customer@example.com).
Себетке «Starter kit» қосыңыз.
WELCOME10 жеңілдік кодын енгізіп, Қолдану батырмасын басыңыз.
Төлеу батырмасын басыңыз.

«Кодпен төлеп көріңіз» деу көбіне маңызды бөлшектерді түсіріп қалдырады: қай пайдаланушы, қай өнім, қай код, алдымен қолданылды ма.

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, орта (алдын ала қарау, сынақ немесе жарияланған).
Кім: қай пайдаланушы немесе рөл — әкімші, мүше, жүйеден шыққан.
Құрылғы және браузер: «iPhone-дағы Safari» мен «Windows-тағы Chrome» маңызды болуы мүмкін.
Деректер: жазбаның ерекшелігі — өте ұзын мәтін, арнайы таңбалар, көп элемент.
Қашан басталды: «кеше жеңілдік кодтарын өзгерткеннен кейін» — алтын.
Қанша рет: әр уақытта, немесе он әрекеттің бірінде.

7-қадам: Көрсетіңіз

Мәселесі белгіленген скриншот немесе қысқа экран жазбасы бұлыңғырлықты жояды — әсіресе макет қателерінде. Егер AI құралы суреттерді қабылдаса, біреуін тіркеңіз. Жеке нәрселерді, соның ішінде кілттер мен басқа адамның деректерін, кесіп тастаңыз.

AI құрастырушысына қате туралы хабарлама жазу

Сол құрылым сұраныс ретінде де жұмыс істейді. Екі қосымша көмектеседі:

Не өзгермеуі керек екенін айтыңыз, сонда түзету жаңа мәселе туғызбайды.
Түзетуді жазып қана қоймай, тексеруді сұраңыз.

Клиент ретінде кірдім, себетте «Starter kit» бар және WELCOME10 коды қолданылған кезде Төлеу батырмасын басқанда ешнәрсе болмайды. Күтілген: төлем беті ашылып, жалпы сомадан 10% жеңілдік көрсетіледі. Нақты: қысқа айналдырғыш, содан кейін ешнәрсе. Network қойындысында POST /api/checkout 500 қайтарған. Кодсыз төлем жұмыс істейді. Себебін табыңыз және түзетіңіз, кодсыз тапсырыстар үшін баға есептеу тәсілін өзгертпей. Содан кейін пайыздық кодпен, белгіленген сомалық кодпен және кодсыз төлемді тексеріңіз.

Егер себебіне сенімсіз болсаңыз, алдымен диагноз сұраңыз:

Әзір кодты өзгертпеңіз. Осы хабарлама бойынша ықтимал себептер қандай, және әр біреуін не растайды?

Жиі кездесетін қателер

«Бұзылған.» Қадамдар жоқ, күтілген нәтиже жоқ, әрекет ететін ештеңе жоқ.
Бір хабарламада бірнеше қате. Кейбірі түзетіледі, басқалары жоғалады.
Парафраз жасалған қателер. «Бір анықталмаған нәрсе» пайдалы бөлікті жасырады.
Пайдаланушыны немесе рөлді көрсетпеу. Көптеген қате тек әкімшіге немесе жаңа пайдаланушыға әсер етеді.
Тек қалаған түзетуді сипаттау («null тексеруін қосыңыз») мәселенің орнына.
Скриншот немесе көшірілген журналдарда құпияларды бөлісу.

Тексеру тізімі

Қатені қайталадым және ең қысқа қадамдарды таптым.
Тақырып не дұрыс емес және қай жерде екенін айтады.
Қадамдар нөмірленген және нақты.
Күтілген және нақты нәтиже екеуі де айтылған.
Қате мәтіндері дәл көшірілген, сәтсіз сұраныс пен статус коды бар.
Бет, орта, пайдаланушы, құрылғы және браузер қосылған.
Қанша рет болатынын және қашан басталғанын айттым.
Скриншот немесе жазба тіркелген, жеке деректер алынып тасталған.
Әр хабарламада бір қате.

Mythex агентіне қате туралы хабарлау

Mythex жобасында хабарлама — сұраныстың өзі. Бірнеше мүмкіндік көмектеседі:

Алдын ала қарау немесе қате экранының скриншотын тіркеңіз — хабарламаға 5 файлға дейін.
/fix агентті қатені түзетуге бағыттайды; Plan режимі өңдеудің алдында зерттеуге мүмкіндік береді.
/test агентке ағындарды алдын ала қарауда өзі қайталатып, не көргенін хабарлатады.
Осы нүктеге қайту нәтижесі нашарлаған түзетуді болдырмайды.

Құжаттардағы сұраныстармен қате түзету беті дәл осы сипаттама, күтілген және нақты құрылымын пайдаланады. Айналасындағы түзету мен тексеру циклі үшін AI жасаған қолданбаны қайталап жетілдіру мақаласын қараңыз.

Сұрақтар

Қате туралы хабарламада не болуы керек?

Нақты тақырып, мәселені қайталау үшін дәл қадамдар, не күткеніңіз, нақты не болғаны, қате мәтіні сөзбе-сөз, қай жерде болғаны (бет, браузер, құрылғы, пайдаланушы), ал көмектессе — скриншот немесе жазба.

AI құрастырушысына қате туралы хабарламаны қалай жазамын?

Әзірлеушіге арналған құрылыммен бірдей пайдаланыңыз: қадамдар, күтілген, нақты нәтиже және дәл қате. Не өзгермеуі керек екенін қосыңыз және түзетуді жасап, сонан соң түзетуді тексеруді сұраңыз. «Бұзылған» сияқты бұлыңғыр сұраныстар болжамға әкеледі.

Қатені қайталай алмасам не істеймін?

Оны бәрібір хабарлаңыз, бірақ бұл туралы айтыңыз. Не істеп жатқаныңызды, оның болған уақытын, пайдаланушы аккаунтын және көрген қатені қосыңыз. Оның қанша рет болатынын жазыңыз, мысалы, он әрекеттің бірінде, себебі ара-тұра болатын қателер жиі уақыт немесе дерек мәселесін көрсетеді.

Бір хабарламаға бірнеше қатені қосу керек пе?

Жоқ. Әр хабарламада бір қате болсын, сонда әрқайсысы өз бетінше түзетіліп, тексеріліп, жабыла алады. Егер екі мәселе байланысты деп ойласаңыз, әр хабарламада соны айтыңыз.