कार्यप्रवाह और स्वचालन

एक AI कोडबेस पुरातात्विक सबूत पैकेट तैयार करें अपने एजेंट विरासत कोड को छूने से पहले

AI एजेंटों को विरासत कोड संपादित करने से पहले एक साक्ष्य पैकेट की आवश्यकता होती है, परिवर्तन सीमाओं का मानचित्रण, निष्पादन पथ, गिट इतिहास, परीक्षण और अज्ञात जोखिम।

मुख्य जानकारी

  • AI कोडिंग एजेंटों से पहले अपरिचित विरासत कोड संपादित करें, एक संक्षिप्त साक्ष्य पैकेट बनाने के लिए केवल-पढ़ने योग्य कोडबेस पुरातत्व वर्कफ़्लो का उपयोग करें जो बताता है कि परिवर्तन क्या छूता है, दावे कहां से आते हैं और क्या अज्ञात रहता है।
  • एक स्वच्छ पैच योजना अभी भी असुरक्षित हो सकती है क्योंकि छिपे हुए जोखिम कॉल पथ, गिट इतिहास, उत्पादन व्यवहार, बाहरी अनुबंधों, परीक्षण या अलिखित निर्णय से आ सकते हैं।
  • साक्ष्य पैकेट में छह भाग शामिल होने चाहिए: संकीर्ण परिवर्तन सीमाएं, सटीक कोड संदर्भों के साथ एक ठोस निष्पादन पथ, प्रासंगिक गिट इतिहास, लक्षण परीक्षण, मान्यताओं और अज्ञात, और अनुमति गेट के साथ परिवर्तन अनुबंध।
  • कार्यप्रवाह को दो पास में चलाएं: पहले ट्रैक की गई फ़ाइलों को संपादित किए बिना पैकेट का अन्वेषण और उत्पादन करें, फिर मानव समीक्षा के बाद केवल एक सीमित परिवर्तन करें.

मेटा विवरणः Use AI कोडबेस पुरातत्व एक एजेंट विरासत कोड को संपादित करने से पहले छह-भाग सबूत पैकेट बनाने के लिए, छिपी हुई मान्यताओं और जोखिम भरा पैच को कम करता है।

टैगः AI कोडिंग एजेंट, कोडबेस पुरातत्व, विरासत कोड, गिट इतिहास, लक्षण परीक्षण

चित्रित छवि संकेत: एक आवर्धक कांच स्कैनिंग कोड शाखाओं, प्रतिबद्ध बिंदुओं और परीक्षण जांच के सार, दोस्ताना चित्रण, कोई वास्तविक लोग नहीं हैं, कोई लोगो, कोई पाठ।

AI कोडबेस पुरातत्व उन टीमों के लिए एक रीड-ओनली वर्कफ़्लो है जो अपरिचित रिपॉजिटरी में AI कोडिंग एजेंट का उपयोग करते हैं। मूल विचार सरल हैः इससे पहले कि किसी एजेंट को संपादित करने की अनुमति दी जाए, उसे एक छोटा सा सबूत पैकेट तैयार करना होगा जो बताता है कि प्रस्तावित परिवर्तन क्या छूता है, जहां से प्रत्येक दावा आता है, और क्या अज्ञात रहता है। यह डेवलपर्स, रखरखावकर्ताओं और समीक्षकों के लिए है जिन्हें आश्वस्त लेकिन पतली योजनाओं को पुनः प्रयास नियमों, अनुपालन लॉग्स, बाहरी क्लाइंट इंटीग्रेशन या छिपे हुए दुष्प्रभावों को तोड़ने से रोकने की आवश्यकता होती है। स्रोत OpenAI के नियोजित अधिग्रहण के साथ Pierre Computer Company की आवश्यकता को फ्रेम करता है, जिसमें ऐसे उपकरणों की ओर व्यापक धक्का दिया गया है जो डेवलपर को कोड बनाने, समझने और समीक्षा करने में मदद करेंगे।

क्यों एक स्वच्छ पैच योजना अभी भी असुरक्षित हो सकती है

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

साक्ष्य पैकेट क्या होना चाहिए

साक्ष्य पैकेट एक वास्तुकला दस्तावेज नहीं है और एजेंट नोट्स की कच्ची प्रतिलिपि नहीं है। यह एक बदलाव से जुड़ा हुआ एक छोटा आर्टिफैक्ट है. यह एक समीक्षक को वही सामग्री देता है जो वे पहले लिखने के अनुमोदन से पहले चाहते हैंः दायरे में व्यवहार, प्रवेश और निकास बिंदुओं, प्रत्येक दावे के लिए स्रोत, अनिश्चितता लेबल, और विलय से पहले आवश्यक जांच। पैकेट भी संकेत बदलता है। "इस रिपॉजिटरी को समझाएं" एक व्यापक सारांश आमंत्रित करता है।

पैकेट के छह भाग

