Contributing

पुल रिक्वेस्ट समीक्षा प्रवाह

यह पृष्ठ OpenClaw पुल रिक्वेस्ट खोलने या अपडेट करने के बाद के समीक्षा प्रवाह की व्याख्या करता है: Barnacle और ClawSweeper क्या करते हैं, उनके फ़ीडबैक के आधार पर PR को कैसे बेहतर बनाया जाए, और ऑटोमेशन से कोई प्रतिक्रिया न मिलने पर क्या जाँचा जाए।

Barnacle और ClawSweeper समीक्षा कतार को उपयोगी बनाए रखने में मेंटेनरों की सहायता करते हैं। वे मेंटेनर के निर्णय का स्थान नहीं लेते।

Barnacle

Barnacle नियतात्मक GitHub ट्रायेज है। यह ज्ञात कतार-प्रबंधन मामलों की तलाश करता है और लेबल, टिप्पणियों या क्लोज़र के माध्यम से प्रतिक्रिया देता है।

Barnacle निम्न स्थितियों में कार्रवाई कर सकता है:

PR का मुख्य भाग लगभग खाली है या उसमें समस्या का संदर्भ मौजूद नहीं है;
PR में कोई उपयोगी प्रमाण नहीं है;
केवल दस्तावेज़, केवल परीक्षण, केवल रीफ़ैक्टर, केवल CI या इंफ़्रा परिवर्तन में लिंक किया हुआ मेंटेनर संदर्भ मौजूद नहीं है;
परिवर्तन ऐसा लगता है कि वह कोर के बजाय ClawHub या किसी Plugin में होना चाहिए;
ब्रांच में असंबंधित कार्य मौजूद है;
लेखक के 20 से अधिक खुले PR हैं।

Barnacle विश्वसनीय रिपॉज़िटरी वर्कफ़्लो कोड से चलता है। यह योगदानकर्ता के कोड को चेक आउट या रन नहीं करता।

अधिकांश रूटिंग लेबल मेंटेनर या ऑटोमेशन संकेत होते हैं, इसलिए योगदानकर्ताओं को स्वयं लेबल जोड़ने की आवश्यकता नहीं होती।

ClawSweeper

ClawSweeper, OpenClaw रिपॉज़िटरी के लिए AI-सहायित समीक्षा और रखरखाव बॉट है। यह PR की समीक्षा कर सकता है, प्रमाण का मूल्यांकन कर सकता है, स्थायी समीक्षा टिप्पणियाँ छोड़ सकता है, और सुरक्षित सुधार या ऑटोमर्ज प्रवाह में मेंटेनरों की सहायता कर सकता है।

ClawSweeper का सकारात्मक परिणाम सहायक प्रमाण है, मेंटेनर की स्वीकृति नहीं। PR मर्ज करने के लिए कब और क्या वह तैयार है, इसका निर्णय अब भी मेंटेनर ही करते हैं।

ClawSweeper कतार-आधारित है। PR खोलने, कमिट पुश करने या समीक्षा अनुरोध जोड़ने के बाद तत्काल प्रतिक्रिया की अपेक्षा न करें। ClawSweeper रन के बाद लेबल अपडेट होने में भी समय लग सकता है।

नए PR ClawSweeper समीक्षा कतार में जाते हैं। मेंटेनर लेबल या कमांड के माध्यम से समीक्षा, सुधार या ऑटोमर्ज प्रवाह भी कतार में डाल सकते हैं। सामान्य योगदानकर्ता अपडेट के लिए ClawSweeper से अगली समीक्षा केवल ब्रांच, PR विवरण, प्रमाण या कोड अपडेट करने के बाद ही माँगें। फिर एक नई PR टिप्पणी के माध्यम से नई समीक्षा का अनुरोध करें:

text

@clawsweeper re-review

PR लेखक @clawsweeper re-run का भी उपयोग कर सकते हैं; रिपॉज़िटरी में लिखने की पहुँच वाले उपयोगकर्ता किसी भी खुले आइटम पर दोनों में से किसी कमांड का उपयोग कर सकते हैं। सामान्य @clawsweeper review कमांड केवल मेंटेनरों के लिए है। धैर्य रखें: अनुरोधित परिवर्तन मौजूद होने से पहले दोबारा पूछने पर केवल कतार में अनावश्यक शोर बढ़ता है।

जब ClawSweeper समीक्षा वार्तालाप छोड़ता है, तो उन्हें सामान्य समीक्षा फ़ीडबैक की तरह लें और नीचे दी गई फ़ॉलो-अप चेकलिस्ट का उपयोग करें।

यदि किसी मानव योगदानकर्ता या मेंटेनर ने PR का काम संभाल लिया है और उस पर सक्रिय रूप से कार्य कर रहा है, तो उसी समय ClawSweeper को न बुलाएँ और न ही किसी अन्य तरह से PR पर काम करें। पहले मानव समीक्षा या सुधार पूरा होने दें। यदि गतिविधि रुक जाती है, तो जाँचें कि क्या लेखक से प्रमाण देने या अन्य अपडेट करने को कहा गया था।

समीक्षा के दौरान PR को बेहतर बनाएँ

Barnacle, ClawSweeper या मेंटेनर की प्रतिक्रिया मिलने के बाद उस फ़ीडबैक को PR की अगले चरण की चेकलिस्ट के रूप में उपयोग करें।

