इस प्रोजेक्ट के बारे में

GitHub Agentic Workflows (`gh-aw`) एक GitHub CLI एक्सटेंशन है जो डेवलपर्स को YAML frontmatter वाली Markdown फ़ाइलों का उपयोग करके AI-संचालित रिपॉज़िटरी ऑटोमेशन परिभाषित करने में सक्षम बनाता है। यह एक्सटेंशन प्रत्येक agentic workflow को एक मानक GitHub Actions workflow में कंपाइल करता है, जिससे AI एजेंट्स GitHub Actions के भीतर सुरक्षित रूप से चल सकते हैं। Agentic workflows उन कार्यों के लिए डिज़ाइन किए गए हैं जिनमें तर्क या व्याख्या की आवश्यकता होती है, जैसे issue triage, pull-request review, CI failure investigation, documentation maintenance, dependency analysis, और repository reporting। ये नियतात्मक builds, tests, linting, deployments, और प्रतिलिपि-योग्य scripts के लिए उपयोग किए जाने वाले पारंपरिक GitHub Actions के पूरक हैं, न कि उनका प्रतिस्थापन। अंतर्निहित AI इंजनों में GitHub Copilot, Claude Code, OpenAI Codex, Google Gemini, और Pi शामिल हैं। Agent jobs डिफ़ॉल्ट रूप से read-only और sandboxed होते हैं, और कॉन्फ़िगर किए गए GitHub writes सामान्यतः scoped permissions वाले सत्यापित `safe-outputs` jobs के माध्यम से लागू किए जाते हैं। सुरक्षा, permissions, और नियंत्रित writes मुख्य डिज़ाइन चिंताएँ हैं। समर्थित agent-job पथ डिफ़ॉल्ट रूप से read-only GitHub पहुँच और sandboxed execution का उपयोग करता है। Safe outputs कॉन्फ़िगर किए गए writes को बफ़र करते हैं, उन्हें सत्यापित करते हैं, और scoped permissions वाले अलग jobs में लागू करते हैं। ये नियंत्रण कॉन्फ़िगर करने योग्य हैं, इसलिए workflow लेखकों को deployment से पहले permissions, tools, network access, और generated files की समीक्षा करनी चाहिए। त्वरित शुरुआत: `gh extension install github/gh-aw` के साथ एक्सटेंशन इंस्टॉल करें, फिर AI इंजन चुनने, एक नमूना workflow जोड़ने, और इसे GitHub Actions के माध्यम से चलाने के लिए quickstart गाइड का पालन करें। दस्तावेज़ीकरण में workflows बनाना, AI इंजनों का चयन और प्रमाणीकरण, कार्य के अनुसार उदाहरण, सुरक्षा आर्किटेक्चर, और FAQ शामिल हैं। AI एजेंट्स और retrieval tools प्रकाशित agent prompt index, पूर्ण prompt corpus, और AI-readable project summary का उपयोग कर सकते हैं। नोट: संस्करण `>= 0.83.3, < 0.85.4` में एक सुरक्षा भेद्यता पाई गई थी; एहतियाती उपाय के रूप में उन रिलीज़ों को सेवानिवृत्त कर दिया गया था।