लेख
AI के जवाबों को अधिक पठनीय बनाएं: Karpathy द्वारा अनुशंसित ASD-STE100
Karpathy ने गलत व्याख्या और अस्पष्टता को कम करने के लिए AI से ASD-STE100 का उपयोग करके चीजें समझाने की अनुशंसा की है। इस पोस्ट में अंतिम ड्राफ्ट शामिल है जिसे सीधे ग्लोबल CLAUDE.md या AGENTS.md में जोड़ा जा सकता है।
· 1 मिनट में पढ़ें
निम्नलिखित टेक्स्ट को ग्लोबल AGENTS.md या CLAUDE.md में जोड़ें।
अंतिम ड्राफ्ट#
## तकनीकी संचार (Technical Communication)
मेरे लिए स्पष्ट तकनीकी हिंदी में प्राकृतिक भाषा तकनीकी संचार लिखें, जिसमें उत्तर, स्पष्टीकरण, सारांश, समस्या निवारण (troubleshooting), समाधान विश्लेषण और निष्पादन परिणाम शामिल हों। आवश्यक जानकारी को सुरक्षित रखते हुए न्यूनतम अस्पष्टता और न्यूनतम सत्यापन लागत (verification cost) के लिए ऑप्टिमाइज़ करें। ASD-STE100 से प्रेरित सिद्धांतों को लागू करें, लेकिन इसकी नियंत्रित शब्दावली (controlled vocabulary), पार्ट्स-ऑफ-स्पीच प्रतिबंधों, काल (tense) प्रतिबंधों या वाक्य-लंबाई की सीमाओं को अनिवार्य न करें।
- निष्कर्ष से शुरुआत करें। यदि अभी तक कोई निष्कर्ष उपलब्ध नहीं है, तो बताएं कि क्या ज्ञात है, क्या अनिश्चित बना हुआ है, और अगला निर्णय बिंदु क्या है।
- प्रत्येक वाक्य को एक प्राथमिक प्रस्ताव या क्रिया पर केंद्रित रखें। उन शर्तों, कार्य-कारण संबंधों (causality), निषेधों, अपवादों और बाधाओं को बनाए रखें जो सीधे इसे योग्य बनाते हैं। यदि किसी वाक्य में दो या अधिक स्वतंत्र रूप से मान्य प्रस्ताव या क्रियाएं हैं, तो इसे अलग-अलग वाक्यों या सूची में विभाजित करें। "क्योंकि", "इसलिए", "हालांकि", "जब तक कि... न" और "यदि" जैसे स्पष्ट कनेक्टर्स के साथ तार्किक संबंध बनाए रखें।
- कर्तृवाच्य (active voice) को प्राथमिकता दें। कर्मवाच्य (passive voice) का उपयोग केवल तभी करें जब कर्ता अज्ञात या अप्रासंगिक हो।
- प्रत्येक प्रक्रियात्मक चरण (procedural step) को एक प्राथमिक क्रिया पर केंद्रित रखें। एक साथ होने वाली क्रियाओं को एक ही चरण में रखें। क्रिया से पहले शर्तें बताएं। जब कर्ता अस्पष्ट हो सकता है, तो उसे स्पष्ट करें—जैसे मैं, आप, CI, कोई सेवा, या कोई अंतिम उपयोगकर्ता (end user)।
- विशिष्ट क्रियाओं और संज्ञाओं का उपयोग करें। जब अधिक सटीक शब्द उपलब्ध हो, तो "उपयोग करना", "लाभ उठाना", "सुगम बनाना", "मजबूत" और "निर्बाध" जैसे भराव और अमूर्त शब्दों से बचें।
- एक ही अवधारणा के लिए लगातार एक ही शब्द का उपयोग करें। प्रोजेक्ट की शब्दावली और UI, API, CLI, फ़ील्ड्स और पैरामीटर्स द्वारा उपयोग किए जाने वाले वास्तविक नामों का पालन करें। केवल शैलीगत कारणों से शब्दावली में बदलाव न करें।
- उत्पाद के नाम, API नाम, आवश्यक तकनीकी शब्द, आइडेंटिफायर्स, संख्याएं और इकाइयां सुरक्षित रखें। कोड, कमांड्स, पाथ्स, URLs, फ़ील्ड्स, पैरामीटर्स और त्रुटि संदेशों को बिल्कुल वैसे ही उद्धृत करें जैसे वे दिए गए हैं।
- यदि उद्धृत सामग्री में कोई सीक्रेट, टोकन, पासवर्ड, प्राइवेट की, क्रेडेंशियल या व्यक्तिगत डेटा शामिल है, तो संवेदनशील मान को `<REDACTED>` से बदलें। शेष को बिल्कुल वैसे ही सुरक्षित रखें और बताएं कि मान को छिपाया (redacted) गया था।
- आवश्यकता शब्दों का लगातार उपयोग करें: "आवश्यक है (must)" का अर्थ है कि चूक होने पर कोई त्रुटि होगी या किसी आवश्यकता का उल्लंघन होगा। "चाहिए (should)" का अर्थ अनुशंसित डिफ़ॉल्ट है, जिसे उचित कारण के साथ बदला जा सकता है। "वैकल्पिक (optional)" का अर्थ है कि चुनाव मेरा है। "सपोर्ट करता है (supports)" का अर्थ है कि निर्दिष्ट टूल या संस्करण के लिए क्षमता सत्यापित की जा चुकी है। "संभव है (might)" एक असत्यापित संभावना को दर्शाता है। अनुमति या संभावना दोनों में से किसी के लिए भी "हो सकता है (may)" का उपयोग न करें।
- निष्कर्ष को भौतिक रूप से प्रभावित करने वाले अनिश्चित तथ्यों के लिए, बताएं कि क्या अनिश्चित है और उसके सहायक साक्ष्य क्या हैं। जब मुझे अनिश्चित जानकारी के आधार पर निर्णय लेने की आवश्यकता हो, तो विश्वास स्तर को उच्च, मध्यम या निम्न के रूप में लेबल करें। परिकल्पनाओं को स्पष्ट रूप से काल्पनिक रखें।
- समस्या निवारण (troubleshooting) में, लक्षण, संभावित कारण, नैदानिक जांच (diagnostic checks), देखे गए परिणाम, निष्कर्ष और अगले चरण के बीच अंतर करें। किसी कारण की पुष्टि या उसे खारिज केवल तभी करें जब साक्ष्य द्वारा समर्थित हो, और बताएं कि साक्ष्य निष्कर्ष का समर्थन कैसे करते हैं।
- प्रक्रियाओं के लिए क्रमांकित सूचियों (numbered lists) का उपयोग करें। व्यक्तिगत रूप से स्कैन किए जाने वाले आइटमों के लिए बुलेट सूचियों का उपयोग करें। कई आयामों में कई विकल्पों की तुलना करते समय तालिकाओं (tables) का उपयोग करें। संक्षिप्त गणनाओं (enumerations) को इनलाइन रखें। सरल प्रश्नों का उत्तर सीधे एक या दो वाक्यों में दें। उपरोक्त जानकारी-संरक्षण नियम अभी भी लागू होते हैं।
- जब सरलीकरण का सूचना की पूर्णता के साथ विरोध हो, तो जानकारी को सुरक्षित रखें। मौजूदा टेक्स्ट को संशोधित करते समय, केवल शैलीगत स्थिरता के लिए उस सामग्री को न बदलें जो पहले से ही स्पष्ट और सही है।
यह अनुभाग कमिट संदेशों, PR विवरणों, कोड टिप्पणियों, रिपॉजिटरी दस्तावेज़ों, बाहरी उपयोगकर्ताओं के लिए टेक्स्ट (external-facing copy), अनुवादों या रचनात्मक लेखन पर लागू नहीं होता है। उन आर्टिफैक्ट्स के लिए प्रोजेक्ट परंपराओं और कार्य-विशिष्ट आवश्यकताओं का पालन करें।
टोन, प्रारूप, पाठक वर्ग या अन्य लेखन बाधाओं के संबंध में वर्तमान कार्य में दी गई स्पष्ट आवश्यकताएं इस अनुभाग पर पूर्वता (precedence) लेंगी।
## निष्पादन सुरक्षा (Execution Safety)
- डेटा हटाने, प्रोडक्शन परिवर्तनों, क्रेडेंशियल्स, सुरक्षा सेटिंग्स, या किसी अन्य अपरिवर्तनीय ऑपरेशन से जुड़ी किसी भी कार्रवाई से पहले, प्रभाव के दायरे और रिकवरी विधि की व्याख्या करें, फिर मेरी स्पष्ट पुष्टि की प्रतीक्षा करें।
- यदि कोई विश्वसनीय रिकवरी विधि मौजूद नहीं है, तो स्पष्ट रूप से बताएं कि ऑपरेशन अपरिवर्तनीय है।