நல்ல பிழை அறிக்கையை எப்படி எழுதுவது (AI அல்லது டெவலப்பருக்கு)

நல்ல பிழை அறிக்கை, நீங்கள் பார்த்த அதே பிரச்சினையை வேறொருவர் — ஒரு டெவலப்பராகவோ AI ஆகவோ — உங்களிடம் எதுவும் கேட்காமலேயே பார்க்க உதவுகிறது. அதற்கு ஒரு குறிப்பிட்ட தலைப்பு, அதை மீண்டும் உருவாக்கும் சரியான படிகள், நீங்கள் எதை எதிர்பார்த்தீர்கள், உண்மையில் என்ன நடந்தது, வார்த்தைக்கு வார்த்தை நகலெடுத்த ஏதேனும் பிழைச் செய்தி, அது எங்கே நடந்தது — எந்தப் பக்கம், உலாவி, சாதனம், பயனர் — ஆகியவை தேவை. ஒரு அறிக்கைக்கு ஒரு பிழை, உதவினால் ஒரு திரைப்பிடிப்புடன்.

பெரும்பாலான பிழைகளைப் புரிந்துகொள்வதற்கு சரிசெய்வதை விட அதிக நேரம் ஆகும். தெளிவான அறிக்கை புரிந்துகொள்ளும் பகுதியை நீக்குகிறது. AI கருவிகளுடன் இது இன்னும் முக்கியம்: "checkout விசித்திரமாக இருக்கிறது" என்றால் என்ன என்று AI ஒரு தொடர் கேள்வியைக் கேட்க முடியாது, எனவே அது யூகிக்கிறது — தவறான யூகம் வேறு எதையாவது உடைக்கலாம்.

வார்ப்புரு

இதை நகலெடுத்து நிரப்புங்கள்:

தலைப்பு: [என்ன தவறு, எங்கே] — உதா. "மாலை 6 மணிக்குப் பிறகான நேரங்களை booking form நிராகரிக்கிறது"

மீண்டும் உருவாக்கும் படிகள்:
1. ...
2. ...
3. ...

எதிர்பார்த்தது: [என்ன நடந்திருக்க வேண்டும்]
உண்மையானது: [அதற்குப் பதில் என்ன நடந்தது]

பிழைச் செய்தி: [சரியான உரை, இருந்தால்]
எங்கே: [பக்கம்/URL, உலாவி, சாதனம், எந்தப் பயனராக உள்நுழைந்தீர்கள்]
எத்தனை முறை: [ஒவ்வொரு முறையும் / சில நேரம் / ஒருமுறை]
திரைப்பிடிப்பு அல்லது பதிவு: [இணைக்கப்பட்டது]

இந்த வழிகாட்டியின் மீதி ஒவ்வொரு பகுதியையும் விளக்குகிறது.

படி 1: முதலில் மீண்டும் உருவாக்குங்கள்

எழுதுவதற்கு முன், பிழை மீண்டும் நிகழச் செய்ய முயலுங்கள். எந்தப் படிகள் முக்கியம், அது ஒவ்வொரு முறையும் நடக்கிறதா என்பதை அறிவீர்கள்.

• சுத்தமான நிலையிலிருந்து தொடங்குங்கள்: புதுப்பியுங்கள், அல்லது வெளியேறி மீண்டும் உள்நுழையுங்கள்.
• ஒவ்வொரு கிளிக்கையும் நீங்கள் தட்டச்சு செய்த ஒவ்வொன்றையும் குறித்து வையுங்கள்.
• அதைத் தூண்டும் குறுகிய வழியைக் கண்டுபிடிக்க முயலுங்கள்.
• இரண்டாவது உலாவி அல்லது கணக்கை முயலுங்கள். ஒரே பயனருக்கு மட்டும் நடந்தால், அது ஒரு பெரிய துப்பு.

இதைப் பற்றி மேலும், AI மூலம் உருவாக்கிய ஆப்பை எப்படி debug செய்வது என்பதைப் பாருங்கள்.

படி 2: குறிப்பிட்ட தலைப்பு எழுதுங்கள்

தலைப்பு என்ன தவறு, எங்கே என்று சொல்ல வேண்டும்; பட்டியலை வேகமாகப் பார்ப்பவர் அது எந்தப் பிழை என்று அறிய வேண்டும்.

படி 3: சரியான படிகளைப் பட்டியலிடுங்கள்

அவற்றை எண்ணிடுங்கள். நேரடியாக இருங்கள்: எந்தப் பக்கம், எந்தப் பொத்தான், நீங்கள் என்ன தட்டச்சு செய்தீர்கள்.

1. வாடிக்கையாளராக உள்நுழையுங்கள் (சோதனைக் கணக்கு: customer@example.com).
2. "Starter kit" ஐ cart இல் சேருங்கள்.
3. தள்ளுபடி குறியீடு WELCOME10 ஐ உள்ளிட்டு Apply ஐக் கிளிக் செய்யுங்கள்.
4. Checkout ஐக் கிளிக் செய்யுங்கள்.

