एआई प्रोग्रामिंग सहायक नानी-स्तरीय ट्यूटोरियल: कोड पूरा करने से लेकर एजेंट मोड के कुशल उपयोग तक

🛒 डेवलपर्स के लिए, वास्तविक दक्षता के साथ एआई प्रोग्रामिंग सहायकों का उपयोग करने के लिए पुन: प्रयोज्य तरीकों के एक सेट का उपयोग करें।

ट्यूटोरियल उद्देश्य

यह ट्यूटोरियल Cursor और GitHub Copilot को उदाहरण के रूप में लेता है ताकि आपको एआई प्रोग्रामिंग असिस्टेंट को 'सामयिक पूर्णता' से 'स्थिर दैनिक इंजीनियरिंग टूल' में अपग्रेड करने और एजेंट मोड में मल्टी-फ़ाइल परिवर्तन, पुनर्निर्माण और परीक्षण पीढ़ी में महारत हासिल करने में मदद मिल सके।

तैयारी चेकलिस्ट

• [ ] वीएस कोड या कर्सर स्थापित करें (यह ट्यूटोरियल एक उदाहरण के रूप में कर्सर का उपयोग करता है)।
• [ ] अपने खाते में लॉग इन करें और अपनी निःशुल्क कोटा/सदस्यता स्थिति की पुष्टि करें।
• [ ] Git द्वारा प्रबंधित एक नमूना परियोजना (पहले अभ्यास करने और फिर वास्तविक गोदाम का उपयोग करने की अनुशंसा की जाती है)।
• [ ] नोड/पायथन और अन्य चल रहे वातावरण पहले से ही स्थानीय रूप से उपलब्ध हैं (परीक्षण सत्यापन चलाने के लिए उपयोग किया जाता है)।
• [ ] अपने कोड आधार (प्रविष्टि, निर्भरता, परीक्षण आदेश) की संरचना को समझें।

चरण एक: स्थापना और बुनियादी विन्यास

1. कर्सर (या वीएस कोड + कोपायलट प्लगइन) डाउनलोड और इंस्टॉल करें।
2. अपने खाते में लॉग इन करें और सेटिंग्स में मॉडल और पूर्णता स्विच की पुष्टि करें।
3. नमूना प्रोजेक्ट खोलें और वेयरहाउस रूट निर्देशिका में मुख्य फ़ाइलें (रीडमी, इंटरफ़ेस दस्तावेज़) दृश्यमान रखें।

सुझाव सेट करें: "स्वतः पूर्ण (टैब)" और "कोड समीक्षा" फ़ंक्शन चालू करें; "सभी सुझावों को स्वचालित रूप से स्वीकार करें" जैसे उच्च जोखिम वाले विकल्पों को बंद करें।

चरण 2: तीन प्रकार के बुनियादी उपयोग में महारत हासिल करें

1. इनलाइन पूर्णता: फ़ंक्शन नाम या टिप्पणी दर्ज करें और सुझाव स्वीकार करने के लिए टैब दबाएं।
2. संवाद प्रश्न: ⌘ + L संवाद खोलें, कोड स्निपेट चिपकाएँ और पूछें "इस कोड में क्या खराबी है"।
3. कोड ऑपरेशन चुनें: कोड का एक टुकड़ा चुनें, राइट-क्लिक करें और "एक्सप्लेन/रिफैक्टर/जेनरेट टेस्ट" चुनें।

मुख्य विचार: केवल "इसे मेरे लिए लिखें" के बजाय एआई संदर्भ दें। सबसे पहले प्रासंगिक फ़ाइलों का चयन करें या इंटरफ़ेस हस्ताक्षर पोस्ट करें।

चरण 3: उच्च गुणवत्ता वाले त्वरित शब्द लिखें

ख़राब संकेत शब्द: मेरे लिए एक लॉगिन इंटरफ़ेस लिखें।

अच्छे शीघ्र शब्दों के उदाहरण:

src/auth/login.ts में एक लॉगिन इंटरफ़ेस लागू करें:
- इनपुट पैरामीटर: { उपयोगकर्ता नाम, पासवर्ड }
- सत्यापन: बीक्रिप्ट का उपयोग करके पासवर्ड तुलना
- JWT सफलतापूर्वक लौटा, समाप्ति समय 2 घंटे है
- विफलता 401 और त्रुटि कोड लौटाती है
- प्रोजेक्ट की मौजूदा त्रुटि प्रबंधन का पालन करें (src/utils/errors.ts देखें)
- एक ही समय में यूनिट परीक्षण उत्पन्न करें

तीन मुख्य बिंदु: लक्ष्य स्पष्ट करें, सीमाएँ दें, और मौजूदा कोड की पहचान करें।

चरण 4: एकाधिक फ़ाइलों को संशोधित करने के लिए एजेंट मोड का उपयोग करें

कंपोज़र/एजेंट मोड में प्रवेश करने के लिए कर्सर में ⌘ + I दबाएँ और दर्ज करें:

