पूर्णतः प्रोग्रामेटिक Codeberg प्रबंधन

Codeberg Skill आपके AI एजेंट को Codeberg (Gitea-आधारित) रिपॉजिटरी के साथ एक मानव डेवलपर जितनी गहराई से इंटरैक्ट करने की क्षमता देता है। जबकि अधिकांश AI टूल्स केवल GitHub के लिए अनुकूलित हैं, यह स्किल Forgejo/Gitea इकोसिस्टम के लिए एक विशेष ब्रिज प्रदान करता है, जो Gitea REST API v1 के माध्यम से सीधे परिष्कृत Git ऑपरेशन सक्षम करता है।

उन्नत रिपॉजिटरी नियंत्रण

सरल टेक्स्ट जनरेशन से आगे बढ़कर, यह स्किल आपके एजेंट को सक्रिय रिपॉजिटरी प्रबंधन करने देता है। यह उन तकनीकी जटिलताओं को संभालता है जो अक्सर सीधे प्रॉम्प्टिंग से विफल हो जाती हैं, जैसे:

• स्वचालित SHA प्रबंधन: फ़ाइल अपडेट के लिए ऑब्जेक्ट SHA को स्वचालित रूप से फ़ेच और प्रबंधित करके मर्ज कॉन्फ्लिक्ट रोकता है।
• जटिल बैच कमिट्स: एकल परमाणु कमिट में कई फ़ाइलें पुश करने के लिए 5-चरणीय Git Trees API वर्कफ़्लो लागू करता है।
• रिलीज़ ऑर्केस्ट्रेशन: रिलीज़ बनाएं, टैग प्रबंधित करें और बाइनरी एसेट्स को प्रोग्रामेटिक रूप से अपलोड करें।
• स्मार्ट रिक्वेस्ट रूटिंग: अधिकतम सुरक्षा के लिए आपके API टोकन को आपकी लोकल मशीन पर रखने हेतु बिल्ट-इन प्रॉक्सी-फर्स्ट आर्किटेक्चर।

यह प्रॉम्प्टिंग से बेहतर क्यों है

सीधी API प्रॉम्प्टिंग अक्सर Base64 एन्कोडिंग, पाथ फ़ॉर्मेटिंग और स्टेट मैनेजमेंट में त्रुटियाँ उत्पन्न करती है। यह स्किल एजेंट को एक विश्वसनीय एक्ज़ीक्यूशन फ्रेमवर्क प्रदान करता है, जिससे फ़ाइल ट्रांसफर, ब्रांच प्रबंधन और रिपॉजिटरी सर्च Gitea के विशिष्ट मानकों के अनुसार किए जाते हैं। इसमें स्वचालित फ़ॉलबैक लॉजिक और लोकलाइज़्ड टोकन हैंडलिंग शामिल है जिसे मानक LLM संदर्भ दोहरा नहीं सकते।

एकल खाता या बहु-खाता

स्किल जानबूझकर एकल-खाता है ताकि जोखिम न्यूनतम रहे। यदि स्किल फ़ाइल कभी साझा या लीक हो जाए, तो केवल एक खाता जोखिम में होगा।

• एकल खाता: अपना API टोकन सीधे स्किल कॉन्फ़िग में भरें। कोई प्रॉक्सी आवश्यक नहीं, तुरंत काम करता है।
• बहु-खाता: Tunnel-Proxy में अतिरिक्त खाते कॉन्फ़िगर करें (https://codeberg.org/Vokuar/Tunnel-Proxy)। प्रत्येक खाते का टोकन आपकी मशीन पर रहता है और स्किल फ़ाइल को कभी नहीं छूता। प्रॉक्सी खातों के बीच रूटिंग स्वचालित रूप से संभालता है।

प्रॉक्सी सेटअप (अनुशंसित)

Tunnel-Proxy को लोकली चलाएं और इसे ngrok के ज़रिए टनल करें ताकि Claude इसे कहीं से भी एक्सेस कर सके। Windows, macOS, Linux और Termux के लिए ऑटोस्टार्ट सहित पूर्ण सेटअप निर्देश यहाँ उपलब्ध हैं:

https://codeberg.org/Vokuar/Tunnel-Proxy

प्रॉक्सी सीक्रेट proxy.py के शीर्ष के पास PROXY_SECRET के रूप में परिभाषित है। स्किल कॉन्फ़िग में PROXY_SECRET के अंतर्गत वही मान सेट करें।

यदि आप प्रॉक्सी नहीं चलाना चाहते, तो स्किल कॉन्फ़िग में सीधे TOKEN फ़ील्ड भरें और प्रॉक्सी फ़ील्ड को प्लेसहोल्डर के रूप में छोड़ दें। स्किल इसे स्वचालित रूप से पहचानकर प्रॉक्सी पिंग छोड़ देगा।

Claude सेटिंग्स में डोमेन अनुमति दें

Claude का सैंडबॉक्स डिफ़ॉल्ट रूप से आउटबाउंड रिक्वेस्ट ब्लॉक करता है। आपको उन सभी डोमेन को अनुमति सूची में जोड़ना होगा जिन तक Claude को पहुँचना है।

1. Claude > Settings > Capabilities खोलें
2. सुनिश्चित करें कि Cloud code execution and file creation सक्षम है
3. Domain allowlist के अंतर्गत codeberg.org जोड़ें
4. यदि प्रॉक्सी उपयोग कर रहे हैं, तो अपना ngrok डोमेन भी जोड़ें, जैसे your-domain.ngrok-free.dev
5. प्रत्येक के बाद Add क्लिक करें

अनुशंसित टोकन स्कोप

अपना Codeberg API टोकन जनरेट करते समय, इसे कोई वर्णनात्मक नाम दें जैसे Claude Local Proxy। repository और user आवश्यक हैं। बाकी आपकी ज़रूरत के अनुसार वैकल्पिक हैं।

• repository: पढ़ना और लिखना (फ़ाइलें, ब्रांच, कमिट्स, रिलीज़, टैग) — आवश्यक
• user: पढ़ना और लिखना (रिपो लिस्टिंग, पहचान, API के ज़रिए रिपो बनाना) — आवश्यक
• issue: पढ़ना और लिखना (इश्यू, टिप्पणियाँ, लेबल, माइलस्टोन) — वैकल्पिक
• notification: पढ़ना और लिखना (सूचनाएं और सब्सक्रिप्शन) — वैकल्पिक
• misc: पढ़ना (Gitea मेटाडेटा और साइनिंग कीज़) — वैकल्पिक
• activitypub: पढ़ना और लिखना — वैकल्पिक
• organization: कोई एक्सेस नहीं
• package: कोई एक्सेस नहीं

समर्थित टूल्स और फ्रेमवर्क

• प्लेटफ़ॉर्म: Codeberg.org और कोई भी स्व-होस्टेड Gitea/Forgejo इंस्टेंस
• API: Gitea REST API v1
• Auth: डायरेक्ट Personal Access Token (एकल खाता) या प्रति-खाता टोकन रूटिंग के साथ Proxy Secret (Tunnel-Proxy के ज़रिए बहु-खाता)
• डेटा: Base64 कंटेंट हैंडलिंग के साथ पूर्ण JSON समर्थन