SKILL.md को सीधे नहीं लिखते
— वे एक प्रस्ताव बनाते हैं (सामग्री, लक्ष्य बाइंडिंग, स्कैनर स्थिति,
हैश और रोलबैक मेटाडेटा वाला लंबित ड्राफ़्ट), जो लागू किए जाने पर ही
लाइव Skill बनता है।
Skill Workshop केवल कार्यस्थान Skills लिखता है। यह कभी भी बंडल किए गए,
Plugin, ClawHub, अतिरिक्त-रूट, प्रबंधित, व्यक्तिगत-एजेंट या सिस्टम Skills को नहीं छूता।
यह कैसे काम करता है
- पहले प्रस्ताव: जनरेट की गई सामग्री
PROPOSAL.mdके रूप में संग्रहीत होती है, न किSKILL.mdके रूप में। - लागू करना ही एकमात्र लाइव लेखन है: बनाना, अपडेट करना और संशोधित करना कभी भी सक्रिय Skills को नहीं बदलते।
- कार्यस्थान तक सीमित: बनाए गए Skills कार्यस्थान के
skills/रूट को लक्षित करते हैं; अपडेट केवल लिखने योग्य कार्यस्थान Skills के लिए अनुमत हैं। - ओवरराइट नहीं: यदि लक्ष्य Skill पहले से मौजूद है, तो बनाना विफल हो जाता है।
- हैश से बंधा: अपडेट प्रस्ताव वर्तमान लक्ष्य हैश से बंधते हैं और यदि लागू करने से पहले
लाइव Skill बदल जाता है, तो
staleहो जाते हैं। - स्कैनर द्वारा नियंत्रित: लागू करने से पहले सुरक्षा स्कैनर दोबारा चलता है।
- पुनर्प्राप्त करने योग्य: लागू करने की प्रक्रिया लाइव फ़ाइलों को छूने से पहले रोलबैक मेटाडेटा लिखती है।
- सुसंगत सतहें: चैट, CLI और Gateway सभी एक ही सेवा को कॉल करते हैं।
जीवनचक्र
pending प्रस्ताव को संशोधित, लागू, अस्वीकार या क्वारंटीन किया जा सकता है।
जीवनचक्र प्रबंधन
Gateway साझा स्थिति डेटाबेस में Skill के समग्र उपयोग को ट्रैक करता है। दिन में एक बार, यह Skill Workshop द्वारा बनाए और लागू किए गए Skills की समीक्षा करता है। 30 दिनों से अधिक समय तक उपयोग न किए गए Skillsstale हो जाते हैं; 90 दिनों के बाद वे archived हो जाते हैं और
नए एजेंट Skill स्नैपशॉट में शामिल नहीं किए जाते। संग्रहित Skill फ़ाइलें डिस्क पर
अपरिवर्तित रहती हैं। मैन्युअल रूप से लिखे गए Skills का कभी प्रबंधन नहीं किया जाता; केवल Skill
Workshop प्रस्तावों द्वारा बनाए गए Skills जीवनचक्र प्रबंधन में शामिल होते हैं।
पिन किए गए Skills जीवनचक्र संक्रमणों से बाहर रहते हैं। किसी अप्रचलित Skill का उपयोग होने और अगला स्वीप चलने के बाद वह active
पर लौट आता है। संग्रहित Skills केवल स्पष्ट पुनर्स्थापना के माध्यम से लौटते हैं:
जीवनचक्र संक्रमण और पुनर्स्थापनाएँ नए सत्रों पर लागू होते हैं; चल रहे सत्र अपने
वर्तमान Skill स्नैपशॉट को बनाए रखते हैं।
--json स्वीकार करते हैं। स्थिति नियतात्मक ओवरलैप
उम्मीदवारों को भी केवल सुझावों के रूप में रिपोर्ट करती है; यह कभी Skills को मर्ज नहीं करती या किसी मॉडल को कॉल नहीं करती।
चैट
एजेंट से इच्छित Skill के लिए कहें; वहskill_workshop को कॉल करता है और
प्रस्ताव आईडी लौटाता है।
हाल के कार्य से सीखें
वर्तमान वार्तालाप या नामित स्रोतों को मानक-निर्देशित Skill प्रस्ताव में बदलने के लिए/learn का उपयोग करें:
/learn एजेंट से वर्तमान वार्तालाप से पुनः उपयोग योग्य कार्यप्रवाह
निकालने के लिए कहता है। अनुरोध होने पर, एजेंट फ़ोकस, दायरे और
नामकरण आवश्यकताओं का पालन करते हुए पथों, URL, चिपकाए गए नोट्स और वार्तालाप
संदर्भों को स्रोत मानता है। वह अपने मौजूदा टूल से स्रोत एकत्र करता है, फिर
skill_workshop को action: "create" के साथ कॉल करता है।
परिणामी प्रस्ताव pending बना रहता है; /learn उसे कभी लागू नहीं करता। सामान्य अनुमोदन प्रवाह या openclaw skills workshop के माध्यम से
उसकी समीक्षा करें और उसे लागू करें।
बनाएँ:
apply, reject और quarantine डिफ़ॉल्ट रूप से अतिरिक्त
अनुमोदन संकेत के बिना चलते हैं। उन कार्रवाइयों से पहले ऑपरेटर अनुमोदन आवश्यक करने के लिए skills.workshop.approvalPolicy को "pending"
पर सेट करें।
जब अनुमोदन आवश्यक होता है, तो संकेत प्रस्ताव आईडी और लक्ष्य
Skill की पहचान करता है और प्रस्ताव का विवरण, सहायक-फ़ाइल संख्या तथा मुख्य सामग्री का आकार दिखाता है।
अनुमोदन अनुरोधों को एजेंट टूल वॉचडॉग से पहले पूरा होने के लिए सीमित किया जाता है। यदि
संकेत समाप्त होने से पहले कोई निर्णय नहीं आता, तो जीवनचक्र कार्रवाई नहीं चलती:
प्रस्ताव लंबित और अपरिवर्तित रहता है। बाद में Skill Workshop UI में निर्णय लें या
openclaw skills workshop apply|reject|quarantine <proposal-id> चलाएँ। एजेंटों को
समाप्त हो चुकी जीवनचक्र कार्रवाई को लूप में दोबारा नहीं आज़माना चाहिए।
CLI
--agent <id> (लक्ष्य कार्यस्थान; डिफ़ॉल्ट रूप से
पहले cwd से अनुमानित, फिर डिफ़ॉल्ट एजेंट) और --json (संरचित आउटपुट) लेता है।
propose-create, propose-update और revise, --proposal के साथ प्रस्ताव संदर्भ रिकॉर्ड करने के लिए --goal <text> और
--evidence <text> भी लेते हैं।
प्रस्ताव सामग्री
लंबित रहते समय, प्रस्ताव को केवल-प्रस्ताव फ्रंटमैटर के साथPROPOSAL.md के रूप में संग्रहीत किया जाता है:
SKILL.md लिखता है और
केवल-प्रस्ताव फ़ील्ड हटा देता है: status, प्रस्ताव version और प्रस्ताव date।
सहायक फ़ाइलें
जब प्रस्तावित Skill कोPROPOSAL.md के पास फ़ाइलों की आवश्यकता हो,
तो --proposal-dir का उपयोग करें:
PROPOSAL.md होना आवश्यक है। सहायक फ़ाइलें
assets/, examples/, references/, scripts/ या templates/ के अंतर्गत होनी चाहिए। Skill
Workshop उन्हें स्कैन करता है, हैश करता है और प्रस्ताव के साथ संग्रहीत करता है, फिर केवल लागू करने पर
उन्हें लाइव SKILL.md के पास लिखता है।
अस्वीकृत सहायक-फ़ाइल पथ: पूर्ण पथ, छिपे हुए पथ खंड, पथ
ट्रैवर्सल, ओवरलैप होते पथ, निष्पादन योग्य फ़ाइलें, गैर-UTF-8 पाठ, नल बाइट्स
और मानक सहायक फ़ोल्डरों से बाहर के पथ।
एजेंट टूल
मॉडल एक आवश्यकaction:
create | update | revise | list | inspect | apply | reject | quarantine के साथ skill_workshop का उपयोग करता है।
अन्य पैरामीटर कार्रवाई के अनुसार लागू होते हैं:
एजेंटों को जनरेट किए गए Skill कार्य के लिए
skill_workshop का उपयोग करना आवश्यक है। उन्हें
write, edit, exec, शेल
कमांड या प्रत्यक्ष फ़ाइल सिस्टम कार्रवाइयों के माध्यम से प्रस्ताव फ़ाइलें बनानी या बदलनी नहीं चाहिए।
skill_workshop एक अंतर्निर्मित एजेंट टूल है और
tools.profile: "coding" में शामिल है। यदि अधिक कठोर नीति इसे छिपाती है, तो सक्रिय tools.allow सूची में
skill_workshop जोड़ें, या जब दायरा स्पष्ट tools.allow के बिना किसी प्रोफ़ाइल का उपयोग करता हो, तब
tools.alsoAllow: ["skill_workshop"] का उपयोग करें। सैंडबॉक्स में चलने वाली प्रक्रियाएँ होस्ट-पक्ष
Skill Workshop टूल का निर्माण नहीं करतीं, इसलिए प्रस्ताव समीक्षा कार्रवाइयाँ किसी सामान्य होस्ट-पक्ष
एजेंट सत्र या CLI से चलाएँ।सुझाए गए Skills
इंटरैक्टिव टर्न समाप्त होने पर OpenClaw “अगली बार,” “याद रखें,” और प्रतिक्रियात्मक सुधारों जैसे टिकाऊ निर्देशों का पता लगाता है, जिसमें विफल टर्न भी शामिल हैं। अगले टर्न पर, एजेंटskill_workshop के माध्यम से सबसे हाल में पहचाने गए कार्यप्रवाह को सहेजने की पेशकश करता है; उपयोगकर्ता तय करता है कि
प्रस्ताव बनाना है या नहीं। यह अंतर्निर्मित सुझाव स्वयं कोई Skill बनाता या बदलता नहीं है। इसके बजाय
सीधे लंबित प्रस्ताव बनाने के लिए skills.workshop.autonomous.enabled सक्षम करें। Control
UI में, Workshop टैब पृष्ठ शीर्षलेख में Self-learning टॉगल के रूप में और
खाली प्रस्ताव बोर्ड पर सक्षम करने वाले बटन के रूप में यही सेटिंग प्रदान करता है।
पिछले सत्र स्कैन करें
Control UI स्वायत्त स्व-अधिगम सक्षम किए बिना पुराने कार्य की समीक्षा कर सकता है। Plugins → Workshop खोलें और Find skill ideas चुनें। स्कैन नवीनतम योग्य सत्रों से शुरू होता है और पर्याप्त कार्य की एक सीमित विंडो की समीक्षा करता है। यह cron, heartbeat, hook, subagent, ACP, Plugin-स्वामित्व वाले और आंतरिक समीक्षा सत्रों के साथ-साथ छह से कम मॉडल टर्न वाली वार्ताओं को छोड़ देता है। समीक्षक चयनित एजेंट के कॉन्फ़िगर किए गए मॉडल का उपयोग करता है और उसे गोपनीय जानकारी से संशोधित, आकार-सीमित ट्रांसक्रिप्ट बंडल मिलता है। यह अनुभव समीक्षा जैसी ही रूढ़िवादी कसौटी लागू करता है: कोई ठोस पुनर्प्राप्ति पैटर्न या स्थिर प्रक्रिया जो भविष्य के कम-से-कम दो मॉडल या टूल कॉल हटा दे। नियमित कार्य और एकबारगी तथ्यों से कोई प्रस्ताव नहीं बनना चाहिए। एक स्कैन अधिकतम तीन लंबित प्रस्ताव बना या संशोधित कर सकता है। यह किसी लाइव Skill को लागू, अस्वीकार, क्वारंटीन या संपादित नहीं कर सकता। Workshop संचयी कवरेज दिखाता है, उदाहरण के लिए 20 सत्रों की समीक्षा हुई · 18 जून–आज · 2 विचार मिले। स्थायी सबसे-पुराने-सत्र कर्सर से जारी रखने के लिए Scan earlier work चुनें। उपलब्ध इतिहास समाप्त होने के बाद, कार्रवाई Scan new work बन जाती है। ऐतिहासिक समीक्षा मैन्युअल होती है, भले हीskills.workshop.autonomous.enabled का मान false हो। प्रत्येक क्लिक एक मॉडल रन शुरू करता है,
इसलिए प्रदाता के मूल्य निर्धारण और डेटा-प्रबंधन की शर्तें लागू होती हैं। कर्सर और कवरेज की संख्याएँ
साझा OpenClaw स्थिति डेटाबेस में संग्रहीत होती हैं; ट्रांसक्रिप्ट की सामग्री को
स्कैन स्थिति में कॉपी नहीं किया जाता।
स्वायत्त कैप्चर सक्षम होने पर, OpenClaw सफल और पर्याप्त कार्य के बाद तथा संपूर्ण
एजेंट सिस्टम के निष्क्रिय हो जाने के बाद एक सतर्क समीक्षा भी कर सकता है। वह पृथक समीक्षा अधिकतम
एक लंबित प्रस्ताव बना या संशोधित कर सकती है। वह किसी सक्रिय स्किल को अपडेट नहीं कर सकती या किसी
प्रस्ताव को लागू, अस्वीकार अथवा क्वारंटीन नहीं कर सकती, भले ही approvalPolicy का मान "auto" हो।
सक्षमता, पात्रता, गोपनीयता और लागत के विवरण, प्रस्ताव सीमा तथा समस्या निवारण के लिए
स्व-अधिगम देखें।
अनुमोदन और स्वायत्तता
स्वायत्त कैप्चर भावी नियमों (उदाहरण के लिए, “अब से”) और प्रतिक्रियात्मक
सुधारों (उदाहरण के लिए, “मैंने यह नहीं माँगा था”) को पहचानता है। यह नए निर्देशों को विषय के आधार पर प्रत्येक
टर्न में अधिकतम तीन प्रस्तावों में समूहित करता है, शब्दावली के मेल को मौजूदा लिखने योग्य वर्कस्पेस स्किल तक भेजता है, और
जब कोई अन्य सुधार उसी स्किल को लक्षित करता है, तो अपने ही लंबित प्रस्ताव को संशोधित करता है।
स्पष्ट सुधार के बिना सफल और पर्याप्त कार्य के लिए, चयनित
मॉडल का एक पृथक रन तय करता है कि पूर्ण किया गया कार्य-प्रवाह सतर्क प्रस्ताव मानदंड को पूरा करता है या नहीं।
प्रतिक्रिया देने से पहले अग्रभूमि मॉडल को सीखने का संकेत नहीं दिया जाता। पृष्ठभूमि समीक्षक प्रस्ताव के स्रोत के रूप में
अग्रभूमि रन को सुरक्षित रखता है, सामान्य एजेंट टूल तक नहीं पहुँच सकता और जीवनचक्र संबंधी
निर्णय नहीं ले सकता। समीक्षा केवल तभी शुरू होती है जब अग्रभूमि रनटाइम अपने सटीक रिज़ॉल्व किए गए मॉडल
और यह कि
skill_workshop वास्तव में उपलब्ध था, दोनों की सूचना देता है। इसलिए प्रतिबंधात्मक या अज्ञात टूल नीति
सुरक्षित रूप से विफल होती है और कोई प्रस्ताव नहीं बनाती।
पूर्ण स्वायत्त समीक्षा व्यवहार और सुरक्षा
मॉडल के लिए स्व-अधिगम देखें।
प्रस्ताव के विवरण हमेशा 160 बाइट तक सीमित होते हैं, चाहे
maxSkillBytes का मान कुछ भी हो।
Gateway विधियाँ
requestRevision केवल Gateway के लिए है (कोई CLI या एजेंट-टूल समकक्ष नहीं): यह
PROPOSAL.md को सीधे बदलने के बजाय स्वतंत्र-पाठ संशोधन निर्देशों को स्वामी एजेंट के चैट सत्र
में अग्रेषित करता है, उन UI के लिए जो एजेंट से शाब्दिक नई सामग्री सबमिट करने के बजाय
संशोधन करने को कहते हैं।
historyStatus और historyScan Control UI की सहायक विधियाँ हैं। historyScan
direction: "older" | "newer" स्वीकार करता है; यह परिणामों को हमेशा लंबित
प्रस्तावों के रूप में छोड़ता है।
संग्रहण
~/.openclaw।
proposal.json: प्रामाणिक प्रस्ताव रिकॉर्ड।proposals.json: तेज़ सूचीकरण सूचकांक, प्रस्ताव फ़ोल्डरों से पुनर्निर्माण योग्य।PROPOSAL.md: लंबित स्किल प्रस्ताव।rollback.json: लागू करने की कार्रवाई द्वारा सक्रिय फ़ाइलें बदलने से पहले लिखा गया पुनर्प्राप्ति मेटाडेटा।
सीमाएँ
समस्या निवारण
टूल-नीति निदान
स्वायत्त कैप्चर सक्षम होने पर,openclaw doctor डिफ़ॉल्ट एजेंट के लिए
core/doctor/skill-workshop-tool-policy जाँच चलाता है। यदि नीति
skill_workshop को छिपाती है, तो चेतावनी में बहिष्कृत करने वाली पहली कॉन्फ़िगरेशन परत और किए जाने वाले
सटीक allow या alsoAllow परिवर्तन का नाम दिया जाता है। पुराने रनबुक अभी भी
openclaw plugins inspect skill-workshop का उपयोग कर सकते हैं; वह कमांड अब बताता है कि स्किल
वर्कशॉप अंतर्निहित है और लागू होने पर वही नीति संकेत प्रिंट करता है।
संबंधित
- लोड क्रम, प्राथमिकता और दृश्यता के लिए Skills
- सतर्क पोस्ट-रन स्किल प्रस्तावों के लिए स्व-अधिगम
- हाथ से लिखे गए
SKILL.mdकी मूल बातों के लिए स्किल बनाना - पूर्ण
skills.workshopस्कीमा के लिए स्किल कॉन्फ़िगरेशन openclaw skillsकमांड के लिए स्किल CLI