Copilot को हर बार नियम न लिखें—सही निर्देश फाइल चुनें
GitHub Copilot को निर्माण, परीक्षण और कोड शैली के नियम बार-बार बताने से बचने के लिए पूरी परियोजना के नियम .github/copilot-instructions.md में रखें। केवल चुने हुए पथों पर लागू नियम .github/instructions/*.instructions.md में और कई संगत कोडिंग एजेंटों के साझा कार्यस्थल नियम AGENTS.md में रखें।
सामान्य परियोजना में एक व्यापक फाइल से शुरुआत करें और पथ-विशेष फाइल तभी जोड़ें जब वास्तविक अपवाद हो। किसी विशेष एजेंट की भूमिका—जैसे सुरक्षा समीक्षा—साझा परियोजना नियम नहीं है; उसके लिए अलग एजेंट रूपरेखा चाहिए।
दायरे के अनुसार फाइल चुनें
GitHub की रिपॉजिटरी निर्देश प्रक्रिया व्यापक निर्देश, पथ से मिलने वाले निर्देश और एजेंट निर्देशों के अलग स्थान बताती है। व्यापक तथा मेल खाने वाली पथ-विशेष फाइलें एक ही अनुरोध में संदर्भ का हिस्सा बन सकती हैं, इसलिए दोनों में एक ही नियम की प्रतिलिपि नहीं रखनी चाहिए।
- परियोजना-व्यापी फाइल: निर्माण और परीक्षण चलाने की विधि, भंडार की संरचना, सामान्य नामकरण नीति तथा हर बदलाव पर लागू वास्तुकला सीमाएँ।
- पथ-विशेष फाइल: किसी भाषा, सेवा, निर्देशिका या परीक्षण समूह के अतिरिक्त नियम। उसके YAML अग्रभाग में applyTo प्रतिरूप तय करता है कि नियम किन फाइलों पर अपने-आप लागू होगा।
- एजेंट निर्देश फाइल: उन कार्यस्थल नियमों के लिए जिन्हें अलग-अलग संगत AI कोडिंग एजेंटों को समान रूप से मानना चाहिए।
निर्णय का सरल आधार यह है कि नियम कहाँ सत्य रहता है। “सार्वजनिक API की पश्च-संगतता बनाए रखें” पूरी परियोजना का नियम हो सकता है, जबकि “अंत-से-अंत परीक्षण वास्तविक बाहरी सेवा पर निर्भर न हों” केवल संबंधित परीक्षण निर्देशिका का नियम है।
न्यूनतम संरचना को जाँचने योग्य रखें
एक सामान्य परियोजना के लिए छोटा नमूना तीन हिस्सों में बनाया जा सकता है:
- व्यापक फाइल में लिखें: “निर्भरता स्थापित करने, परीक्षण चलाने और शैली जाँचने के लिए परियोजना में पहले से परिभाषित आदेशों का उपयोग करें।”
- पथ-विशेष फाइल में लिखें: “इस निर्देशिका के परीक्षण बाहरी नेटवर्क और वास्तविक घड़ी पर निर्भर नहीं होने चाहिए।”
- साझा एजेंट फाइल केवल तब जोड़ें जब दूसरे एजेंटों को भी वही सत्यापन और सुरक्षा सीमाएँ चाहिए।
निर्देश ऐसे हों जिनका परिणाम देखा जा सके। “अच्छा कोड लिखें” की जगह बताएं कि बदलाव के बाद कौन-सी जाँच सफल होनी चाहिए, नया सार्वजनिक व्यवहार जोड़ने पर कौन-सा परीक्षण अपेक्षित है और किन पैकेजों या परतों के बीच निर्भरता निषिद्ध है।
स्वरूपक या स्थिर विश्लेषक से निश्चित रूप से लागू होने वाला नियम उसके अपने विन्यास में रखना बेहतर है। Copilot की निर्देश फाइल में वे निर्णय अधिक उपयोगी हैं जिन्हें केवल परियोजना का संदर्भ बताता है—जैसे स्वीकृत पुस्तकालय, वास्तुकला की सीमा, उत्पन्न फाइलों को न बदलने का नियम या सत्यापन का क्रम।
साझा नियम और विशेष एजेंट की भूमिका अलग रखें
AGENTS.md किसी एजेंट के लिए कार्यस्थल संबंधी निर्देश दे सकती है, लेकिन वह अपने-आप अलग औजारों और जिम्मेदारियों वाला सुरक्षा समीक्षक या दस्तावेज लेखक नहीं बनाती। GitHub का कस्टम एजेंट विवरण भूमिका, निर्देश और उपलब्ध औजार निर्धारित करने वाली रूपरेखा के लिए .github/agents/CUSTOM-AGENT-NAME.md स्थान बताता है।
इस विभाजन का व्यावहारिक अर्थ स्पष्ट है। “बदलाव के बाद परियोजना की परीक्षण जाँच चलाएँ” साझा सत्यापन नियम है; “केवल सुरक्षा जोखिमों की समीक्षा करें और फाइलें न बदलें” किसी खास एजेंट की भूमिका है। भूमिका को व्यापक निर्देशों में रखने से सामान्य कोडिंग कार्य भी अनचाहे ढंग से सीमित हो सकते हैं।
प्राथमिकता समझें, पर अधिलेखन पर निर्भर न रहें
VS Code के कस्टम निर्देश दस्तावेज में व्यक्तिगत निर्देशों को रिपॉजिटरी और संगठन निर्देशों से ऊपर प्राथमिकता दी गई है। उसी परियोजना की कई लागू फाइलें संयुक्त हो सकती हैं, लेकिन उनके क्रम की गारंटी नहीं है; इसलिए यह मानना सुरक्षित नहीं कि सीमित फाइल व्यापक फाइल के विपरीत नियम को हमेशा अधिलेखित कर देगी।
विरोध ढूँढ़ते समय एक ही विषय को सभी स्तरों पर देखें:
- व्यक्तिगत, संगठन और परियोजना निर्देशों में पैकेज प्रबंधक, उद्धरण शैली, परीक्षण आदेश तथा फाइल बदलने की अनुमति की तुलना करें।
- व्यापक और पथ-विशेष फाइलों में उलटे आदेश हों तो सामान्य नियम को व्यापक रखें और स्पष्ट अपवाद को केवल सीमित दायरे में लिखें।
- हर applyTo प्रतिरूप जाँचें। जरूरत से अधिक व्यापक मिलान किसी सीमित नियम को अनचाहे पथों पर पहुँचा सकता है।
- साझा एजेंट फाइल में उसी नियम की दूसरी प्रति मिले तो एक अधिकारपूर्ण स्थान चुनें और बाकी प्रतियाँ हटाएँ।
- हट चुके औजार, बदली हुई निर्देशिकाएँ और पुराने सत्यापन आदेश निकालें। इन फाइलों की भी सामान्य विन्यास की तरह समीक्षा होनी चाहिए।
लागू निर्देशों की पुष्टि करें
VS Code के वार्तालाप दृश्य में उपलब्ध निदान खोलकर देखा जा सकता है कि कौन-सी निर्देश फाइलें लोड हुईं और उनमें कोई त्रुटि है या नहीं। उत्तर के संदर्भ भाग में भी अनुरोध के साथ जोड़ी गई फाइल दिखाई दे सकती है। यह जाँच अंतःपंक्ति कोड सुझावों पर लागू नहीं होती, क्योंकि ये कस्टम निर्देश वार्तालाप और एजेंट अनुरोधों के संदर्भ के लिए हैं।
पथ-विशेष नियम जाँचने के लिए उसके मिलान वाले पथ की फाइल पर छोटा, स्पष्ट कार्य दें। यदि नियम कहता है कि उस निर्देशिका के परीक्षण बाहरी नेटवर्क पर निर्भर नहीं होंगे, तो Copilot से वहीं नया परीक्षण बनाने की योजना माँगें और संदर्भ में अपेक्षित फाइल देखें। फाइल न मिले तो उसका स्थान, प्रत्यय, मिलान प्रतिरूप और संबंधित संपादक विन्यास जाँचें।
उपयोगी संरचना का लक्ष्य अधिक फाइलें बनाना नहीं, बल्कि हर नियम का एक स्पष्ट अधिकारपूर्ण स्थान तय करना है: परियोजना के लिए एक व्यापक आधार, वास्तविक अपवादों के लिए सीमित फाइलें और विशेष भूमिका के लिए अलग एजेंट रूपरेखा। इससे Copilot को जरूरी संदर्भ स्वतः मिलता है और विरोधी निर्देश छिपना कठिन हो जाता है।
यह भी पढ़ें:
हमारे न्यूज़लेटर की सदस्यता लें
Web3, AI और क्रिप्टो की नवीनतम खबरें सीधे अपने इनबॉक्स में पाएँ।