Kiro
Kiro (GA) के लिए Apothem हार्नेस अडैप्टर।
विक्रेता: AWS
इंस्टॉल नाम: kiro
स्थिति: GA
नेटिव कॉन्फ़िग: <project>/.kiro/steering/apothem-rules.md
इंस्टॉलेशन
apothem install --harness kiro --project /path/to/projectअडैप्टर साझा Apothem नियमों और शासन सतह से प्रोजेक्ट-स्कोप वाली एक Kiro स्टीयरिंग फ़ाइल लिखता है, प्रोजेक्ट में Apothem के सहायकों को Kiro कस्टम एजेंट फ़ाइलों के रूप में लिखता है (कस्टम एजेंट फ़ाइलें देखें), और एक हुक लिखता है (हुक देखें)।
यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।
लिखी गई फ़ाइलें:
<project>/.kiro/steering/apothem-rules.md, स्टीयरिंग फ़ाइल।- प्रोजेक्ट में, हर Apothem सहायक के लिए
<project>/.kiro/agents/<name>.md। - प्रोजेक्ट में,
<project>/.kiro/hooks/apothem.json, हुक फ़ाइल। उस फ़ोल्डर में आपकी अपनी हुक फ़ाइलों को नहीं छुआ जाता। - प्रोजेक्ट में,
<project>/.apothem/support/kiro/hooks/, हुक स्क्रिप्ट। - आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए
~/.kiro/skills/<name>/SKILL.md। - आपकी होम डायरेक्टरी में,
~/.config/apothem/rules/और~/.config/apothem/templates/।
प्रोजेक्ट के बाहर की फ़ाइलें
इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:
| फ़ोल्डर | Apothem वहाँ क्या लिखता है |
|---|---|
~/.kiro/skills/ | हर Apothem स्किल के लिए एक SKILL.md वाला एक फ़ोल्डर, और हर Apothem कमांड के लिए एक (कमांड उसी नाम की स्किल बन जाता है)। |
~/.config/apothem/rules/, ~/.config/apothem/templates/ | वे नियम और टेम्पलेट जिनका स्किल और स्टीयरिंग फ़ाइल उल्लेख करती हैं। |
ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:
- हर वह प्रोजेक्ट जिसमें आप
kiroइंस्टॉल करते हैं,~/.kiro/skills/की एक ही प्रति का उपयोग करता है, और इंस्टॉल हर बार उसमें वही फ़ाइलें लिखता है। Kiro एकमात्र टूल है जो उस फ़ोल्डर को पढ़ता है।~/.config/apothem/के अंतर्गत नियम और टेम्पलेट अन्य टूल्स के इंस्टॉल भी, उन्हीं फ़ाइलों के साथ, लिखते हैं। --projectयह चुनता है कि कौन-सी स्टीयरिंग फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।- इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को
स्टीयरिंग फ़ाइल,
.kiro/agents/में कस्टम एजेंट फ़ाइलें, हुक फ़ाइल.kiro/hooks/apothem.jsonमिलती हैं, साथ ही वह.apothem/फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है, जिसमें हुक स्क्रिप्ट भी रहती हैं। - होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
- Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे
छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है।
उसका नाम बदलें या उसे स्थानांतरित करें, फिर
apothem updateचलाएँ। जब तक वह नाम घिरा रहता है,apothem verifyविफल रहता है। - फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।
इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project
के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।
कस्टम एजेंट फ़ाइलें
Kiro Kiro कस्टम एजेंट दस्तावेज़ के अनुसार
<project>/.kiro/agents/ में एक Markdown फ़ाइल से कस्टम एजेंट पढ़ता है। इंस्टॉल
उस फ़ोल्डर में हर Apothem सहायक के लिए एक फ़ाइल लिखता है, सभी चौदह। यह Kiro IDE
1.0 और Kiro CLI V3 (kiro-cli --v3) को लक्षित करता है, वे संस्करण जो Markdown
प्रारूप पढ़ते हैं। यह कोई JSON प्रोफ़ाइल नहीं लिखता और पुराने CLI 2.x की कोई कुंजी
नहीं लिखता, क्योंकि V3 ऐसी JSON प्रोफ़ाइल को छोड़ देता है जिसमें allowedTools हो
और कोई permissions ब्लॉक न हो। यह केवल प्रोजेक्ट के लिए इंस्टॉल करता है:
उपयोगकर्ता फ़ोल्डर ~/.kiro/agents/ नहीं लिखा जाता।
हर फ़ाइल सहायक के निर्देशों को अपरिवर्तित रखती है और ये फ़्रंट मैटर कुंजियाँ रखती है:
| कुंजी | Apothem क्या लिखता है |
|---|---|
name, description | सहायक का नाम और विवरण। Kiro का मुख्य एजेंट किसी सहायक को उसके विवरण से चुनता है। |
tools | वे टूल जिनका सहायक उपयोग कर सकता है, Kiro टूल श्रेणियों की सूची के रूप में: ["read", "shell"]। जब सहायक कुछ भी प्रतिबंधित नहीं करता, तब छोड़ दी जाती है। |
Kiro में टूल के लिए एक ही सूची है, इसलिए सहायक के अनुमत और वर्जित टूल वही सूची
बन जाते हैं। श्रेणियाँ read, write, shell, web और subagent हैं:
| सहायक का टूल | Kiro श्रेणी |
|---|---|
Read, Glob, Grep | read |
Write, Edit, MultiEdit, NotebookEdit | write |
Bash, PowerShell | shell |
WebSearch, WebFetch | web |
Agent, Task | subagent |
बिना श्रेणी वाला टूल (TodoWrite, Monitor, Artifact, TaskCreate,
TaskUpdate, कोई MCP प्रविष्टि) छोड़ दिया जाता है। कोई श्रेणी तब छोड़ दी जाती है
जब सहायक को उसमें का कोई भी टूल वर्जित हो, इसलिए सहायक को कभी ऐसा टूल नहीं मिलता
जो उसे वर्जित था: जो सहायक फ़ाइलें संपादित नहीं कर सकता, उसे कोई write श्रेणी नहीं
मिलती। जिस सहायक के सभी अनुमत टूल छूट जाते हैं, वह tools: [] के साथ लिखा जाता
है, ताकि उसे हर टूल न मिले। दो सहायक (mcp-builder और refactor-surgeon)
write रखते हैं, नौ shell रखते हैं, और तीन web रखते हैं। इंस्टॉल कोई model
कुंजी नहीं लिखता, इसलिए सहायक उस मॉडल पर चलता है जिसे Kiro चुनता है, और
permissions, excludedTools, resources, mcpServers या hooks में से कोई
भी नहीं लिखता।
जानने योग्य बातें:
- जब तक आप वर्कस्पेस को विश्वसनीय (trust) नहीं करते, Kiro वर्कस्पेस की कस्टम एजेंट फ़ाइलें लोड नहीं करता। Kiro CLI 2.33 और बाद के संस्करण किसी फ़ोल्डर में पहली बार इंटरैक्टिव V3 सत्र शुरू करने पर "Trust this workspace?" पूछते हैं। यदि Kiro कोई भी सहायक सूचीबद्ध नहीं करता, तो फ़ोल्डर को विश्वसनीय करें और एक नया सत्र शुरू करें।
- Apothem ने पुष्टि नहीं की है कि Kiro CLI 2.x कोई V3 Markdown एजेंट लोड करता है या
नहीं। IDE का उपयोग करें, या
kiro-cli --v3चलाएँ। - एजेंट फ़ाइलें सामान्य प्रोजेक्ट फ़ाइलें हैं। उन्हें प्रोजेक्ट के साथ कमिट करें या
.gitignoreमें.kiro/agents/सूचीबद्ध करें; Apothem आपके लिए यह नहीं चुनता। - Apothem सहायक के नाम वाली आपकी कोई फ़ाइल
~/.apothem/backups/के अंतर्गत सहेजी जाती है और फिर बदल दी जाती है। अनइंस्टॉल उसे वापस नहीं रखता। अन्य नामों वाली फ़ाइलों को, JSON प्रोफ़ाइल सहित, कभी नहीं छुआ जाता। - Kiro के पृष्ठ इस पर असहमत हैं कि कोई कस्टम एजेंट डिफ़ॉल्ट रूप से
~/.kiro/skills/में स्किल देखता है या नहीं: स्किल पृष्ठ कहता है कि एजेंट को एकskill://संसाधन चाहिए, जबकि कॉन्फ़िगरेशन संदर्भ कहता है कि एजेंट डिफ़ॉल्ट स्किल विरासत में पाता है। इंस्टॉल कोईresourcesकुंजी नहीं जोड़ता, इसलिए सहायक स्किल केवल तभी देखते हैं जब दूसरी व्याख्या सही हो। - Kiro का Built-in tools पृष्ठ वे टूल सूचीबद्ध
करता है जो हर श्रेणी में आम तौर पर शामिल होते हैं।
readश्रेणी में फ़ाइल खोज और टेक्स्ट खोज टूल (CLI 2.x केglobऔरgrep) शामिल हैं, इसीलिएGlobऔरGrepवहाँ मैप होते हैं। इसमेंcode(सिंटैक्स ट्री द्वारा कोड विश्लेषण) औरintrospect(Kiro के बारे में ही प्रश्नों के उत्तर देता है) भी शामिल हैं, इसलिएreadवाला सहायक दोनों का उपयोग कर सकता है। पृष्ठcodeकोwriteके अंतर्गत भी सूचीबद्ध करता है, और यह नहीं बताता कि टूल फ़ाइलें संपादित करता है या नहीं। - Apothem ने पुष्टि नहीं की है कि छोड़ी गई
toolsकुंजी के साथ Kiro क्या करता है, या Kiro कोnameके अलावा कौन-सी फ़्रंट मैटर कुंजियाँ आवश्यक हैं।
हुक
Kiro Kiro हुक दस्तावेज़ के अनुसार
<project>/.kiro/hooks/ में JSON फ़ाइलों से हुक चलाता है। इंस्टॉल वहाँ एक फ़ाइल,
apothem.json (हुक फ़ाइल संस्करण v1), एक हुक के साथ लिखता है:
| ट्रिगर | क्या चलता है |
|---|---|
SessionStart | सत्र बूटस्ट्रैप: सत्र मेटाडेटा, स्किल इंडेक्स, मेमोरी और प्लान सारांश और स्थायी मुद्रा, मॉडल के संदर्भ में जोड़े जाते हैं। |
हुक मॉडल के लिए संदर्भ जोड़ता है। यह किसी टूल कॉल या सत्र को अवरुद्ध नहीं करता।
Apothem Kiro पर कोई PreToolUse या PostToolUse हुक पंजीकृत नहीं करता। Kiro किसी
कमांड का आउटपुट केवल SessionStart और UserPromptSubmit के लिए मॉडल के संदर्भ
में जोड़ता है और टूल इवेंट के लिए उसे अनदेखा करता है। किसी टूल इवेंट पर पंजीकृत
गार्ड हर टूल कॉल पर एक प्रोसेस आरंभ की लागत लेगा और कुछ भी नहीं पहुँचाएगा, इसलिए
write, edit और shell गार्ड, संदर्भ-आकार सलाह और सत्र-समाप्ति प्रोटोकॉल उन टूल्स पर
रहते हैं जो उन्हें पहुँचाते हैं। इंस्टॉल UserPromptSubmit के लिए कोई हुक नहीं
लिखता, और उपयोगकर्ता फ़ोल्डर ~/.kiro/hooks/ में कोई हुक नहीं लिखता।
फ़ाइलें कहाँ जाती हैं
| फ़ाइल | उसमें क्या है |
|---|---|
<project>/.kiro/hooks/apothem.json | हुक पंजीकरण। Apothem इस एक फ़ाइल का स्वामी है। |
<project>/.apothem/support/kiro/hooks/ | डिस्पैचर स्क्रिप्ट, उसके हेल्पर और उसकी संदेश फ़ाइलें। |
हुक फ़ाइल में कमांड ऐसा दिखता है, दोनों पथों की जगह आपके इंटरप्रेटर और प्रोजेक्ट पथ के साथ:
"/path/to/python" "/path/to/project/.apothem/support/kiro/hooks/dispatch.py" --contract kiro SessionStart--contract kiro डिस्पैचर से संदर्भ को सादे टेक्स्ट के रूप में प्रिंट करवाता है, जिसे
Kiro SessionStart के लिए संदर्भ में जोड़ता है। Kiro Windows पर कमांड क्रियाओं के
लिए कोई शेल प्रलेखित नहीं करता। कमांड sh और cmd.exe के लिए लिखा गया है, उद्धरण
चिह्नों में फ़ॉरवर्ड-स्लैश इंटरप्रेटर पथ के साथ; यदि Kiro इसे आपकी मशीन पर
PowerShell के अंतर्गत चलाता है, तो उद्धृत पथ के आगे एक कॉल ऑपरेटर (&) की
आवश्यकता होती है, और आप उसे हाथ से जोड़ सकते हैं।
वर्कस्पेस को विश्वसनीय करें। Kiro CLI 2.33 और बाद के संस्करण किसी वर्कस्पेस के
हुक केवल तब लोड करते हैं जब आप वर्कस्पेस को विश्वसनीय (trust) कर देते हैं: किसी
फ़ोल्डर में पहली बार इंटरैक्टिव V3 सत्र (kiro-cli --v3) शुरू करने पर यह
"Trust this workspace?" पूछता है। Kiro Web सत्र कोई हुक नहीं चलाते। इंस्टॉल इसे
एक नोट के रूप में प्रिंट करता है।
सावधानी से कमिट करें। कमांड उस इंटरप्रेटर का नाम बताता है जो Apothem को चलते
समय मिला, और प्रोजेक्ट का पूर्ण पथ, इसलिए फ़ाइल आपकी मशीन के लिए विशिष्ट है, और
जिन स्क्रिप्ट को यह चलाता है वे .apothem/ में हैं, जिसे प्रोजेक्ट का .gitignore
स्निपेट अनदेखा करता है। यदि आप .kiro/hooks/apothem.json कमिट करते हैं, तो किसी
साथी के चेकआउट को ऐसा हुक मिलता है जो किसी चीज़ की ओर इशारा नहीं करता: Kiro विफल
कमांड के लिए एक चेतावनी दिखाता है और सत्र जारी रहता है। .kiro/hooks/apothem.json
को .gitignore में जोड़ें, या उसे केवल ऐसी टीम के लिए कमिट करें जो एक ही लेआउट
साझा करती है। इंस्टॉल .gitignore संपादित नहीं करता।
आपके अपने हुक। .kiro/hooks/ में आपकी हुक फ़ाइलें कभी पढ़ी या बदली नहीं जातीं।
apothem.json में ही आपके द्वारा जोड़ा गया हुक बना रहता है: अपडेट और अनइंस्टॉल
केवल उन हुक को बदलते या हटाते हैं जिनका कमांड Apothem डिस्पैचर चलाता है
(--contract kiro के साथ .apothem/support/kiro/hooks/dispatch.py, चाहे वह किसी
भी प्रोजेक्ट पथ के अंतर्गत लिखा गया हो)। आपका कोई हुक जो केवल नाम साझा करता है,
या जो python -m apothem.conformity.gate चलाता है, उसे कभी Apothem का नहीं समझा
जाता। जो फ़ाइल वैध JSON नहीं है, वह ~/.apothem/backups/ के अंतर्गत सहेजी जाती है
और बदल दी जाती है।
पथ जिन्हें शेल गलत पढ़ेगा। $, बैकटिक, दोहरा उद्धरण चिह्न या बैकस्लैश वाला
कोई प्रोजेक्ट या इंटरप्रेटर पथ कुछ भी लिखे जाने से पहले अस्वीकार कर दिया जाता है:
उद्धृत कमांड के भीतर वह कोई अलग फ़ाइल चलाएगा, या उस JSON को तोड़ देगा जिसमें
कमांड लिखा जाता है। त्रुटि पथ का नाम बताती है; प्रोजेक्ट को स्थानांतरित करें या
उसका नाम बदलें और इंस्टॉल फिर से चलाएँ। पथ में स्पेस या अपॉस्ट्रॉफ़ी ठीक है।
हुक बंद करना। Apothem हुक को मौन करने के लिए Kiro के परिवेश में
APOTHEM_HOOKS_DISABLE=1 सेट करें। अपडेट Apothem प्रविष्टि को फिर से लिखता है,
इसलिए उसमें किया गया संपादन टिकता नहीं, एक अपवाद के साथ: उस पर
"enabled": false सेट करें, जिसे Kiro किसी हुक को हटाए बिना छोड़ने के रूप में
प्रलेखित करता है, और अपडेट उसे बनाए रखता है।
प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंग
अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और हर apothem install या
apothem update रन पर प्रोजेक्ट स्टीयरिंग फ़ाइल रेंडर करता है। साझा प्रोफ़ाइल
सत्य का स्रोत है; जनित फ़ाइल में किए गए प्रोजेक्ट-स्थानीय संपादनों का बैकअप
अगली सिंक द्वारा Apothem-प्रबंधित सामग्री को बदलने से पहले ले लिया जाता है।
फ़ाइल अपने inclusion: always फ़्रंट मैटर से शुरू होती है, क्योंकि Kiro के लिए
यह आवश्यक है कि इन्क्लूज़न कॉन्फ़िगरेशन फ़ाइल की पहली सामग्री हो।
Apothem-प्रबंधित ब्लॉक उसके बाद आता है; ब्लॉक के बाद आप जो टेक्स्ट जोड़ते हैं, वह
हर सिंक पर बना रहता है।
संगतता टिप्पणियाँ
Kiro की स्टीयरिंग सतह .kiro/steering/ के अंतर्गत प्रोजेक्ट-स्कोप वाली है।
अडैप्टर inclusion: always फ़्रंट मैटर के साथ एक समर्पित apothem-rules.md
स्टीयरिंग फ़ाइल लिखता है और Kiro की ऑपरेटर-लिखित आधार फ़ाइलों (product.md,
tech.md, structure.md) को कभी अधिलेखित नहीं करता। Kiro स्पेक
(.kiro/specs/) ऑपरेटर-स्वामित्व वाले हैं; Apothem उन्हें नहीं लिखता। यह एक हुक
फ़ाइल, .kiro/hooks/apothem.json, लिखता है, और .kiro/hooks/ में कोई अन्य फ़ाइल
नहीं लिखता।
Kiro वैश्विक स्किल के लिए ~/.kiro/skills/ प्रलेखित करता है और
~/.agents/skills/ का उल्लेख नहीं करता, इसलिए इंस्टॉल Kiro फ़ोल्डर लिखता है, न कि
क्रॉस-टूल फ़ोल्डर। उसी नाम वाली वर्कस्पेस स्किल वैश्विक स्किल पर प्राथमिकता पाती
है। Apothem ने पुष्टि नहीं की है कि Kiro किसी ऐसी SKILL.md हेडर कुंजी के साथ कैसा
व्यवहार करता है जिसे वह सूचीबद्ध नहीं करता।
सत्यापन
apothem verify --harness kiro --project /path/to/projectverify कमांड पुष्टि करता है कि:
- नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
- हर प्रबंधित टारगेट मौजूद है,
.kiro/agents/फ़ोल्डर सहित; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं।--profile PATHजोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।.kiro/agents/के लिए जाँच यह है कि फ़ोल्डर मौजूद है, यह नहीं कि हर सहायक फ़ाइल उसमें है;apothem diff --harness kiro --project /path/to/projectउन सहायक फ़ाइलों को सूचीबद्ध करता है जो अनुपस्थित या पुरानी हैं। हुक फ़ाइल.kiro/hooks/apothem.jsonमौजूद होनी चाहिए, खाली नहीं होनी चाहिए, JSON के रूप में पार्स होनी चाहिए और उसमें एक ऐसा हुक होना चाहिए जो Apothem डिस्पैचर चलाता है, और हुक स्क्रिप्ट.apothem/support/kiro/hooks/में होनी चाहिए। जाँच हुक को चलाती नहीं। - हर Apothem स्किल फ़ोल्डर एक
SKILL.mdके साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है। - अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।
अपडेट करना
apothem update --harness kiro --project /path/to/projectवर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट स्टीयरिंग फ़ाइल को पुनः व्युत्पन्न करता है।
अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं।
यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है।
यह उन कस्टम एजेंट फ़ाइलों को फिर से लिखता है जो वर्तमान फ़ाइलों से भिन्न हैं, और जो अनुपस्थित हैं उन्हें जोड़ता है।
यह हुक स्क्रिप्ट और .kiro/hooks/apothem.json में Apothem हुक को भी ताज़ा करता है,
उस फ़ाइल में आपके किसी भी हुक को बनाए रखते हुए।
अनइंस्टॉल करना
apothem uninstall --harness kiro --project /path/to/project<project>/.kiro/steering/apothem-rules.md से Apothem ब्लॉक को, और उसके ऊपर
Apothem द्वारा लिखे गए फ़्रंट मैटर को, हटाता है और उसमें मौजूद किसी भी अन्य टेक्स्ट
को बनाए रखता है। फ़ाइल केवल तभी हटाई जाती है जब उसमें और कुछ शेष न रहे। बदलाव से
पहले, फ़ाइल की एक टाइमस्टैम्प-युक्त प्रति ~/.apothem/backups/ के अंतर्गत सहेजी
जाती है; प्रोजेक्ट में कोई बैकअप फ़ाइल नहीं छोड़ी जाती। साझा प्रोफ़ाइल YAML और
Apothem इंजन अप्रभावित रहते हैं।
अनइंस्टॉल <project>/.kiro/agents/ में अपने द्वारा लिखी गई कस्टम एजेंट फ़ाइलें भी
हटाता है और वहाँ की किसी भी अन्य फ़ाइल को रखता है; खाली रह जाने पर फ़ोल्डर हटा
दिया जाता है। यह <project>/.kiro/hooks/apothem.json से Apothem हुक हटाता है, उसे
उसके कमांड में डिस्पैचर पथ से पहचानते हुए, इसलिए यह बिना इंस्टॉल रिकॉर्ड के भी काम
करता है, और उस फ़ाइल में आपके किसी भी हुक को रखता है। फ़ाइल तब हटाई जाती है जब
उसमें और कुछ न रहे, और आपकी अन्य हुक फ़ाइलों को नहीं छुआ जाता। यदि फ़ाइल में ऐसी
टिप्पणियाँ हैं जिन्हें अनइंस्टॉल पढ़ नहीं सकता, तो वह फ़ाइल को जैसी है वैसी छोड़
देता है और हुक को कारण सहित छोड़ा गया रिपोर्ट करता है; Apothem हुक को हाथ से हटाएँ।
<project>/.apothem/support/kiro/hooks/ में हुक स्क्रिप्ट भी हटा दी जाती हैं।
यह ~/.kiro/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और
~/.config/apothem/ में नियम और टेम्पलेट हटाता है, लेकिन केवल तभी जब कोई अन्य
Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा
करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है,
प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता
है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया
फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/
के अंतर्गत उसका बैकअप लिया जाता है।
अनुरूपता गेट
python -m apothem.conformity.gate --all .समस्या निवारण
| लक्षण | समाधान |
|---|---|
| कॉन्फ़िग फ़ाइल नहीं मिली | apothem install --harness kiro --project /path/to/project फिर से चलाएँ |
| सत्यापन विफल रहा | apothem update --harness kiro --project /path/to/project चलाएँ, फिर दोबारा सत्यापित करें |
| Kiro कोई भी Apothem सहायक सूचीबद्ध नहीं करता | वर्कस्पेस को विश्वसनीय (trust) करें (CLI किसी फ़ोल्डर में पहले इंटरैक्टिव V3 सत्र पर "Trust this workspace?" पूछता है), और IDE या kiro-cli --v3 का उपयोग करें |
| Apothem हुक नहीं चलता | वर्कस्पेस को विश्वसनीय (trust) करें (CLI किसी फ़ोल्डर में पहले इंटरैक्टिव V3 सत्र पर "Trust this workspace?" पूछता है), और IDE या kiro-cli --v3 का उपयोग करें। Kiro Web सत्र कोई हुक नहीं चलाते। सत्र की शुरुआत में कमांड के बारे में चेतावनी का अर्थ है कि इस मशीन पर इंटरप्रेटर या .apothem/support/kiro/hooks/ फ़ोल्डर अनुपस्थित है: वहाँ apothem install --harness kiro --project /path/to/project चलाएँ |
apothem verify किसी अनुपस्थित स्किल फ़ोल्डर का नाम बताता है | apothem install --harness kiro --project /path/to/project चलाएँ; यह फ़ोल्डर को पुनर्स्थापित करता है |
| कोई इंस्टॉल या अपडेट चेतावनी देता है कि उसने एक स्किल फ़ोल्डर छोड़ दिया | Apothem स्किल के नाम वाला एक फ़ोल्डर स्किल फ़ोल्डर में पहले से मौजूद है और उसे Apothem ने नहीं लिखा। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ |
| कोई इंस्टॉल प्रोजेक्ट बदलने से पहले रुक जाता है | आपकी होम डायरेक्टरी में कोई लेखन विफल रहा। त्रुटि पढ़ें, उसमें नामित फ़ोल्डर ठीक करें (ऐसा लिंक जो आपकी होम डायरेक्टरी से बाहर जाता है, फ़ोल्डर की जगह कोई फ़ाइल, या केवल-पठन फ़ोल्डर), और फिर से इंस्टॉल करें |
| अप्रत्याशित कॉन्फ़िग सामग्री | ~/.config/apothem/profile.yaml या --profile PATH जाँचें, फिर apothem update --harness kiro --project /path/to/project फिर से चलाएँ |
कॉन्फ़िगरेशन नॉब
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--dry-run | false | फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें। |
यह भी देखें
- सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
- इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
apothem harnessesसंदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें