improve

# improve — मजबूत मॉडल के साथ ऑडिट करें, सस्ते के साथ निष्पादित करें `improve` एक एजेंट स्किल (एजेंट स्किल्स प्रारूप) है जो किसी भी कोडबेस का ऑडिट करती है और अन्य एजेंटों के निष्पादन के लिए कार्यान्वयन योजनाएँ लिखती है। आधार: अपने सबसे सक्षम मॉडल को उस हिस्से पर खर्च करें जहाँ बुद्धिमत्ता संचित होती है — कोडबेस को समझना, यह तय करना कि क्या करने लायक है, स्पेक लिखना — और निष्पादन को सस्ते मॉडल को सौंपें। यह स्किल स्वयं कभी कुछ लागू नहीं करती; योजना ही उत्पाद है। ``` आप → /improve (महंगा मॉडल, सलाह देता है) plans/ → 001-fix-n-plus-one.md (स्व-निहित स्पेक्स) अन्य एजेंट → लागू करता है, परीक्षण करता है, जारी करता है (सस्ता मॉडल, निष्पादित करता है) ``` ## स्थापना ```bash npx skills add shadcn/improve ``` यह एजेंट स्किल्स प्रारूप का समर्थन करने वाले किसी भी एजेंट में काम करता है। योजनाएँ सादा मार्कडाउन हैं, इसलिए कोई भी एजेंट या मानव उन्हें उठा सकता है। ## कमांड - `/improve` — पूर्ण ऑडिट → प्राथमिकता वाले निष्कर्ष → योजनाएँ - `/improve quick` — सस्ता पास: हॉटस्पॉट, केवल शीर्ष निष्कर्ष - `/improve deep` — व्यापक: हर पैकेज, हर श्रेणी - `/improve security` — केंद्रित ऑडिट (प्रदर्शन, परीक्षण, बग, ... भी) - `/improve branch` — केवल वही ऑडिट करें जो वर्तमान शाखा बदलती है - `/improve next` — फीचर सुझाव, परियोजना को कहाँ ले जाना है - `/improve plan <विवरण>` — ऑडिट छोड़ें, एक चीज़ का स्पेक करें - `/improve review-plan <फ़ाइल>` — मौजूदा योजना की आलोचना करें और कसें - `/improve execute <योजना>` — सस्ता निष्पादक भेजें, उसके काम की समीक्षा करें - `/improve reconcile` — बैकलॉग ताज़ा करें: सत्यापित करें, अनब्लॉक करें, सेवानिवृत्त करें - `--issues` — योजनाओं को GitHub मुद्दों के रूप में भी प्रकाशित करें ## विशिष्ट पहली रन 1. रिपो में अपना एजेंट खोलें और `/improve` चलाएँ (या सस्ता रखने के लिए `/improve quick`)। 2. यह रिपो को मैप करता है, ऑडिट करता है, और एक निष्कर्ष तालिका लौटाता है। जिन्हें आप योजना बनाना चाहते हैं, उनके साथ उत्तर दें, जैसे "योजना 1, 3 और 5"। 3. योजनाएँ `plans/` में आती हैं — प्रत्येक एक फ़ाइल, साथ ही अनुशंसित क्रम के साथ एक सूचकांक। वे समीक्षा के लिए हैं। 4. किसी भी एजेंट को एक योजना सौंपें ("plans/001-*.md लागू करें"), या स्किल को चलने दें: `/improve execute 001` एक अलग वर्कट्री में एक सस्ता मॉडल भेजता है, योजना के खिलाफ अंतर की समीक्षा करता है, और एक निर्णय रिपोर्ट करता है। विलय आपके ऊपर रहता है। 5. अगले सत्र में, `/improve reconcile` बैकलॉग साफ करता है: सत्यापित करें क्या आया, ताज़ा करें क्या बह गया, अनब्लॉक करें क्या अटक गया। PR से पहले, `/improve branch` उसी प्रक्रिया को केवल शाखा के बदलावों तक सीमित करता है। ## यह कैसे काम करता है - **टोही।** रिपो को मैप करता है: स्टैक, परंपराएँ, और सटीक बिल्ड/टेस्ट/लिंट कमांड, जो हर योजना में सत्यापन द्वार बन जाते हैं। यह मौजूद होने पर इरादे और डिज़ाइन दस्तावेज़ भी लेता है — ADR (`docs/adr/`), PRD, `CONTEXT.md`, `DESIGN.md`, `PRODUCT.md` — ताकि तय किए गए ट्रेडऑफ़ फिर से चिह्नित न हों, दिशा सुझाव बताए गए उत्पाद इरादे में आधारित रहें, और योजनाएँ रिपो की अपनी शब्दावली का उपयोग करें। - **ऑडिट।** नौ श्रेणियों में समानांतर उप-एजेंट भेजता है: शुद्धता, सुरक्षा, प्रदर्शन, परीक्षण कवरेज, तकनीकी ऋण, निर्भरताएँ और माइग्रेशन, DX, दस्तावेज़, और दिशा (फीचर सुझावों को रिपो से ही साक्ष्य उद्धृत करना चाहिए)। हर निष्कर्ष में `file:line` साक्ष्य, प्रभाव, प्रयास, और आत्मविश्वास होता है। - **जाँच।** क्योंकि उप-एजेंट अति-रिपोर्ट करते हैं, सलाहकार कुछ भी दिखाने से पहले हर उद्धृत स्थान को फिर से पढ़ता है; झूठे सकारात्मक हटाए जाते हैं, गलत आरोप सुधारे जाते हैं, अस्वीकृतियाँ दर्ज की जाती हैं। - **प्राथमिकता।** निष्कर्ष लीवरेज (प्रभाव ÷ प्रयास, आत्मविश्वास से भारित) द्वारा क्रमबद्ध तालिका में आते हैं। आप चुनते हैं कि क्या योजनाएँ बनें। - **योजना।** `plans/` में चयनित निष्कर्ष प्रति एक फ़ाइल, सूचकांक, प्राथमिकता क्रम, और निर्भरता ग्राफ के साथ। ## योजनाओं को निष्पादन योग्य क्या बनाता है योजनाएँ सबसे कमजोर संभावित निष्पादक को लक्षित करती हैं — एक मॉडल जिसने सलाहकार सत्र कभी नहीं देखा और बहुत छोटा हो सकता है। तीन गुण इसे वहन करते हैं: - **स्व-निहित।** सभी संदर्भ इनलाइन हैं: सटीक फ़ाइल पथ, वर्तमान-स्थिति कोड अंश, एक उदाहरण फ़ाइल के साथ रिपो परंपराएँ, सत्यापित कमांड। कोई "जैसा ऊपर चर्चा की गई" नहीं। - **सत्यापन द्वार।** हर चरण एक कमांड और उसके अपेक्षित आउटपुट के साथ समाप्त होता है; पूर्ण मानदंड मशीन-जाँच योग्य हैं, इसलिए निष्पादक को सफलता का न्याय कभी नहीं करना पड़ता। - **कठोर सीमाएँ।** स्पष्ट दायरे-से-बाहर सूचियाँ और STOP शर्तें ("यदि X, रुकें और रिपोर्ट करें") छोटे मॉडल को योजना से वास्तविकता मेल न खाने पर सुधार करने देने के बजाय। प्रत्येक योजना उस git कमिट को स्टैम्प करती है जिसके खिलाफ लिखी गई थी, ताकि निष्पादक कुछ भी छूने से पहले यांत्रिक बहाव जाँच चला सकें। ## लूप बंद करना - **`execute <योजना>`** एक अलग git वर्कट्री में एक सस्ता निष्पादक उप-एजेंट उत्पन्न करता है, उसे योजना सौंपता है, फिर परिणाम की समीक्षा टेक लीड की तरह करता है — हर पूर्ण मानदंड फिर से चलाता है, दायरे अनुपालन की जाँच करता है, इरादे के खिलाफ अंतर पढ़ता है। निर्णय: स्वीकृत (विलय आपका कॉल है), संशोधन के लिए वापस (अधिकतम 2 राउंड), या ब्लॉक करें और योजना परिष्कृत करें। - **`reconcile`** तब से जो हुआ उसे संसाधित करता है: सत्यापित करता है कि DONE योजनाएँ अभी भी मान्य हैं, BLOCKED की जाँच करता है और बाधा के आसपास फिर से लिखता है, बह गई योजनाओं को ताज़ा करता है, स्वतंत्र रूप से तय किए गए निष्कर्षों को सेवानिवृत्त करता है। - **`--issues`** योजनाओं को उसी स्व-निहित निकाय के साथ GitHub मुद्दों के रूप में प्रकाशित करता है, ताकि कोई भी एजेंट या मानव उन्हें वहाँ उठा सके जहाँ काम पहले से रहता है। ## कठोर नियम - स्वयं स्रोत कोड कभी संशोधित नहीं करता। केवल लेखन `plans/` में जाता है; निष्पादक केवल डिस्पोजेबल वर्कट्री में संपादित करते हैं, और विलय हमेशा आपका होता है। - कार्यशील ट्री को बदलने वाले कमांड कभी नहीं चलाता — केवल पढ़ना, खोजना, और केवल-पढ़ने के लिए विश्लेषण। - गुप्त मान कभी पुन: उत्पन्न नहीं करता; केवल स्थान और क्रेडेंशियल प्रकार, रोटेशन हमेशा अनुशंसित। - लागू करने के लिए कहने पर, यह मना करता है और योजना की ओर इशारा करता है (या `execute` प्रदान करता है)। ## लाइसेंस MIT © shadcn