ClawSweeper के Rank-up moves: और Proof guidance: को उस PR की कार्रवाई सूची के रूप में पढ़ें। रेटिंग और लेबल समीक्षा संकेत हैं, निश्चित मर्ज लक्ष्य नहीं।
अनुरोधित कोड या दस्तावेज़ परिवर्तन पुश करें और समस्या, समाधान, उपयोगकर्ता प्रभाव या प्रमाण बदलने पर PR विवरण अपडेट करें।
परिवर्तन से मेल खाने वाले प्रमाण का उपयोग करके अनुरोधित प्रमाण जोड़ें।
जिन समीक्षा वार्तालापों का समाधान हो चुका है, उन्हें स्वयं हल करें। उत्तर देकर वार्तालाप को केवल तभी खुला छोड़ें जब आपको मेंटेनर या समीक्षक के निर्णय की आवश्यकता हो।
दोबारा समीक्षा केवल तभी माँगें जब ब्रांच, PR विवरण, प्रमाण और प्रासंगिक CI परिणाम वर्तमान हों। लेखक, मेंटेनर और ClawSweeper के बीच अपडेट और समीक्षा के कई चक्र सामान्य हैं।
जहाँ संभव हो, चर्चा को PR पर ही रखें। Discord पर #clawtributors पर केवल तभी जाएँ जब PR के लिए मेंटेनर समन्वय आवश्यक हो, ऑटोमेशन अवरुद्ध प्रतीत हो, या अगला निर्णय GitHub टिप्पणियों में तय करना कठिन हो। PR लिंक, वर्तमान स्थिति और विशिष्ट प्रश्न या शेष प्रमाण शामिल करें।

PR के मुख्य भाग को वर्तमान रखें। टिप्पणियाँ चर्चा में सहायक होती हैं, लेकिन PR विवरण वह स्थायी सारांश है जिसे मेंटेनर और ऑटोमेशन दोबारा देखते हैं।

status: ⏳ waiting on author का अर्थ है कि अगली कार्रवाई PR लेखक को करनी है: अगली समीक्षा माँगने से पहले ब्रांच, PR विवरण या प्रमाण अपडेट करें अथवा छूटा हुआ संदर्भ देकर उत्तर दें।

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

संवेदनशील डेटा को संशोधित करना योगदानकर्ता की ज़िम्मेदारी है। प्रमाण पोस्ट करने से पहले सीक्रेट, टोकन, निजी URL, उपयोगकर्ता डेटा और असंबंधित लॉग हटा दें।

OpenClaw अलग निष्क्रियता ऑटोमेशन का भी उपयोग करता है। असाइन न किए गए इश्यू और PR को 14 दिनों की निष्क्रियता के बाद निष्क्रिय चिह्नित किया जा सकता है और फिर 7 अतिरिक्त निष्क्रिय दिनों के बाद बंद किया जा सकता है। असाइन किए गए PR को खोलने के 27 दिन बाद निष्क्रिय चिह्नित किया जाता है, बाद के अपडेट चाहे जो भी हों, और फिर बिना गतिविधि के 7 निष्क्रिय दिनों के बाद बंद किया जाता है। यदि असाइन किया गया PR अब भी सक्रिय है, तो उस पर काम कर रहे मेंटेनर के साथ समन्वय करें।

जब ऑटोमेशन से कोई प्रतिक्रिया न मिले

जब कोई मेंटेनर पहले से आइटम संभाल रहा हो, समीक्षा या सुधार अनुरोध अब भी कतार में हो, ईवेंट सामान्य हो या अनुरोधित कार्रवाई के लिए ClawSweeper लेन कॉन्फ़िगर न हो, तब ऑटोमेशन से कोई प्रतिक्रिया नहीं मिल सकती।

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

समस्या निवारण

यदि ClawSweeper तुरंत प्रतिक्रिया नहीं देता, तो दोबारा प्रयास करने से पहले प्रतीक्षा करें। सेवा कतार-आधारित है और बार-बार की गई टिप्पणियाँ या लेबल परिवर्तन कतार को तेज़ किए बिना थ्रेड की समीक्षा कठिन बना सकते हैं।

सहायता माँगने से पहले जाँचें:

PR विवरण वर्तमान है;
नवीनतम कमिट में अनुरोधित परिवर्तन मौजूद है;
CI पूरा हो चुका है या PR का मुख्य भाग बताता है कि शेष विफलता PR से असंबंधित क्यों है;
नवीनतम समीक्षा अनुरोध PR टिप्पणी के रूप में किया गया था: @clawsweeper re-review;
कोई मेंटेनर या योगदानकर्ता पहले से PR पर सक्रिय रूप से काम नहीं कर रहा है;
नवीनतम अनुरोध अब भी सामान्य ClawSweeper कतार विलंब के भीतर नहीं है।

PR के वर्तमान होने के कई घंटे बाद भी ClawSweeper की प्रतिक्रिया न मिले, या PR ऑटोमेशन के कारण अवरुद्ध प्रतीत हो, तो Discord पर #clawtributors में पूछें। PR लिंक, आपकी अपेक्षा, अनुरोध करने का समय और अंतिम बॉट टिप्पणी के बाद हुए परिवर्तन शामिल करें।

ऑटोमेशन को फ़ोर्क करना

समान समीक्षा ऑटोमेशन चाहने वाले प्रोजेक्ट ClawSweeper का अध्ययन या फ़ोर्क कर सकते हैं: