एआई सहायकों की "खराब याददाश्त" नहीं होती। उनके पास होती है। खराब गवर्नेंस आपने इसे देखा है: आपने एक विस्तृत आर्किटेक्चर गाइड लिखी। मॉडल इसे अनदेखा कर देता है। आपने "4-लेयर आर्किटेक्चर" कहा। यह 3 लेयर्स आउटपुट करता है। आपने "कोई नहीं" कहा। यह को ऐसे छोड़ देता है मानो वह आपका एहसान कर रहा हो। el-input <el-input v-model="value" /> यह बुद्धिमत्ता के बारे में नहीं है। यह प्रोत्साहन के बारे में है। Claude Code में, हैं, न कि एक कठिन बाधा। यदि Claude "महसूस" करता है कि वह कौशल को कॉल किए बिना उत्तर दे सकता है, तो वह ऐसा करेगा। और । कौशल उपलब्ध संदर्भ आपके प्रोजेक्ट हैंडबुक सजावट बन जाती है हमारी टीम पर, Claude Code के साथ RuoYi-Plus कोडबेस बनाते हुए, हमने इसे ट्रैक किया: हस्तक्षेप के बिना, Claude सक्रिय रूप से प्रोजेक्ट स्किल्स को केवल ~25% समय में सक्रिय करता है। तो 4 में से 3 बार, आपके "नियम" नियम नहीं हैं। वे एक सुझाव हैं। हम कुछ अधिक सख्त चाहते थे: एक ऐसा तंत्र जो Claude को एक चतुर इंटर्न की तुलना में एक स्टाफ इंजीनियर की तरह व्यवहार करने के लिए मजबूर करे जो कोड लिखने से पहले प्लेबुक पढ़ता है। इसका समाधान अधिक प्रॉम्प्टिंग नहीं था। इसका समाधान था। हुक लगभग 1 महीने के पुनरावृति के बाद, हमने एक कॉन्फ़िगरेशन स्टैक शिप किया: .claude (गवर्नेंस) 4 लाइफसाइकिल हुक (ज्ञान) 26 डोमेन स्किल्स (प्रक्रिया ऑर्केस्ट्रेशन) स्लैश कमांड (समानांतर विशेषज्ञ) एजेंट परिणाम: कम नियम-उल्लंघन कोड, "इसे फिर से करें" चक्रों की कम संख्या, और बहुत कम जोखिम भरे टूल क्रियाएं। डेव कार्यों के लिए कौशल सक्रियण: ~25% → 90%+ यह लेख आर्किटेक्चर को तोड़ता है ताकि आप इसे अपने रिपॉजिटरी में पुन: पेश कर सकें। 1) Claude Code "क्यों भूल जाता है": डिफ़ॉल्ट रूप से स्किल्स ऑप्ट-इन हैं Claude Code का डिफ़ॉल्ट प्रवाह इस तरह दिखता है: उपयोगकर्ता प्रॉम्प्ट → Claude उत्तर देता है (शायद एक कौशल को कॉल करता है, शायद नहीं) वह "शायद" समस्या है। Claude का आंतरिक निर्णय हेयुरिस्टिक आमतौर पर होता है: "क्या मैं अतिरिक्त संदर्भ के बिना इसका उत्तर जल्दी दे सकता हूँ?" न कि "क्या मुझे रिपॉजिटरी नियमों का पालन करना चाहिए?" इसलिए सिस्टम सुविधा की ओर बढ़ता है। आप जो चाहते हैं वह है : एक हल्का "नियंत्रण प्लेन" जो Claude के तर्क शुरू करने से *पहले* चलता है, और हर बार काम को आकार देता है। संस्थागत घर्षण 2) सफलता: एक जबरन कौशल मूल्यांकन हुक हमने एक हुक लागू किया जो सबसे पहले चलता है: । UserPromptSubmit यह एक छोटा नीति ब्लॉक प्रिंट करता है जिसे Claude कुछ भी करने से *पहले* देखता है: प्रत्येक कौशल का मूल्यांकन करें: हाँ/नहीं + कारण यदि कोई "हाँ" है: तुरंत कौशल को कॉल करें उसके बाद ही: कार्यान्वयन के लिए आगे बढ़ें "जबरन मूल्यांकन" हुक (मुख्य तर्क) हम इसे जानबूझकर मूर्खतापूर्ण और नियतात्मक रखते हैं: स्लैश कमांड का पता लगाएं (एस्केप हैच) अन्यथा मूल्यांकन प्रोटोकॉल प्रिंट करें // .claude/hooks/skill-forced-eval.js (मुख्य विचार, सरलीकृत) const prompt = process.env.CLAUDE_USER_PROMPT ?? ""; // एस्केप हैच: यदि उपयोगकर्ता ने स्लैश कमांड का उपयोग किया है, तो जबरन मूल्यांकन छोड़ें const isSlash = /^\/[^\s/]+/.test(prompt.trim()); if (isSlash) process.exit(0); const skills = [ "crud-development", "api-development", "database-ops", "ui-pc", "ui-mobile", // ... जारी रखें (हमारे पास 26 हैं) ]; const instructions = [ "## अनिवार्य कौशल सक्रियण प्रोटोकॉल (पालन करना होगा)", " ", "### चरण 1 — मूल्यांकन", "प्रत्येक कौशल के लिए, आउटपुट करें: [कौशल] — हाँ/नहीं — कारण", " ", "### चरण 2 — सक्रिय करें", "यदि कोई भी कौशल हाँ है → तुरंत Skill(<name>) को कॉल करें।", "यदि सभी नहीं हैं → 'कोई कौशल आवश्यक नहीं' बताएं और जारी रखें।", " ", "### चरण 3 — कार्यान्वित करें", "चरण 2 पूरा होने के बाद ही, वास्तविक समाधान शुरू करें।", " ", "उपलब्ध कौशल:", ...skills.map(s => `- ${s}`) ].join("\n"); console.log(instructions); व्यवहार में क्या बदलता है पहले (कोई हुक नहीं): "कूपन प्रबंधन बनाएँ।" Claude कोडिंग शुरू करता है... और आपकी 4-लेयर आर्किटेक्चर या निषिद्ध घटकों को अनदेखा कर देता है। बाद में (जबरन मूल्यांकन हुक): Claude को पहले एक स्पष्ट निर्णय तालिका बनानी होगी, फिर कौशल सक्रिय करने होंगे, फिर कार्यान्वित करना होगा। व्यवहार परिवर्तन नाटकीय है क्योंकि आप "वैकल्पिक अनुपालन" को समाप्त कर रहे हैं। 3) 90% क्यों और 100% क्यों नहीं? क्योंकि हमने जानबूझकर एक जोड़ा है। फास्ट पाथ जब कोई उपयोगकर्ता जानता है कि वे क्या चाहते हैं, तो एक कमांड टाइप करना जैसे: /dev build coupon management /crud b_coupon /check तुरंत होना चाहिए। इसलिए हुक स्लैश कमांड के लिए मूल्यांकन छोड़ देता है और कमांड वर्कफ़्लो को संभालने देता है। यह है समझौता: मुक्त-रूप प्रॉम्प्ट के लिए शासन संरचित कमांड के लिए गति 4) हुक एक लाइफसाइकिल नियंत्रण प्लेन के रूप में (4-हुक स्टैक) हुक को एक एजेंट सत्र के लिए सीआई पाइपलाइन के रूप में सोचें - सिवाय इसके कि यह आपके टर्मिनल में लाइव चलता है। हम चार प्रमुख बिंदुओं का उपयोग करते हैं: 4.1 SessionStart: "बात करने से पहले रिपॉजिटरी को देखें" जब एक सत्र शुरू होता है, हम दिखाते हैं: वर्तमान गिट ब्रांच अCommit किए गए बदलाव खुले TODO / स्थिति सामान्य कमांड उदाहरण आउटपुट: 🚀 सत्र शुरू हुआ: RuoYi-Plus-Uniapp समय: 2026-02-16 21:14 ब्रांच: master ⚠️ Uncommitted changes: 5 files 📋 TODO: 3 open / 12 done Shortcuts: /dev feature बनाएँ /crud module generate करें /check conventions verify करें Claude ऐसे कार्य करना बंद कर देता है जैसे वह एक खाली कमरे में प्रवेश कर रहा हो। यह क्यों मायने रखता है: 4.2 UserPromptSubmit: जबरन कौशल मूल्यांकन (अनुशासन) यह "हैंडबुक पढ़ना होगा" गेट है। 4.3 PreToolUse: सुरक्षा परत (टूल गवर्नेंस) Claude Code शक्तिशाली है क्योंकि यह टूल चला सकता है: बैश, फाइलें लिखना, कोड संपादित करना। यह वह जगह है जहाँ दुर्घटनाएँ भी होती हैं। PreToolUse कुछ अपरिवर्तनीय होने से पहले आपकी रक्षा की अंतिम पंक्ति है। हम एक छोटी काली सूची को ब्लॉक करते हैं (और एक व्यापक ग्रे सूची पर चेतावनी देते हैं): // .claude/hooks/pre-tool-use.js (वैचारिक) const cmd = process.env.CLAUDE_TOOL_INPUT ?? ""; const hardBlock = [ /rm\s+(-rf|--recursive).*\s+\//i, /drop\s+(database|table)\b/i, />\s*\/dev\/sd[a-z]\b/i, ]; if (hardBlock.some(p => p.test(cmd))) { console.log(JSON.stringify({ decision: "block", reason: "खतरनाक कमांड पैटर्न का पता चला" })); process.exit(0); } // वैकल्पिक रूप से: संवेदनशील कार्यों पर चेतावनी/पुष्टि करें (बड़े पैमाने पर हटाना, chmod -R, आदि) यह व्यामोह नहीं है। हमने मॉडल को गलत निर्देशिका में के साथ "अस्थायी फ़ाइलों को साफ़" करते देखा है। आप एक गार्डरेल चाहते हैं जो मॉडल के सावधान रहने पर निर्भर न हो। rm -rf 4.4 Stop: अगले चरण के मार्गदर्शन के साथ "लूप बंद करें" जब Claude समाप्त करता है, हम: फ़ाइल परिवर्तनों का सारांश (नया बनाम संशोधित) अगले चरणों का सुझाव दें (परीक्षण चलाएँ, दस्तावेज़ अपडेट, कमिट) वैकल्पिक रूप से एजेंटों को ट्रिगर करें (कोड समीक्षा) उदाहरण: ✅ हो गया — 8 फ़ाइलें बदलीं अगले कदम: - बैकेन्ड कन्वेंशन्स के लिए @code-reviewer - SQL बदला: माइग्रेशन स्क्रिप्ट सिंक करें - विचार करें: git commit -m "feat: coupon module" लक्ष्य: "यह चैट में काम किया" गैप को खत्म करना। 5) स्किल्स: वह ज्ञान परत जिसे आप वास्तव में लागू कर सकते हैं एक बार जब सक्रियण नियतात्मक हो जाता है, तो स्किल्स वह बन जाती हैं जो वे होने वाली थीं: एक । डोमेन-विशिष्ट ज्ञान आधार हमने 26 स्किल्स बनाईं: बैकएंड (CRUD, API, DB, एनोटेशन, त्रुटि हैंडलिंग) फ्रंटएंड (पीसी घटक नीति, स्थिति प्रबंधन) मोबाइल (UI किट, यूनिঅ্যাপ प्लेटफॉर्म बाधाएं) एकीकरण (भुगतान, वीचैट, ओएसएस) गुणवत्ता (प्रदर्शन, सुरक्षा, बग जासूस) इंजीनियरिंग प्रबंधन (आर्किटेक्चर, गिट वर्कफ़्लो, तकनीकी निर्णय) एक कौशल फ़ाइल संरचना जो स्केल करती है हर एक ही कंकाल का अनुसरण करता है: SKILL.md # कौशल का नाम ## कब ट्रिगर करें - कीवर्ड: - परिदृश्य: ## मुख्य नियम ### नियम 1 स्पष्टीकरण + उदाहरण ### नियम 2 स्पष्टीकरण + उदाहरण ## निषिद्ध - ❌ ... ## संदर्भ कोड - path/to/file ## चेकलिस्ट - [ ] ... यह स्थिरता मायने रखती है क्योंकि मॉडल सीखता है कि स्किल्स का *उपभोग* कैसे करें। 6) कमांड: वर्कफ़्लो, सुझाव नहीं स्किल्स "क्या सही है" हल करती हैं। कमांड "प्रक्रिया क्या है" हल करते हैं। 6.1 : 7-चरणीय विकास पाइपलाइन /dev हमने को एक राय वाले वर्कफ़्लो के रूप में डिज़ाइन किया: /dev आवश्यकताओं को स्पष्ट करें डिज़ाइन (API + मॉड्यूल + अनुमतियाँ) DB डिज़ाइन (SQL + शब्दकोश + मेनू) बैकएंड (4-लेयर आउटपुट) फ्रंटएंड (घटक नीति + रूटिंग) परीक्षण/सत्यापित करें दस्तावेज़ीकरण/प्रगति अद्यतन यह मूल रूप से है: "वरिष्ठ जूनियर को कैसे काम करवाना चाहते हैं" एक चलने योग्य स्क्रिप्ट के रूप में एन्कोड किया गया है। 6.2 : एक तालिका से एक पूर्ण मॉड्यूल उत्पन्न करें /crud इनपुट: /crud b_coupon आउटपुट (उदाहरण सेट): इकाई / बीओ / वीओ डीएओ + क्वेरी रैपर नियम सेवा + नियंत्रक (कोई निषिद्ध पैटर्न नहीं) मैपर फ्रंटएंड एपीआई + पृष्ठ ढांचा मैन्युअल प्रयास: कमांड-संचालित: (समीक्षा के अतिरिक्त) 2–4 घंटे 5–10 मिनट 6.3 : पूर्ण-स्टैक कन्वेंशन लिंटिंग (मानव-पठनीय) /check यह वह जगह है जहाँ हम स्किल्स को एक सत्यापनकर्ता में बदलते हैं: बैकएंड: लेयरिंग नियम, निषिद्ध वंशानुक्रम, क्वेरी रैपर नीति फ्रंटएंड: निषिद्ध घटक, रैपर उपयोग मोबाइल: घटक किट, इकाइयां, आयात 7) एजेंट: समानांतर विशेषज्ञ (मुख्य थ्रेड को ओवरलोड न करें) कुछ कार्यों को एक समर्पित उप-एजेंट द्वारा संभाला जाना चाहिए: : एक सख्त चेकलिस्ट के साथ कन्वेंशन जांच @code-reviewer : स्थिति दस्तावेज़, TODOs, प्रगति मेट्रिक्स अपडेट करें @project-manager फायदा "अधिक बुद्धिमत्ता" नहीं है। यह और मुख्य सत्र में संदर्भ प्रदूषण में कमी है। चिंताओं का पृथक्करण एक व्यावहारिक पैटर्न: मुख्य एजेंट कोड उत्पन्न करता है स्टॉप हुक समीक्षा का सुझाव देता है आप का उपयोग करते हैं @code-reviewer समीक्षक एक संरचित अंतर + सुधार सूची लौटाता है 8) पूर्ण प्रणाली: शासन + ज्ञान + प्रक्रिया + श्रम विभाजन यह एक वाक्य में आर्किटेक्चर है: हुक व्यवहार लागू करते हैं, स्किल्स मानक प्रदान करती हैं, कमांड वर्कफ़्लो को एन्कोड करती हैं, एजेंट समानांतर विशेषज्ञता को संभालते हैं। और हाँ, यह एक "सामान्य एआई सहायक" को "रिपॉजिटरी-नेटिव टीममेट" में बदलने का तरीका है। 9) न्यूनतम पुनरुत्पादनीय सेटअप (कॉपी-पेस्ट अनुकूल) यदि आप सबसे छोटा संस्करण चाहते हैं जो अभी भी काम करता है, तो इसे बनाएँ: .claude/ settings.json hooks/ skill-forced-eval.js pre-tool-use.js skills/ crud-development/ SKILL.md न्यूनतम (UserPromptSubmit हुक) settings.json { "hooks": { "UserPromptSubmit": [ { "matcher": "", "hooks": [ { "type": "command", "command": "node .claude/hooks/skill-forced-eval.js" } ] } ], "PreToolUse": [ { "matcher": "", "hooks": [ { "type": "command", "command": "node .claude/hooks/pre-tool-use.js" } ] } ] } } फिर पुनरावृति करें: SessionStart जोड़ें Stop जोड़ें बार-बार "गलत व्यवहार" पकड़ने पर ही स्किल्स बढ़ाएँ दोहराए जाने वाले वर्कफ़्लो को कमांड के रूप में एन्कोड करें समीक्षा/पीएम कार्यों को एजेंटों को ऑफ़लोड करें निष्कर्ष: "क्षमता" बाधा नहीं है — बाधा है सक्रियण आपका मॉडल पहले से ही सक्षम है। जो गायब है वह एक । प्रणाली है जो सही व्यवहार को स्वचालित बनाती है एक होशियार नया कर्मचारी बिना हैंडबुक के फ्रीस्टाइल करेगा। एक होशियार नया कर्मचारी जिसके पास: लागू की गई चेकलिस्ट स्पष्ट निषिद्ध पैटर्न दोहराए जाने वाले वर्कफ़्लो समीक्षा और पीएम के लिए विशेषज्ञ …तेजी से सुसंगत हो जाता है। Claude भी वैसा ही है।