Skip to main content
यह पृष्ठ 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 टिप्पणी के साथ नई समीक्षा का अनुरोध करें:
PR लेखक @clawsweeper re-run का भी उपयोग कर सकते हैं; रिपॉज़िटरी में लिखने की पहुँच वाले उपयोगकर्ता किसी भी खुले आइटम पर दोनों में से किसी कमांड का उपयोग कर सकते हैं। सामान्य @clawsweeper review कमांड केवल मेंटेनर के लिए है। धैर्य रखें: अनुरोधित परिवर्तन उपलब्ध होने से पहले फिर से पूछने से केवल कतार में शोर बढ़ता है। जब ClawSweeper समीक्षा वार्तालाप छोड़ता है, तो उन्हें सामान्य समीक्षा फ़ीडबैक की तरह लें और नीचे दी गई फ़ॉलो-अप चेकलिस्ट का उपयोग करें। यदि किसी मानव योगदानकर्ता या मेंटेनर ने PR की ज़िम्मेदारी ले ली है और उस पर सक्रिय रूप से काम कर रहा है, तो उसी समय ClawSweeper को न बुलाएँ और न ही किसी अन्य तरीके से PR पर काम करें। पहले मानव समीक्षा या मरम्मत पूरी होने दें। यदि गतिविधि रुक जाती है, तो जाँचें कि लेखक से प्रमाण देने या अन्य अपडेट करने को कहा गया था या नहीं।

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

Barnacle, ClawSweeper या किसी मेंटेनर की प्रतिक्रिया मिलने पर उस फ़ीडबैक को PR के अगले चरण की चेकलिस्ट के रूप में उपयोग करें।
  1. ClawSweeper के Rank-up moves: और Proof guidance: को उस PR की कार्य-सूची के रूप में पढ़ें। रेटिंग और लेबल समीक्षा संकेत हैं, निश्चित मर्ज लक्ष्य नहीं।
  2. अनुरोधित कोड या दस्तावेज़ परिवर्तन पुश करें और जब समस्या, समाधान, उपयोगकर्ता प्रभाव या प्रमाण बदल जाए, तो PR विवरण अपडेट करें।
  3. परिवर्तन के अनुरूप प्रमाण का उपयोग करके अनुरोधित प्रमाण जोड़ें।
  4. संबोधित समीक्षा वार्तालाप स्वयं हल करें। उत्तर देकर वार्तालाप को केवल तभी खुला छोड़ें जब आपको मेंटेनर या समीक्षक के निर्णय की आवश्यकता हो।
  5. दोबारा समीक्षा केवल तभी माँगें जब ब्रांच, PR विवरण, प्रमाण और प्रासंगिक CI परिणाम वर्तमान हों। लेखक, मेंटेनर और ClawSweeper के बीच कई अपडेट और समीक्षा चक्र सामान्य हैं।
  6. जहाँ संभव हो, चर्चा 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 का अध्ययन या फ़ोर्क कर सकते हैं:

संबंधित