"குறியீட்டுடன் checkout செய்து பாருங்கள்" என்பது பெரும்பாலும் முக்கியமான விவரங்களை விட்டுவிடுகிறது: எந்தப் பயனர், எந்தத் தயாரிப்பு, எந்தக் குறியீடு, அது முதலில் பயன்படுத்தப்பட்டதா.

படி 4: எதிர்பார்த்தது எதிராக உண்மையானது

இதுதான் அறிக்கையின் மையம். இரண்டையும் சொல்லுங்கள், ஏனெனில் வேறுபாடுதான் பிழை.

• எதிர்பார்த்தது: மொத்தத் தொகையில் 10% தள்ளுபடி காட்டப்பட்ட checkout பக்கம் திறக்கும்.
• உண்மையானது: பொத்தான் ஒரு வினாடிக்கு ஒரு சுழலியைக் காட்டி, பிறகு எதுவும் நடக்காது. தள்ளுபடி குறியீடு இல்லாமல் checkout வேலை செய்கிறது.

"எதிர்பார்த்தது" இல்லாமல், நடத்தை தவறு என்று வாசகருக்குத் தெரியாமல் போகலாம். "உண்மையானது" இல்லாமல், எதைத் தேடுவது என்று தெரியாது.

படி 5: பிழைகளை அப்படியே நகலெடுங்கள்

பிழைச் செய்திகள் காரணத்தை விரைவாகச் சென்றடையும் வழி. அவற்றை வார்த்தைக்கு வார்த்தை உரையாக நகலெடுங்கள் — மாற்றி எழுத வேண்டாம்.

அவற்றை எங்கே காண்பது:

• திரையில்: ஆப் காட்டும் எந்தச் செய்தியும்.
• உலாவி console: developer tools ஐத் திறந்து (F12, அல்லது வலது-கிளிக் → Inspect) சிவப்பு வரிகளுக்கு Console tab ஐப் பாருங்கள்.
• Network tab: developer tools இல், தோல்வியடைந்த கோரிக்கையைக் கண்டு அதன் URL மற்றும் status code ஐக் குறியுங்கள் (உதாரணமாக POST /api/checkout → 500).
• சர்வர் பதிவுகள், உங்களுக்கு அணுகல் இருந்தால்.

TypeError: Cannot read properties of undefined (reading 'percent') at checkout.ts:48 போன்ற ஒரு வரி பெரும்பாலும் நேரடியாகப் பிரச்சினையைச் சுட்டும்.

படி 6: சூழலைச் சேருங்கள்

• எங்கே: பக்கத்தின் URL, சூழல் (preview, staging அல்லது live).
• யார்: எந்தப் பயனர் அல்லது பாத்திரம் — நிர்வாகி, உறுப்பினர், உள்நுழையாதவர்.
• சாதனமும் உலாவியும்: "iPhone இல் Safari" எதிராக "Windows இல் Chrome" முக்கியமாக இருக்கலாம்.
• தரவு: பதிவைப் பற்றி ஏதேனும் வழக்கத்திற்கு மாறானது — மிக நீண்ட உரை, சிறப்பு எழுத்துகள், அதிக எண்ணிக்கையிலான உருப்படிகள்.
• எப்போது தொடங்கியது: "நேற்றைய தள்ளுபடி குறியீடுகளின் மாற்றத்துக்குப் பின்" என்பது பொன்.
• எத்தனை முறை: ஒவ்வொரு முறையும், அல்லது பத்தில் ஒரு முறை.

படி 7: அதைக் காட்டுங்கள்

பிரச்சினையைச் சுற்றி வட்டமிட்ட ஒரு திரைப்பிடிப்பு, அல்லது ஒரு குறுகிய திரைப் பதிவு, தெளிவின்மையை நீக்குகிறது — குறிப்பாக அமைப்புப் பிழைகளுக்கு. உங்கள் AI கருவி படங்களை ஏற்றால், ஒன்றை இணைக்கவும். ரகசியங்களும் மற்றவர்களின் தரவும் உட்பட தனிப்பட்ட எதையும் வெட்டி நீக்குங்கள்.

AI பில்டருக்கு பிழை அறிக்கைகள் எழுதுவது

அதே அமைப்பு ஒரு prompt ஆகவும் வேலை செய்யும். இரண்டு சேர்ப்புகள் உதவும்:

• எது மாறக்கூடாது என்று சொல்லுங்கள், சரிசெய்தல் ஒரு புதிய பிரச்சினையை உண்டாக்காமல் இருக்க.
• சரிசெய்ததை எழுதுவது மட்டுமல்ல, சரிபார்க்கவும் சொல்லுங்கள்.

வாடிக்கையாளராக உள்நுழைந்து, cart இல் "Starter kit" உடனும் WELCOME10 குறியீடு பயன்படுத்தப்பட்ட நிலையிலும், Checkout ஐக் கிளிக் செய்தால் எதுவும் நடக்கவில்லை. எதிர்பார்த்தது: மொத்தத்தில் 10% தள்ளுபடியுடன் checkout பக்கம் திறக்கும். உண்மையானது: ஒரு குறுகிய சுழலி, பிறகு எதுவும் இல்லை. Network tab இல் POST /api/checkout 500 ஐத் திருப்பியது. குறியீடு இல்லாத checkout வேலை செய்கிறது. காரணத்தைக் கண்டுபிடித்துச் சரிசெய், குறியீடு இல்லாத ஆர்டர்களுக்கான விலை கணக்கீட்டை மாற்றாமல். பிறகு சதவீதக் குறியீடு, நிலையான தொகைக் குறியீடு, குறியீடு இல்லை என மூன்றிலும் checkout ஐச் சரிபார்.

காரணம் உறுதியில்லாவிட்டால், முதலில் நோயறிதலைக் கேளுங்கள்:

இப்போது கோடை மாற்றாதே. இந்த அறிக்கையின் அடிப்படையில், சாத்தியமான காரணங்கள் என்ன, ஒவ்வொன்றையும் எது உறுதிப்படுத்தும்?

பொதுவான தவறுகள்

• "இது உடைந்துவிட்டது." படிகள் இல்லை, எதிர்பார்த்த முடிவு இல்லை, செயல்பட எதுவும் இல்லை.
• ஒரே அறிக்கையில் பல பிழைகள். சில சரிசெய்யப்படும், மற்றவை தொலைந்துவிடும்.
• பிழைகளை மாற்றி எழுதுவது. "சில undefined விஷயம்" பயனுள்ள பகுதியை மறைக்கிறது.
• பயனர் அல்லது பாத்திரத்தைக் குறிப்பிடாதது. பல பிழைகள் நிர்வாகிகளை மட்டுமோ புதிய பயனர்களை மட்டுமோ பாதிக்கின்றன.
• பிரச்சினையை விவரிக்காமல், நீங்கள் விரும்பும் சரிசெய்தலை மட்டும் விவரிப்பது ("ஒரு null சரிபார்ப்பைச் சேர்").
• திரைப்பிடிப்புகள் அல்லது ஒட்டிய பதிவுகளில் ரகசியங்களைப் பகிர்வது.

சரிபார்ப்புப் பட்டியல்

• பிழையை மீண்டும் உருவாக்கி, மிகக் குறுகிய படிகளைக் கண்டறிந்தேன்.
• தலைப்பு என்ன தவறு, எங்கே என்று சொல்கிறது.
• படிகள் எண்ணிடப்பட்டு நேரடியாக உள்ளன.
• எதிர்பார்த்ததும் உண்மையானதும் இரண்டும் சொல்லப்பட்டுள்ளன.
• பிழைச் செய்திகள் சரியாக நகலெடுக்கப்பட்டுள்ளன, தோல்வியடைந்த கோரிக்கையும் status code உம் உட்பட.
• பக்கம், சூழல், பயனர், சாதனம், உலாவி சேர்க்கப்பட்டுள்ளன.
• அது எத்தனை முறை நடக்கிறது, எப்போது தொடங்கியது என்று சொல்லியுள்ளேன்.
• தனிப்பட்ட தரவு நீக்கப்பட்ட ஒரு திரைப்பிடிப்பு அல்லது பதிவு இணைக்கப்பட்டுள்ளது.
• ஒரு அறிக்கைக்கு ஒரு பிழை.

Mythex agent க்கு பிழைகளைத் தெரிவிப்பது

Mythex திட்டத்தில், அறிக்கையே prompt ஆகும். சில அம்சங்கள் உதவும்:

• preview அல்லது பிழைத் திரையின் திரைப்பிடிப்பை இணைக்கவும் — ஒரு செய்திக்கு 5 கோப்புகள் வரை.
• /fix agent ஐ ஒரு பிழையைச் சரிசெய்வதில் கவனம் செலுத்த வைக்கும்; Plan mode திருத்துவதற்கு முன் அது ஆராய அனுமதிக்கும்.
• /test agent ஐ preview இலேயே ஓட்டங்களை மீண்டும் உருவாக்கி அது காண்பதை அறிக்கையிடச் செய்யும்.
• Revert to this point நிலைமையை மோசமாக்கிய ஒரு சரிசெய்தலைச் செயல்தவிர்க்கும்.

ஆவணங்களின் prompts மூலம் debugging பக்கம் அதே steps / expected / actual அமைப்பைப் பயன்படுத்துகிறது. அதைச் சுற்றியுள்ள சரிசெய்-சரிபார் சுழற்சிக்கு, AI மூலம் உருவாக்கிய ஆப்பை எப்படித் திரும்பத் திரும்பச் செம்மைப்படுத்துவது என்பதைப் பாருங்கள்.

கேள்விகள்