स्रोत छह खंडों की सिफारिश करता है।

  1. प्रश्न और सीमाएँ बदलें. एक संकीर्ण प्रश्न से शुरू करें, जैसे कि क्या होता है जब रद्द की गई सदस्यता को उसके चालान के संग्रहण के बाद पुनः प्रयास किया जाता है। दायरे में सूचीबद्ध क्षेत्र और आउट-ऑफ-स्कोप क्षेत्रों, वर्तमान शाखा और प्रतिबद्धता, पर्यावरण मान्यताओं, और यदि कार्य केवल पढ़ने योग्य है या नहीं। बिना संशोधन के कोड दावा पहले ही पुराना हो सकता है।
  1. एक ठोस निष्पादन पथ. एजेंट को ट्रिगर से स्थायी साइड इफेक्ट तक एक वास्तविक इनपुट का पालन करने के लिए कहें। अनुरोध के लिए, इसमें मार्ग, प्राधिकरण, हैंडलर, डोमेन नियम, दृढ़ता, ईवेंट प्रकाशन और पृष्ठभूमि उपभोक्ता शामिल हो सकते हैं। प्रत्येक हॉप में एक सटीक फ़ाइल पथ प्लस प्रतीक या लाइन रेंज संलग्न होना चाहिए। एक आरेख मदद कर सकता है, लेकिन समीक्षक को कोड पर कूदने में सक्षम होना चाहिए
  1. इतिहास जो विषम कोड की व्याख्या करता है. वर्तमान फ़ाइलें दिखाती हैं कि क्या मौजूद है; इतिहास संकेत दे सकता है क्यों। एक अनावश्यक गार्ड किसी घटना का अनुसरण कर सकता है, दो फाइलें एक साथ बदल सकती हैं, या एक अस्थायी एडाप्टर पुराने क्लाइंट को सुरक्षित रख सकता है। Targeted Git चेक पर्याप्त हैं, जैसे git log -S archiveInvoice --all -p -- src/billing, git log --follow --date=short --format='%h %ad %s' --src / billing / retry.ts, या co-change count over src / bill. आउटपुट को लीड के रूप में माना जाना चाहिए, सबूत नहीं।
  1. व्यवहार जांच और लक्षण परीक्षण. स्थैतिक रीडिंग निर्भरता इंजेक्शन को याद कर सकता है, फ़ीचर झंडे, पुनः प्रयास, दिनांक हैंडलिंग और डेटा आकार। एक चरित्रकरण परीक्षण रिकॉर्ड करता है कि सिस्टम आज क्या करता है बजाय टीम की इच्छा के लिए जो उसने किया था। संग्रहीत-इनवॉइस रिट्री के लिए, परीक्षण यह दावा कर सकते हैं कि परिणाम स्थिति को छोड़ दिया गया है, भुगतान गेटवे चार्ज नहीं कहा जाता है, और ऑडिट लॉग रिकार्ड्स retry_skipped। एक हरे रंग का परीक्षण साबित होता है कि परीक्षण चलाया गया, न कि इसने सही वादा कैप्चर किया।
  1. मान्यताएं, अज्ञात और असत्यापित जांच. यह खंड एक पॉलिश रिपोर्ट को भ्रम बनने से रोकता है। एजेंट को सूचीबद्ध करना चाहिए कि वह क्या स्थापित नहीं कर सकाः लापता उत्पादन कॉन्फ़िगरेशन, अदस्तावेज़ विक्रेता पुनः प्रयास नीति, अनुपस्थित फिक्स्चर या APP रिपॉजिटरी के बाहर डेटाबेस ट्रिगर। प्रत्येक महत्वपूर्ण धारणा के लिए, सबसे सस्ता चेक का नाम दें जो इसे खारिज कर सकता है। अनजान ब्लॉक नहीं किया गया है; इसका मतलब है कि अगले अपरिवर्तनीय चरण में चयनित साक्ष्य की आवश्यकता होती है।
  1. अनुबंध और अनुमति गेट को बदलें। एक संकीर्ण लेखन प्रस्ताव के साथ समाप्त करेंः फ़ाइलों की अनुमति है, सीमाओं से बाहर फाइलें, परीक्षण आवश्यक हैं, और चेकपॉइंट्स को मानव समीक्षा की आवश्यकता होती है। सुरक्षित लिखना एक नामित मॉड्यूल तक सीमित हो सकता है और एक अलग शाखा पर केंद्रित परीक्षण किया जा सकता है। मानवीय जांच बिंदु स्कीमा परिवर्तन, एक्सेस कंट्रोल, भुगतान व्यवहार, सार्वजनिक ठेके या अनसुलझे उच्च-प्रभाव मान्यताओं को कवर कर सकते हैं। स्टॉप स्थितियों में एक नया कॉल पथ, unmodeled साइड इफेक्ट, असफल चरित्रकरण परीक्षण, या सबूत शामिल हो सकते हैं जो पैकेट का खंडन करता है।

दो पास में कार्यप्रवाह चलाएँ

