स्थानीयकृत पठन मार्गदर्शिका
writing-plansउद्देश्य, उपयोग और स्रोत
जब आपके पास किसी बहु-चरणीय कार्य के लिए विनिर्देश या आवश्यकताएं हों, तो कोड लिखने से पहले इसका उपयोग करें।
स्रोत प्राप्त किया गया:
- स्रोत रिपॉज़िटरी
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- रिपॉज़िटरी Star
- 309,479
- रिपॉज़िटरी का अंतिम अपडेट
- 2026-10-30
- क्षमता वर्गीकरण
- एजेंट वर्कफ़्लो
- अंतिम संग्रह समय
लाइसेंस: MIT
वर्कफ़्लो के अंश केवल पढ़ने में सहायता के लिए हैं, कोडेज़ से निष्पादन योग्य निर्देश नहीं हैं। इस पृष्ठ को बनाने के लिए किसी तृतीय-पक्ष स्किल का उपयोग नहीं किया गया है।
नीचे दिए गए उद्देश्य और कार्यप्रणाली संबंधी अंश प्रारंभिक सामग्री हैं, जिन्हें पढ़ने के लिए व्यवस्थित और अनुवादित किया गया है। ये अलग से लेबल किए गए कोडेज़ संपादकीय विश्लेषण से भिन्न हैं।
यह कौशल क्या करता है
जब आपके पास किसी बहु-चरणीय कार्य के लिए विनिर्देश या आवश्यकताएं हों, तो कोड लिखने से पहले इसका उपयोग करें।
अपस्ट्रीम वर्कफ़्लो कैसे काम करता है
अवलोकन
ऐसे इंजीनियर के लिए कार्यान्वयन योजनाएँ लिखें जिसने इस कोडबेस या इस स्पेसिफिकेशन को नहीं देखा है। मान लें कि सटीक इंटरफ़ेस और सटीक परीक्षण जानने के बाद वे प्रोजेक्ट की भाषा में स्वाभाविक कोड लिखेंगे, और योजना में जहां भी कोई विकल्प खुला छोड़ा गया है, वे उचित निर्णय लेंगे। उन्हें यह नहीं पता होना चाहिए कि आपने क्या तय किया है: कौन सी फ़ाइलें, कौन से नाम और हस्ताक्षर, स्पेसिफिकेशन से कौन से मान, कौन से परीक्षण प्रत्येक कार्य को सिद्ध करते हैं। इन सभी को दस्तावेज़ित करें। उन्हें पूरी योजना छोटे-छोटे कार्यों के रूप में दें। DRY (ड्राई राइटिंग), YAGNI (यग्नि डिलिवरेबल डेवलपमेंट) और TDD (टीडीडी) का उपयोग करें। बार-बार कमिट करें। शुरुआत में घोषणा करें: "मैं कार्यान्वयन योजना बनाने के लिए योजना लेखन कौशल का उपयोग कर रहा हूँ।" संदर्भ: यदि आप एक अलग वर्क ट्री में काम कर रहे हैं, तो इसे इसके माध्यम से बनाया जाना चाहिए था।superpowers:using-git-worktreesक्रियान्वयन के समय कुशल। योजनाओं को सहेजें:docs/superpowers/plans/YYYY-MM-DD-.md
चरण कणता
प्रत्येक चरण एक क्रिया है जिसका परिणाम जांचा जा सकता है: "असफल परीक्षण लिखें" - चरण "यह सुनिश्चित करने के लिए इसे चलाएँ कि यह असफल हो" - चरण "परीक्षण को सफल बनाने के लिए न्यूनतम कोड लागू करें" - चरण
ऊपर की ओर मार्ग · L43 ↗एक चरण में क्या शामिल है
किसी चरण को तब पूरा माना जाता है जब कार्यान्वयनकर्ता उससे केवल एक ही तर्कसंगत बात लिख सके। यही संपूर्ण आवश्यकता है: अस्पष्टता रहित, पूर्ण नहीं। प्रत्येक प्रकार के चरण में वह तत्व होता है जो उसे अस्पष्टता रहित बनाता है, और इससे अधिक कुछ नहीं: परीक्षण चरण: परीक्षण का नाम और उसके अभिकथन, कोड के रूप में, जिनमें विनिर्देश के सटीक मान होते हैं। कोड चरण: सटीक हस्ताक्षर (नाम, पैरामीटर, प्रतिफल प्रकार), वह फ़ाइल जिसमें यह मौजूद है, और विनिर्देश द्वारा निर्धारित विशिष्ट मान। कार्यान्वयनकर्ता मुख्य भाग लिखता है। मुख्य भाग केवल ऐसे एल्गोरिदम के लिए प्रकट होता है जिसका हस्ताक्षर और परीक्षण निर्धारण नहीं करते, या विनिर्देश द्वारा निर्धारित सटीक प्रतिलिपि के लिए। सत्यापन चरण: चलाने के लिए कमांड और वह आउटपुट जो परीक्षण के सफल होने का संकेत देता है।
ऊपर की ओर मार्ग · L140 ↗आवश्यकताएँ और सेटअप
इस फ़ाइल से कोई संक्षिप्त आवश्यकताएँ नहीं चुनी गईं। इसका मतलब यह नहीं है कि स्किल की कोई निर्भरता नहीं है। रिपॉजिटरी सेटअप निर्देशों और संदर्भित फ़ाइलों की जाँच करें।
सीमाएं और गुणवत्ता जांच
इस फ़ाइल से कोई अलग सीमा अंश नहीं चुना गया है। इसका मतलब यह नहीं है कि यह स्किल हर इनपुट या वातावरण के लिए सुरक्षित है। संपूर्ण स्रोत की समीक्षा करें और अपने परिणाम की पुष्टि करें।
सुरक्षित परीक्षण से शुरुआत करें
- समर्थित होस्ट और रिपॉजिटरी इंस्टॉलेशन निर्देशों की जाँच करें। स्किल डायरेक्टरी और उससे संबंधित स्क्रिप्ट, एसेट्स और डॉक्यूमेंटेशन को एक साथ रखें;SKILL.mdअकेले होने पर निर्भरताओं को छोड़ा जा सकता है।
- एजेंट को अपना वास्तविक इनपुट, अपेक्षित आउटपुट और स्वीकृति मानदंड प्रदान करें। इनवोकेशन सिंटैक्स और उपलब्ध उपकरण होस्ट पर निर्भर करते हैं; यह साइट किसी सार्वभौमिक इंस्टॉलेशन कमांड को नहीं मानती है।
- डिस्पोजेबल प्रोजेक्ट या उसकी कॉपी पर मूल वर्कफ़्लो को आज़माएँ। फ़ाइलों, रिमोट सेवाओं या बिल योग्य संसाधनों में परिवर्तन करने वाले कार्यों की अनुमति देने से पहले उनकी समीक्षा करें।
- स्रोत गुणवत्ता जांच और अपनी आवश्यकताओं के आधार पर आउटपुट को सत्यापित करें। सफल ट्रिगर या उच्च रिपॉजिटरी स्टार संख्या सही परिणाम की गारंटी नहीं देते।
मूल लेख में आगे पढ़ें
सम्बंधित योग्यता
अनुवाद और दायरा
यह पठन मार्गदर्शिका ऊपर पिन किए गए अंशों में से चयनित अंशों को प्रस्तुत करती है।SKILL.mdयह अनुवाद सहायता से किया गया है। यह कोई संपूर्ण नियमावली या परीक्षित संगतता का दावा नहीं है। उपयोग करने से पहले मूल दस्तावेज़ और उससे संबंधित फ़ाइलों को पढ़ें।
यह परिचय नीचे पिन किए गए संस्करण को संदर्भित करता है; वर्तमान रिपॉजिटरी गतिविधि और संग्रह समय अलग से दिखाए गए हैं।
- पिन किया गया स्रोत
- मूल लेख पढ़ें ↗
- स्रोत प्राप्त किया गया
- स्रोत कमिट
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- स्रोत SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a