ऑर्डर मॉड्यूल की राशि गणना को एक स्वतंत्र टूल फ़ंक्शन में निकालें और इसे src/utils/money.ts में रखें।
मौजूदा नामकरण शैली को बनाए रखते हुए सभी कॉल पॉइंट अपडेट करें और यूनिट परीक्षण जोड़ें।

एजेंट सभी फ़ाइलों को संपादित करेगा. इस समय यह सुनिश्चित करें:

1. एक स्वतंत्र शाखा पर कार्य करें।
2. एजेंट के सभी अंतरों को एक क्लिक से स्वीकार करने के बजाय एक-एक करके समीक्षा करें।
3. यह पुष्टि करने के लिए परीक्षण चलाएँ कि कोई प्रतिगमन तो नहीं है।

चरण 5: एआई को परीक्षण तैयार करने और ठीक करने में मदद करने दें

• परीक्षण उत्पन्न करें: src/utils/money.ts के लिए सीमा स्थितियों को कवर करते हुए इकाई परीक्षण उत्पन्न करें।
• मरम्मत विफलता: सीआई त्रुटि संदेश को एआई पर पोस्ट करें: टेस्ट एक्सएक्स विफल, त्रुटि इस प्रकार है... कृपया मूल कारण का पता लगाएं और इसे ठीक करें।

अनुभव: यदि आप "त्रुटि रिपोर्ट + संबंधित दस्तावेज़ + अपेक्षित व्यवहार" एक साथ पोस्ट करते हैं, तो सफलता दर केवल त्रुटि रिपोर्ट पोस्ट करने की तुलना में बहुत अधिक है।

चरण 6: प्रोजेक्ट-स्तरीय विनिर्देश सेट करें (.cursorrules)

AI आउटपुट को टीम शैली में फिट करने के लिए प्रोजेक्ट रूट डायरेक्टरी में .cursorrules बनाएं:

- प्रोजेक्ट भाषा: टाइपस्क्रिप्ट, सख्त मोड का उपयोग करते हुए
- त्रुटि प्रबंधन: src/utils/errors.ts में ApiError का एकीकृत उपयोग
- नामकरण: फ़ंक्शन क्रिया घटक पास्कलकेस से शुरू होती है
- सबमिशन से पहले एस्लिंट और प्रिटियर को पास करना होगा
- सभी नए तर्क में यूनिट परीक्षण होना चाहिए

सहेजने के बाद, नया सत्र स्वचालित रूप से प्रभावी हो जाएगा, और टीम के एकीकृत विनिर्देशों को साझा गोदाम में रखा जा सकता है।

चरण 7: सत्यापन और सुरक्षा सीमा

सत्यापन चेकलिस्ट:

• [ ] समापन सुझाव टैब द्वारा स्वीकार किए जाते हैं और व्याकरणिक रूप से सही हैं।
• [ ] शीघ्र शब्द स्थिर रूप से ऐसे कोड का उत्पादन कर सकते हैं जो विनिर्देशों को पूरा करते हैं और चलाने योग्य हैं।
• [ ] संशोधन के बाद परीक्षण में एजेंट पूरी तरह से हरा है।
• [ ] संवेदनशील जानकारी (कुंजियाँ, इंट्रानेट पते) को कभी भी क्लाउड एआई पर चिपकाया नहीं जाता है।

सुरक्षा लाल रेखाएँ: गोपनीय कोड चिपकाए नहीं जाते हैं, संवेदनशील गोदामों में साझा सत्र नहीं खोले जाते हैं, और एजेंटों को सीधे ट्रंक में नहीं भेजा जाता है।

चरण 8: दैनिक कुशल वर्कफ़्लो संयोजन

बिखरे हुए उपयोगों को "मानक क्रियाओं" में संयोजित करने से, दक्षता में स्पष्ट रूप से सुधार होता है:

1. आवश्यकताएँ प्राप्त करें → कार्य सूची और इंटरफ़ेस सीमाओं को अलग करने के लिए AI का उपयोग करें।
2. कोड लिखें → प्रासंगिक फ़ाइलों का चयन करें और कार्यान्वयन का पहला संस्करण तैयार करने के लिए एजेंट का उपयोग करें।
3. स्व-परीक्षण → AI को इकाई परीक्षण उत्पन्न करने दें और उन्हें चलाने दें।
4. संयुक्त डिबगिंग → मूल कारण का पता लगाने और उसे ठीक करने के लिए त्रुटि रिपोर्ट एआई पर पोस्ट करें।
5. समापन → AI को परिवर्तन निर्देश उत्पन्न करने और जानकारी देने दें।

यह संयोजन हर दिन 1-2 घंटे बचा सकता है। कुंजी है "हर कदम पर स्पष्ट इनपुट और स्वीकृति।"

सामान्य गलतियाँ और सावधानियाँ

