GitHub Copilot
GitHub Copilot (GA) के लिए Apothem हार्नेस अडैप्टर।
विक्रेता: GitHub / Microsoft
इंस्टॉल नाम: github-copilot
स्थिति: GA
नेटिव कॉन्फ़िग: <project>/.github/copilot-instructions.md
इंस्टॉलेशन
apothem install --harness github-copilot --project /path/to/projectअडैप्टर प्रोजेक्ट निर्देश फ़ाइल को आपकी साझा प्रोफ़ाइल और साझा Apothem नियमों तथा शासन सतह से व्युत्पन्न करता है, प्रोजेक्ट में Apothem के सहायकों को Copilot सहायक प्रोफ़ाइल के रूप में लिखता है (सहायक प्रोफ़ाइल देखें), और दो हुक पंजीकृत करता है (हुक देखें)।
यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।
लिखी गई फ़ाइलें:
<project>/.github/copilot-instructions.md, निर्देश फ़ाइल।- प्रोजेक्ट में, हर Apothem सहायक के लिए
<project>/.github/agents/<name>.agent.md। - प्रोजेक्ट में,
<project>/.github/hooks/apothem.json, हुक फ़ाइल। उस फ़ोल्डर में आपकी अपनी हुक फ़ाइलों को नहीं छुआ जाता। - प्रोजेक्ट में,
<project>/.apothem/support/github-copilot/hooks/, हुक स्क्रिप्ट। - आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए
~/.agents/skills/<name>/SKILL.md। - आपकी होम डायरेक्टरी में,
~/.config/apothem/rules/और~/.config/apothem/templates/।
प्रोजेक्ट के बाहर की फ़ाइलें
इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:
| फ़ोल्डर | Apothem वहाँ क्या लिखता है |
|---|---|
~/.agents/skills/ | हर Apothem स्किल के लिए एक SKILL.md वाला एक फ़ोल्डर, और हर Apothem कमांड के लिए एक (कमांड उसी नाम की स्किल बन जाता है)। |
~/.config/apothem/rules/, ~/.config/apothem/templates/ | वे नियम और टेम्पलेट जिनका स्किल और निर्देश फ़ाइल उल्लेख करती हैं। |
ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:
- हर वह प्रोजेक्ट जिसमें आप
github-copilotइंस्टॉल करते हैं, और फ़ोल्डर का नाम लेने वाला हर अन्य Apothem इंस्टॉल, एक ही प्रति का उपयोग करता है और वही फ़ाइलें लिखता है, इसलिए आप किस क्रम में इंस्टॉल करते हैं इससे फ़र्क नहीं पड़ता। कई अन्य टूल भी~/.agents/skills/पढ़ते हैं; हार्नेस रजिस्ट्री उन्हें सूचीबद्ध करती है। --projectयह चुनता है कि कौन-सी निर्देश फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।- इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को
निर्देश फ़ाइल,
.github/agents/में सहायक प्रोफ़ाइल फ़ाइलें, हुक फ़ाइल.github/hooks/apothem.jsonमिलती हैं, साथ ही वह.apothem/फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है, जिसमें हुक स्क्रिप्ट भी रहती हैं। - होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
- Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे
छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है।
उसका नाम बदलें या उसे स्थानांतरित करें, फिर
apothem updateचलाएँ। जब तक वह नाम घिरा रहता है,apothem verifyविफल रहता है। - फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।
इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project
के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।
सहायक प्रोफ़ाइल
Copilot इन प्रोफ़ाइलों के लिए GitHub के संदर्भ
के अनुसार <project>/.github/agents/<name>.agent.md से एक सहायक प्रोफ़ाइल पढ़ता
है। इंस्टॉल उस फ़ोल्डर में हर Apothem सहायक के लिए एक फ़ाइल लिखता है। यह केवल
प्रोजेक्ट के लिए इंस्टॉल करता है और कोई ~/.copilot/agents/ फ़ोल्डर नहीं लिखता।
हर फ़ाइल सहायक के निर्देशों को अपरिवर्तित रखती है और ये फ़्रंट मैटर कुंजियाँ रखती है:
| कुंजी | Apothem क्या लिखता है |
|---|---|
name, description | सहायक का नाम और विवरण। Copilot को विवरण आवश्यक है। |
tools | वे टूल जिनका सहायक उपयोग कर सकता है, Copilot टूल उपनामों की सूची के रूप में, उदाहरण के लिए ["read", "search", "execute"]। |
Copilot की tools कुंजी उपनामों की एक अनुमति-सूची है, और इसमें ऐसी कोई कुंजी
नहीं है जो किसी टूल को वर्जित करे। इसलिए सहायक के अनुमत टूल और उसके वर्जित टूल
मिलाकर एक ही सूची बनाई जाती है:
| Copilot उपनाम | किसे कवर करता है | ऐसे सहायक के लिए लिखा जाता है जिसे अनुमति है |
|---|---|---|
read | Read, NotebookRead | Read |
search | Grep, Glob | Grep या Glob |
edit | Edit, MultiEdit, Write, NotebookEdit | Write, Edit या MultiEdit |
execute | Bash, PowerShell | Bash या PowerShell |
web | WebSearch, WebFetch | WebSearch या WebFetch |
todo | TodoWrite | TodoWrite |
Copilot में एक और उपनाम है, वह जो किसी सहायक को अन्य सहायक शुरू करने देता है; किसी
भी Apothem सहायक को ऐसा करने की अनुमति नहीं है, इसलिए वह कभी नहीं लिखा जाता। कोई
उपनाम तब छोड़ दिया जाता है जब सहायक उसके द्वारा कवर किए गए किसी भी टूल को वर्जित
करता है, क्योंकि वह उपनाम सहायक को उस टूल का उपयोग करने देगा। बिना उपनाम वाला टूल
(उदाहरण के लिए Monitor) छोड़ दिया जाता है। पैटर्न वाले टूल, जैसे
Bash(git status), का कोई उपनाम रूप नहीं है: अनुमत टूल के रूप में वह छोड़ दिया
जाता है, और वर्जित टूल के रूप में वह पूरे टूल को वर्जित करता है। जो सहायक फ़ाइलें
संपादित नहीं कर सकता, वह यह सीमा बनाए रखता है: उसे कभी edit नहीं मिलता।
यदि किसी सहायक की सूची का हर टूल छूट जाता है, तो फ़ाइल में tools: [] लिखा होता
है, जो सहायक को कोई टूल नहीं देता, बजाय कुंजी छोड़ने के, जो उसे हर टूल दे देता।
इंस्टॉल कोई model कुंजी नहीं लिखता, इसलिए सहायक डिफ़ॉल्ट मॉडल का उपयोग करता है,
और Copilot द्वारा प्रलेखित अन्य कुंजियों (target, disable-model-invocation,
user-invocable, mcp-servers, metadata) में से कोई भी, कोई टर्न सीमा, या
Apothem की version, updated और portability कुंजियाँ नहीं लिखता।
जानने योग्य बातें:
.github/agents/आपकी रिपॉज़िटरी का हिस्सा है। साथी और Copilot की क्लाउड कोडिंग सेवा वही फ़ाइलें पढ़ते हैं, इसलिए उन्हें प्रोजेक्ट के साथ कमिट करें या.gitignoreमें.github/agents/सूचीबद्ध करें; Apothem आपके लिए यह नहीं चुनता।- क्लाउड कोडिंग सेवा
webऔरtodoउपनामों का पालन नहीं करती।webउपनाम वेब खोज और पृष्ठ फ़ेच दोनों को कवर करता है, इसलिएcitation-auditor,fact-checkerऔरresearch-scoutवहाँ फ़ाइलें पढ़ और खोज सकते हैं, लेकिन न तो वेब खोज सकते हैं और न ही पृष्ठ फ़ेच कर सकते हैं। - Copilot CLI रिपॉज़िटरी का
.claude/agents/भी पढ़ता है, लेकिन~/.claude/agents/नहीं, इसलिए Claude Code इंस्टॉल Copilot तक नहीं पहुँचता। - Apothem सहायक की तरह नामित आपकी कोई फ़ाइल (
<name>.agent.md)~/.apothem/backups/के अंतर्गत सहेजी जाती है और फिर बदल दी जाती है। अनइंस्टॉल उसे वापस नहीं रखता। अन्य नामों वाली फ़ाइलों को कभी नहीं छुआ जाता। Copilot के दस्तावेज़ यह नहीं बताते कि जब फ़ोल्डर में<name>.mdऔर<name>.agent.mdदोनों हों तो क्या होता है। - Apothem ने पुष्टि नहीं की है कि एक नाम के लिए Copilot
.github/agents/या.claude/agents/में से किसे प्राथमिकता देता है, या क्लाउड कोडिंग सेवा और VS Code किसी ऐसी फ़्रंट मैटर कुंजी के साथ कैसा व्यवहार करते हैं जिसे वे सूचीबद्ध नहीं करते।
हुक
Copilot Copilot हुक संदर्भ
के अनुसार <project>/.github/hooks/ में JSON फ़ाइलों से हुक चलाता है। इंस्टॉल वहाँ
एक फ़ाइल, apothem.json (संस्करण 1), दो हुक के साथ लिखता है:
| इवेंट | क्या चलता है |
|---|---|
sessionStart | सत्र बूटस्ट्रैप: सत्र मेटाडेटा, स्किल इंडेक्स, मेमोरी और प्लान सारांश और स्थायी मुद्रा, मॉडल के संदर्भ में जोड़े जाते हैं। |
postToolUse (हर टूल) | सक्रिय-कॉम्पैक्शन ट्रैकर। यह गतिविधि गिनता है और, हर कॉम्पैक्शन चक्र में अधिकतम दो बार, मॉडल से अपनी स्थिति सहेजने या कॉम्पैक्ट करने को कहता है। अन्यथा यह मौन रहता है। |
दोनों मॉडल के लिए संदर्भ जोड़ते हैं। कोई भी किसी टूल कॉल या सत्र को अवरुद्ध नहीं करता।
Apothem Copilot पर कोई preToolUse गार्ड पंजीकृत नहीं करता। preToolUse के लिए
Copilot केवल अनुमति फ़ील्ड और एक पुनर्लिखित टूल इनपुट पढ़ता है, कभी
additionalContext (वह फ़ील्ड जिसके माध्यम से Apothem के गार्ड बोलते हैं) नहीं।
वहाँ पंजीकृत गार्ड हर टूल कॉल पर एक प्रोसेस आरंभ की लागत लेगा और कुछ भी नहीं
पहुँचाएगा, इसलिए write, edit और shell गार्ड, AskUserQuestion जाँच और
सत्र-समाप्ति प्रोटोकॉल उन टूल्स पर रहते हैं जो उन्हें पहुँचाते हैं। हुक Copilot के
camelCase इवेंट नामों का उपयोग करते हैं, क्योंकि संदर्भ उन्हीं के लिए आउटपुट फ़ील्ड
सूचीबद्ध करता है; Copilot किसी PascalCase इवेंट से additionalContext पढ़ता है या
नहीं, यह प्रलेखित नहीं है।
फ़ाइलें कहाँ जाती हैं
| फ़ाइल | उसमें क्या है |
|---|---|
<project>/.github/hooks/apothem.json | दो हुक पंजीकरण। Apothem इस एक फ़ाइल का स्वामी है। |
<project>/.apothem/support/github-copilot/hooks/ | डिस्पैचर स्क्रिप्ट, उसके हेल्पर और उसकी संदेश फ़ाइलें। |
हर हुक में एक bash कमांड और एक powershell कमांड है। वे एक ही डिस्पैचर चलाते
हैं; powershell वाले के आगे एक कॉल ऑपरेटर (&) है, जिसकी PowerShell को किसी
उद्धृत प्रोग्राम पथ से पहले आवश्यकता होती है। एक bash कमांड ऐसा दिखता है, दोनों
पथों की जगह आपके इंटरप्रेटर और प्रोजेक्ट पथ के साथ:
"/path/to/python" "/path/to/project/.apothem/support/github-copilot/hooks/dispatch.py" --contract copilot sessionStart--contract copilot डिस्पैचर से Copilot का camelCase इनपुट पढ़वाता है और
{"additionalContext": ...} प्रिंट करवाता है, जिसे Copilot इन दो इवेंट के लिए पढ़ता
है।
सावधानी से कमिट करें, और क्लाउड एजेंट। .github/hooks/ आपकी रिपॉज़िटरी का
हिस्सा है, और Copilot की क्लाउड कोडिंग सेवा उसे पढ़ती है। कमांड उस इंटरप्रेटर का
नाम बताते हैं जो Apothem को चलते समय मिला, और प्रोजेक्ट का पूर्ण पथ, और स्क्रिप्ट
.apothem/ में हैं, जिसे प्रोजेक्ट का .gitignore स्निपेट अनदेखा करता है। किसी भी
अन्य मशीन पर, और क्लाउड सेवा में (जो केवल bash कमांड चलाती है), कमांड को चलाने
के लिए कुछ नहीं मिलता। Copilot विफलता को लॉग करता है और रन जारी रहता है, क्योंकि
विफल sessionStart या postToolUse हुक अवरुद्ध नहीं करता।
.github/hooks/apothem.json को .gitignore में जोड़ें, या उसे केवल ऐसी टीम के लिए
कमिट करें जो एक ही लेआउट साझा करती है। इंस्टॉल .gitignore संपादित नहीं करता और
इसे एक नोट के रूप में प्रिंट करता है।
आपके अपने हुक। .github/hooks/ में आपकी हुक फ़ाइलें कभी पढ़ी या बदली नहीं
जातीं। apothem.json में ही आपके द्वारा जोड़ा गया हुक बना रहता है: अपडेट और
अनइंस्टॉल केवल उन प्रविष्टियों को बदलते या हटाते हैं जिनका कमांड Apothem डिस्पैचर
चलाता है (--contract copilot के साथ
.apothem/support/github-copilot/hooks/dispatch.py, चाहे वह किसी भी प्रोजेक्ट पथ के
अंतर्गत लिखा गया हो)। आपका कोई हुक जो केवल नाम साझा करता है, या जो
python -m apothem.conformity.gate चलाता है, उसे कभी Apothem का नहीं समझा जाता।
जो फ़ाइल वैध JSON नहीं है, वह ~/.apothem/backups/ के अंतर्गत सहेजी जाती है और
बदल दी जाती है।
पथ जिन्हें शेल गलत पढ़ेगा। $, बैकटिक, दोहरा उद्धरण चिह्न या बैकस्लैश वाला
कोई प्रोजेक्ट या इंटरप्रेटर पथ कुछ भी लिखे जाने से पहले अस्वीकार कर दिया जाता है:
उद्धृत कमांड के भीतर वह कोई अलग फ़ाइल चलाएगा, या उस JSON को तोड़ देगा जिसमें
कमांड लिखा जाता है। त्रुटि पथ का नाम बताती है; प्रोजेक्ट को स्थानांतरित करें या
उसका नाम बदलें और इंस्टॉल फिर से चलाएँ। पथ में स्पेस या अपॉस्ट्रॉफ़ी ठीक है।
हुक बंद करना। Apothem हुक को मौन करने के लिए जिस परिवेश में Copilot चलता है
उसमें APOTHEM_HOOKS_DISABLE=1 सेट करें, या apothem.json में
"disableAllHooks": true सेट करें, जो उस एक फ़ाइल को छोड़ देता है।
VS Code का पुराना Local हुक अनुबंध (command, windows, linux और osx
फ़ील्ड वाले इवेंट) एक अलग प्रारूप है जिसे संस्करण 1 फ़ाइल लक्षित नहीं करती।
प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंग
अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और प्रत्येक apothem install या
apothem update रन पर रिपॉज़िटरी-व्यापी Copilot निर्देश फ़ाइल रेंडर करता है।
सत्य का स्रोत साझा प्रोफ़ाइल है; अगला सिंक Apothem-प्रबंधित सामग्री को बदले, उससे
पहले उत्पन्न फ़ाइल में किए गए प्रोजेक्ट-स्थानीय संपादनों का बैकअप लिया जाता है।
Apothem ब्लॉक के भीतर, आपकी प्रोफ़ाइल से रेंडर किया गया अनुभाग (ऑपरेटर, प्राथमिकताएँ, कस्टम नियम, ऑप्ट-इन किए गए व्यवहार, MCP सर्वर नाम) सबसे पहले, साझा शासन पाठ से आगे आता है। GitHub बताता है कि छोटी निर्देश फ़ाइलों के कोड समीक्षा द्वारा पूरी तरह संसाधित किए जाने की संभावना अधिक होती है (कोड समीक्षा को अनुकूलित करना), इसलिए जो भाग आपके लिए विशिष्ट है, वह फ़ाइल में सबसे आगे रहता है।
संगतता टिप्पणियाँ
GitHub Copilot कोई फ़ाइल-आधारित उपयोगकर्ता-वैश्विक निर्देश पथ उजागर नहीं करता
जिसे यह अडैप्टर प्रबंधित कर सके। Apothem प्रलेखित प्रोजेक्ट-स्कोप निर्देश फ़ाइल
को लक्षित करता है और IDE-स्तरीय उपयोगकर्ता सेटिंग्स को ऑपरेटर-स्वामित्व में छोड़
देता है। यह एक हुक फ़ाइल, .github/hooks/apothem.json, लिखता है, और
.github/hooks/ में कोई अन्य फ़ाइल नहीं लिखता।
Apothem रिपॉज़िटरी के भीतर, .github/copilot-instructions.md उस रिपॉज़िटरी की
सहायक निर्देश सतहों में से एक स्वर है। उस रिपॉज़िटरी के किसी चेकआउट में, अनुरूपता
गेट की बहु-सतह सुसंगतता जाँच AGENTS.md, CLAUDE.md, और
.github/copilot-instructions.md में साझा दावों की तुलना करती है। यह ऐसे साझा दावे
की रिपोर्ट करती है जिसे इन तीनों फ़ाइलों में से कोई एक छोड़ देती है, और ऐसी फ़ाइल की
भी जो AGENTS.md के किसी दावे का खंडन करती है। यह जाँच उस निर्देश फ़ाइल को नहीं
पढ़ती जिसे Apothem आपके प्रोजेक्ट में लिखता है। गेट डिफ़ॉल्ट रूप से सलाहकारी है: वह
निष्कर्ष रिपोर्ट करता है और 0 के साथ बाहर निकलता है।
GitHub Copilot अपने व्यक्तिगत स्किल स्थानों में ~/.agents/skills/ को सूचीबद्ध
करता है, इसलिए इंस्टॉल द्वारा लिखी गई स्किल आपकी मशीन पर Copilot के लोड करने के
लिए उपलब्ध हैं। GitHub पर चलने वाली सतहें, क्लाउड कोडिंग सेवा और कोड समीक्षा, कहीं
और चलती हैं और आपकी होम डायरेक्टरी नहीं देखतीं, इसीलिए निर्देश फ़ाइल अनुशासनों को
स्वयं रखती है। Apothem ने पुष्टि नहीं की है कि Copilot किसी ऐसी SKILL.md हेडर
कुंजी के साथ कैसा व्यवहार करता है जिसे वह सूचीबद्ध नहीं करता; स्किल
user-invocable, disable-model-invocation, allowed-tools, argument-hint, और
एक metadata मैप रखती हैं।
सत्यापन
apothem verify --harness github-copilot --project /path/to/projectverify कमांड पुष्टि करता है कि:
- नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
- हर प्रबंधित टारगेट मौजूद है,
.github/agents/फ़ोल्डर सहित; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं।--profile PATHजोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।.github/agents/के लिए जाँच यह है कि फ़ोल्डर मौजूद है, यह नहीं कि हर सहायक फ़ाइल उसमें है;apothem diff --harness github-copilot --project /path/to/projectउन सहायक फ़ाइलों को सूचीबद्ध करता है जो अनुपस्थित या पुरानी हैं। हुक फ़ाइल.github/hooks/apothem.jsonमौजूद होनी चाहिए, खाली नहीं होनी चाहिए, JSON के रूप में पार्स होनी चाहिए और उसमें एक ऐसी प्रविष्टि होनी चाहिए जो Apothem डिस्पैचर चलाती है, और हुक स्क्रिप्ट.apothem/support/github-copilot/hooks/में होनी चाहिए। जाँच हुक को चलाती नहीं। - हर Apothem स्किल फ़ोल्डर एक
SKILL.mdके साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है। - अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।
अपडेट करना
apothem update --harness github-copilot --project /path/to/projectवर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट निर्देश फ़ाइल को पुनः व्युत्पन्न करता है।
अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं।
यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है।
यह उन सहायक प्रोफ़ाइल फ़ाइलों को फिर से लिखता है जो वर्तमान फ़ाइलों से भिन्न हैं, और जो अनुपस्थित हैं उन्हें जोड़ता है।
यह हुक स्क्रिप्ट और .github/hooks/apothem.json में Apothem हुक को भी ताज़ा करता है,
उस फ़ाइल में आपके किसी भी हुक को बनाए रखते हुए।
अनइंस्टॉल करना
apothem uninstall --harness github-copilot --project /path/to/project<project>/.github/copilot-instructions.md से Apothem ब्लॉक को हटाता है और उसके
बाहर के किसी भी पाठ को रहने देता है। फ़ाइल केवल तभी हटाई जाती है जब उसमें और कुछ
शेष न रहे। बदलाव से पहले, फ़ाइल की एक टाइमस्टैम्प-युक्त प्रति ~/.apothem/backups/
के अंतर्गत सहेजी जाती है। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित रहते हैं।
अनइंस्टॉल <project>/.github/agents/ में अपने द्वारा लिखी गई सहायक प्रोफ़ाइल फ़ाइलें
भी हटाता है और वहाँ की किसी भी अन्य फ़ाइल को रखता है; खाली रह जाने पर फ़ोल्डर हटा
दिया जाता है। यह <project>/.github/hooks/apothem.json से Apothem हुक हटाता है,
उन्हें उनके कमांड में डिस्पैचर पथ से पहचानते हुए, इसलिए यह बिना इंस्टॉल रिकॉर्ड के
भी काम करता है, और उस फ़ाइल में आपके किसी भी हुक को रखता है। फ़ाइल तब हटाई जाती
है जब उसमें और कुछ न रहे, और आपकी अन्य हुक फ़ाइलों को नहीं छुआ जाता। यदि फ़ाइल
में ऐसी टिप्पणियाँ हैं जिन्हें अनइंस्टॉल पढ़ नहीं सकता, तो वह फ़ाइल को जैसी है वैसी
छोड़ देता है और हुक को कारण सहित छोड़ा गया रिपोर्ट करता है; Apothem प्रविष्टियाँ
हाथ से हटाएँ। <project>/.apothem/support/github-copilot/hooks/ में हुक स्क्रिप्ट
भी हटा दी जाती हैं।
यह ~/.agents/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और
~/.config/apothem/ में नियम और टेम्पलेट हटाता है, लेकिन केवल तभी जब कोई अन्य
Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा
करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है,
प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता
है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया
फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/
के अंतर्गत उसका बैकअप लिया जाता है।
अनुरूपता गेट
python -m apothem.conformity.gate --all .--all रन स्टैंडअलोन वैलिडेटर को कवर करता है। वह बहु-सतह संगति जाँच नहीं चलाता, जिसका वर्णन संगतता टिप्पणियाँ के अंतर्गत है। किसी चेकआउट में उस जाँच को नाम से चलाने के लिए:
python -m apothem.conformity.gate --check multi-surface-coherence-grep AGENTS.mdसमस्या निवारण
| लक्षण | समाधान |
|---|---|
| कॉन्फ़िग फ़ाइल नहीं मिली | apothem install --harness github-copilot --project /path/to/project फिर से चलाएँ |
| सत्यापन विफल रहा | apothem update --harness github-copilot --project /path/to/project चलाएँ, फिर दोबारा सत्यापित करें |
| Copilot कोई भी Apothem सहायक सूचीबद्ध नहीं करता | जाँचें कि .github/agents/ में .agent.md फ़ाइलें हैं और वे उस ब्रांच पर हैं जिसका आप उपयोग कर रहे हैं। apothem diff --harness github-copilot --project /path/to/project चलाएँ: .github/agents फ़ोल्डर के लिए कोई लंबित पंक्ति का अर्थ है कि सहायक फ़ाइलें अनुपस्थित या पुरानी हैं, इसलिए apothem update --harness github-copilot --project /path/to/project चलाएँ। apothem verify इसकी जाँच नहीं है: यह तब पास होता है जब .github/agents/ मौजूद हो, भले ही उसमें कोई सहायक फ़ाइल न हो |
| Apothem हुक नहीं चलते | जाँचें कि .github/hooks/apothem.json उस ब्रांच पर है जिसका आप उपयोग कर रहे हैं और इस मशीन पर .apothem/support/github-copilot/hooks/ मौजूद है; कमांड उस मशीन के इंटरप्रेटर और प्रोजेक्ट पथ का नाम बताते हैं जिसने इंस्टॉल चलाया, इसलिए हर मशीन पर apothem install --harness github-copilot --project /path/to/project चलाएँ। Copilot की क्लाउड कोडिंग सेवा केवल bash कमांड चलाती है, उस पथ पर किसी इंटरप्रेटर के बिना |
apothem verify किसी अनुपस्थित स्किल फ़ोल्डर का नाम बताता है | apothem install --harness github-copilot --project /path/to/project चलाएँ; यह फ़ोल्डर को पुनर्स्थापित करता है |
| कोई इंस्टॉल या अपडेट चेतावनी देता है कि उसने एक स्किल फ़ोल्डर छोड़ दिया | Apothem स्किल के नाम वाला एक फ़ोल्डर स्किल फ़ोल्डर में पहले से मौजूद है और उसे Apothem ने नहीं लिखा। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ |
| कोई इंस्टॉल प्रोजेक्ट बदलने से पहले रुक जाता है | आपकी होम डायरेक्टरी में कोई लेखन विफल रहा। त्रुटि पढ़ें, उसमें नामित फ़ोल्डर ठीक करें (ऐसा लिंक जो आपकी होम डायरेक्टरी से बाहर जाता है, फ़ोल्डर की जगह कोई फ़ाइल, या केवल-पठन फ़ोल्डर), और फिर से इंस्टॉल करें |
| अप्रत्याशित कॉन्फ़िग सामग्री | ~/.config/apothem/profile.yaml या --profile PATH जाँचें, फिर apothem update --harness github-copilot --project /path/to/project फिर से चलाएँ |
कॉन्फ़िगरेशन नॉब
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--dry-run | false | फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें। |
यह भी देखें
- सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
- इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
apothem harnessesसंदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें