Github actions and code review

मुख्य अवधारणाएँ: Pull Request (PR) में दोहराए जाने वाले कार्यों का स्वचालन

**I. CodeReview (प्रबंधित समाधान - Managed Solution)**

• परिचय: Anthropic द्वारा होस्ट की गई सेवा जो PRs की समीक्षा करती है।
• कार्यप्रणाली: Cloud GitHub App के माध्यम से PRs की समीक्षा करता है और निष्कर्ष (findings) को इनलाइन कमेंट्स के रूप में पोस्ट करता है।
• लाभ: इसे बनाने या होस्ट करने की आवश्यकता नहीं है।
• प्रक्रिया:
• एक सेट ऑफ रिव्यू एजेंट्स पूरे कोडबेस के विरुद्ध अंतर (diff) का विश्लेषण करता है।
• यह निष्कर्षों को गंभीरता (severity) के अनुसार टैग करता है और चेक रन में एक सारांश तालिका प्रदान करता है।
• यह दोहराव (deduplicates) करता है ताकि उपयोगकर्ता को केवल वास्तविक निष्कर्ष मिलें।
• सीमाएँ:
• यह PR को कभी अप्रूव या ब्लॉक नहीं करता; अंतिम निर्णय मानव का होता है।
• यह केवल निष्कर्ष पोस्ट करता है; इसे लागू करने के लिए स्थानीय टर्मिनल से /code review --fix कमांड का उपयोग करना होगा।
• उपलब्धता: यह एक रिसर्च प्रीव्यू है और वर्तमान में केवल टीम और एंटरप्राइज प्लान के लिए उपलब्ध है।

**II. Cloud Code GitHub Action (स्वयं करें समाधान - DIY Solution)**

• उपयोग: जब कार्य केवल समीक्षा से आगे बढ़कर कस्टम CI (Continuous Integration) या जटिल कार्यों में चला जाता है।
• सेटअप:
• संगठन एडमिन Cloud Code सेटिंग्स से इसे चालू करता है।
• Cloud GitHub App इंस्टॉल किया जाता है और रिपॉजिटरी चुनी जाती हैं।
• ट्रिगर (Triggers):
• PR पर हर पुश (push) पर।
• जब कोई टिप्पणी (comment) करता है (जैसे @cloud का उपयोग करके)।
• शेड्यूल्ड जॉब्स (Cron) या कोई भी GitHub इवेंट।
• कॉन्फ़िगरेशन (Inputs):
• Anthropic API Key: आवश्यक।
• GitHub Token: डिफ़ॉल्ट रूप से secrets. githubtoken का उपयोग होता है।
• Trigger Phrase: वह वाक्यांश जिसे एक्शन कमेंट्स में सुनता है (डिफ़ॉल्ट: at cloud)।
• Prompt: रन के लिए निर्देश।
• Cloud Arguments: CLI आर्गुमेंट्स की एक स्ट्रिंग जहाँ फाइन-ट्यूनिंग होती है (जैसे max turns सेट करना, allow tools सेट करना)।
• कार्य: यह एजेंट को PR कमेंट्स, शेड्यूल किए गए जॉब्स, और किसी भी GitHub इवेंट पर चलाता है।

**III. सारांश (Summary)**

• केवल समीक्षा के लिए: प्रबंधित पथ (Managed Path) चुनें → CodeReview को सक्षम करें → इनलाइन निष्कर्ष प्राप्त करें और स्थानीय रूप से ठीक करें।
• जटिल कार्यों के लिए (समीक्षा से अधिक): DIY पथ चुनें → GitHub Action इंस्टॉल करें → वर्कफ़्लो (workflow) सेट करें (जैसे @cloud में ट्रिगर)।

Takeaways

• CodeReview (Managed Solution): यह एक प्रबंधित सेवा है जो PRs की समीक्षा करती है और इनलाइन निष्कर्ष देती है, लेकिन यह PR को अप्रूव या ब्लॉक नहीं करती।
• Cloud Code GitHub Action (DIY Solution): यह जटिल CI या कस्टम कार्यों के लिए उपयोग किया जाता है, जिसके लिए संगठन को इसे स्वयं कॉन्फ़िगर करना होता है।
• DIY सेटअप की आवश्यकता: GitHub Action को चलाने के लिए Anthropic API Key, GitHub Token और विशिष्ट ट्रिगर (जैसे @cloud) की आवश्यकता होती है।
• उपयोग का निर्णय: केवल सरल समीक्षा के लिए CodeReview (Managed Path) चुनें; जटिल वर्कफ़्लो के लिए GitHub Action (DIY Path) का उपयोग करें।