1. सभी एजेंट के अंतरों को एक क्लिक से स्वीकार करें: एक-एक करके उनकी समीक्षा करना सुनिश्चित करें और उन्हें केवल तभी मर्ज करें जब परीक्षण पूरी तरह से हरा हो।
2. संदर्भ दिए बिना पूछें: पहले फ़ाइल का चयन करें या इंटरफ़ेस हस्ताक्षर पेस्ट करें।
3. एआई पर कुंजी पोस्ट करना: यह एक सुरक्षा लाल रेखा है और सख्त वर्जित है।
4. एआई संशोधनों के बाद परीक्षण न चलाएं: किसी भी एआई संशोधनों को परीक्षण के माध्यम से सत्यापित किया जाना चाहिए और उस पर आंख मूंदकर विश्वास नहीं किया जा सकता है।
5. संकेत शब्द अपरिवर्तित रहता है: प्रभाव कम होने पर टेम्पलेट को पुनरावृत्त करने की पहल करें।

सत्यापन विधि

• सत्यापन 1: पूर्णता सुझाव टैब द्वारा स्वीकार किए जा सकते हैं और व्याकरणिक रूप से सही हैं।
• सत्यापन 2: शीघ्र शब्द स्थिर रूप से कोड उत्पन्न कर सकते हैं जो विनिर्देशों को पूरा करता है और चलाने योग्य है।
• सत्यापन 3: संशोधन के बाद एजेंट पूरी तरह से हरा है।
• सत्यापन 4: संवेदनशील जानकारी (कुंजियाँ, इंट्रानेट पते) को कभी भी क्लाउड एआई पर चिपकाया नहीं गया है।

अक्सर पूछे जाने वाले प्रश्न और समस्या निवारण (एफएक्यू)

1. क्या पूर्णता हमेशा जंक कोड का सुझाव देती है?

   अधिक संदर्भ दें (फ़ाइलों का चयन करें, इंटरफ़ेस पेस्ट करें), शैली को बाधित करने के लिए .cursorrules का उपयोग करें, और यदि आवश्यक हो तो एक मजबूत मॉडल में बदलें।

2. यदि एजेंट फ़ाइल को दूषित कर दे तो मुझे क्या करना चाहिए?

   फ़ाइल को वापस रोल करने के लिए Git का उपयोग करें: git checkout <file>; "परिवर्तन से पहले शाखाओं को काटने और परिवर्तन के बाद एक-एक करके उनकी समीक्षा करने" की आदत विकसित करें।

3. शीघ्र शब्द प्रभाव अस्थिर है?

   "लक्ष्य, सीमाएँ, मौजूदा कोड और अपेक्षित सत्यापन" के चार तत्व लिखें; यदि प्रभाव अच्छा नहीं है, तो दूसरे शब्दों के साथ पुनः प्रयास करें।

4. पर्याप्त निःशुल्क कोटा नहीं?

   एआई को पहले "परीक्षण उत्पन्न करना, कोड की व्याख्या करना और टिप्पणियाँ लिखना" जैसे कम-आवृत्ति कार्यों को संभालने दें; जब तक कोटा पर्याप्त न हो जाए या जब आप अपनी सदस्यता को अपग्रेड न कर लें, तब तक उच्च-आवृत्ति रीफैक्टरिंग छोड़ दें।

5. टीम एआई उपयोग विशिष्टताओं को कैसे एकीकृत करती है?

   साझा दस्तावेज़ों में .cursorrules, त्वरित शब्द टेम्पलेट्स और सुरक्षा रेडलाइन को अवक्षेपित करें और उन्हें नए उपयोगकर्ताओं के लिए ऑनबोर्डिंग में शामिल करें।

6. यदि विभिन्न परियोजनाओं की शैलियाँ बहुत भिन्न हों तो मुझे क्या करना चाहिए?

   प्रत्येक प्रोजेक्ट के लिए .cursorrules को अलग से बनाए रखें और क्रॉस-प्रोजेक्ट शैलियों से बचने के लिए उन्हें गोदाम में समान रूप से प्रबंधित करें।

सारांश और अगले चरण

इस बिंदु पर, आपने "समापन" से "एजेंट परिवर्तन" से "परीक्षण मरम्मत" तक संपूर्ण उपयोग में महारत हासिल कर ली है। पहले 2-3 दिनों के लिए नमूना परियोजनाओं के साथ अभ्यास करने की सिफारिश की जाती है, और फिर वास्तविक गोदामों में कम जोखिम वाले मॉड्यूल पर अभ्यास किया जाता है; अंत में, .cursorrules और शीघ्र शब्द टेम्पलेट्स को टीम संपत्ति के रूप में संचित किया जा सकता है।

उन्नति और विस्तार

• कमांड लाइन एजेंट: टर्मिनल में बैच पुनर्निर्माण को पूरा करने के लिए क्लाउड कोड का उपयोग करें।
• स्वचालित समीक्षा: एआई को स्व-मूल्यांकन और समीक्षा राय उत्पन्न करने दें, और अंतिम समीक्षा मैन्युअल रूप से की जाएगी।
• निजीकरण मॉडल: उच्च-संवेदनशीलता वाली परियोजनाएं स्थानीय परिनियोजन मॉडल से जुड़ी हैं ताकि यह सुनिश्चित किया जा सके कि कोड इंट्रानेट को न छोड़े।
• दक्षता माप: रिकॉर्ड अपनाने की दर और पुनर्कार्य दर, त्रैमासिक समीक्षा और पुनरावृत्ति शीघ्र शब्द संपत्ति।