अधिकांश टीमों को एक नए प्लेटफ़ॉर्म की आवश्यकता नहीं होती है। उन्हें अन्वेषण और संशोधन के बीच दोहराए जाने वाले विभाजन की आवश्यकता होती है. पास में, एजेंट को केवल-पढ़ने का उपयोग मिलता है जहां टूलींग इसकी अनुमति देता है। यह सबसे छोटा व्यवहार मानचित्रित करता है, प्रासंगिक इतिहास का निरीक्षण करती है, परीक्षणों का पता लगाती है, और पैकेट लिखती है। वह सुरक्षित स्थानीय कमांड चला सकती है, लेकिन इसे ट्रैक किए गए फ़ाइलों को संपादित नहीं करना चाहिए, बुनियादी ढांचे को बदलना चाहिए, उत्पादन सेवाओं को कॉल करना चाहिए या रास्ते में असफल परीक्षण ठीक करना चाहिए। समीक्षा प्रश्न व्यावहारिक हैः क्या कोई अन्य इंजीनियर कुछ ही मिनटों में उद्धृत साक्ष्य से दावे को पुनः पेश कर सकता है? यदि नहीं, तो दावे को बेहतर स्रोत या कम विश्वसनीयता लेबल की आवश्यकता है।

पास दो में, एजेंट पैकेट की समीक्षा के बाद ही एक बाउंड परिवर्तन करता है। पैकेट कार्य संक्षिप्त बन जाता है। अंतिम प्रतिक्रिया में diff सारांश, परीक्षण चलाना, वर्तमान प्रतिबद्ध करना और पैकेट परिवर्तन नोट शामिल होना चाहिए जो बताता है कि कार्यान्वयन के दौरान कौन सी धारणाएं बदल गई हैं। कार्यान्वयन नया सबूत है; एक असफल परीक्षण या अप्रत्याशित कॉल पथ को छिपाए जाने के बजाय मॉडल को अपडेट किया जाना चाहिए।

एक पुनः प्रयोज्य केवल-पढ़ने योग्य संकेत

एक आश्वस्त उत्तर के बजाय उपयोगी अनिश्चितता को पुरस्कृत करने वाले संकेत का उपयोग करें।

केवल-पढ़ने के साक्ष्य मोड में प्रवेश करें. फ़ाइलों को संशोधित न करें, कमिट न करें या अंतिम कार्यान्वयन न दें। कार्यः [विशिष्ट व्यवहार या प्रश्न] प्रतिबद्ध करें: [SHA]. दायराः [फ़ोल्डर, सेवा, या घटक] एक छह-भाग सबूत पैकेट वितरित करेंः सवाल और सीमाएं, एक ठोस इनपुट ट्रेस, फाइल और प्रतीक उद्धरण, प्रासंगिक गिट इतिहास संकेत, सुरक्षित व्यवहार जांच, मान्यताओं और असत्यापित चेक के साथ अज्ञात, और एक संकीर्ण लेखन प्रस्ताव। प्रत्येक कथन को पुष्टि की गई, संभावित, या अज्ञात के रूप में लेबल करें। यदि कोई कथन संभव है, तो इसे डिजाइन सिफारिश बनाने से पहले अभी भी लापता प्रमाण का नाम दें।

क्या मापना है

पैकेट या एजेंट सारांश को मुख्य मीट्रिक के रूप में न गिनाएं। मापें कि क्या अभ्यास संशोधनों की समीक्षा करना आसान और समाप्त करने के लिए सुरक्षित बनाता है। ट्रैक करें कि संपादन से पहले एक पैकेट कितनी बार लापता आवश्यकता को उजागर करता है, कितनी बार सूचीबद्ध अनिश्चितता वास्तविक समस्या बन जाती है, और कितनी बार कोई एजेंट अपनी अनुमोदित फ़ाइल सीमा के भीतर रहता है। विस्फोट त्रिज्या के साथ पैकेट का मिलान करेंः एक-पंक्ति फिक्स को छोटे पैकेट की आवश्यकता हो सकती है, जबकि बिलिंग माइग्रेशन को गहरे ट्रेस, उत्पादन समीक्षा और एक से अधिक मालिक की आवश्यकता पड़ सकती है।

आम गलतियाँ

पहली गलती सबूत के रूप में एक लंबे context window का इलाज कर रही है। अधिक फाइलें एजेंट को अधिक सुराग दे सकती हैं, लेकिन वे रनटाइम स्टेट, अनदस्तावेज ऑपरेशंस या लापता बाहरी अनुबंधों को प्रकट नहीं करती हैं। दूसरी गलती दस्तावेजीकरण के रूप से एक फैली हुई एजेंट ट्रांसक्रिप्ट को सहेजना है। प्रतिलेख खोजों, मृत अंत और पुराने अनुमानों को मिलाते हैं; इसके बजाय पैकेट डिस्टिल करते हैं। तीसरी गलती प्रगति से पहले पूर्ण समझ की मांग करना है। यह विश्लेषण पक्षाघात पैदा करता है। लक्ष्य सही निश्चितता नहीं है। अगले सुरक्षित चरण के बारे में समर्थन निर्णय है।

Comments (0)

  1. No comments yet. Be the first to share what worked for you.

Leave a comment

Comments are reviewed before they appear. Your email address is not published.