/research-design
/research-design — परिकल्पनाओं को परीक्षण-योग्य पूर्वानुमानों में परिचालित करता है और अध्ययन डिज़ाइन करता है (चर, नियंत्रण, नमूना, सामर्थ्य), फिर विश्लेषण योजना को एक पूर्व-पंजीकरण के रूप में जमा देता है।
भूमिका: प्रधान अन्वेषक (अध्ययन डिज़ाइन) पाइपलाइन स्थिति: शृंखला-मध्य
परिकल्पनाओं को परीक्षण-योग्य पूर्वानुमानों में परिचालित करता है और अध्ययन या प्रयोग डिज़ाइन करता है — चर, नियंत्रण स्थितियाँ, प्रायोगिक इकाई, आवंटन और मास्किंग, नमूना, उपकरण, सामर्थ्य विश्लेषण, वैधता के लिए ख़तरे — फिर एक पूर्व-पंजीकरण तैयार करता है जो डेटा संग्रह से पहले विश्लेषण योजना को जमा देता है।
विहित आह्वान
/research-designतर्कों के साथ:
/research-design [--suite-name NAME]इनपुट
_inputs/proposal.md (/research-proposal, पूर्ववर्ती चरण, से योजना-अभिलेख), _inputs/synthesis.md (SOTA मानचित्र + अंतराल कथन), और _spec/research-spec.md (परिकल्पनाएँ)।
आउटपुट
_inputs/study-design.md (परिचालित पूर्वानुमान, चर विनिर्देश, नियंत्रण स्थितियाँ, प्रायोगिक इकाई, आवंटन और मास्किंग योजना, नमूना, उपकरण, सामर्थ्य विश्लेषण, वैधता के लिए ख़तरे) + _inputs/preregistration.md (जमा की गई विश्लेषण योजना, जिसमें उनके उत्तीर्णता मानदंडों सहित नियंत्रण स्थितियाँ, आवंटन और मास्किंग योजना, अनुपस्थित-परिणाम प्रबंधन, और कोई भी अंतरिम अवलोकन शामिल हैं)।
अनुप्रवाह
/research-experiment (अनुप्रवाह उपभोक्ता)
वर्कफ़्लो चरण
यह कमांड मानक /research पाइपलाइन वर्कफ़्लो का पालन करता है:
- संदर्भ लोड करें — संश्लेषण और विनिर्देश की परिकल्पनाओं को पढ़ें।
- अनुक्रम गेट सत्यापित करें — पुष्टि करें कि
_inputs/proposal.md(और अपस्ट्रीम_inputs/synthesis.mdतथा_spec/research-spec.md) मौजूद है; अन्यथाBlocked: run /research-proposal firstके साथ रुकें। - अध्ययन डिज़ाइन करें — पूर्वानुमानों को परिचालित करें; चर, नियंत्रण स्थितियाँ, और उपकरण निर्दिष्ट करें; प्रायोगिक इकाई, सीडेड आवंटन, मास्किंग योजना, और रन क्रम तय करें; नियोजित विश्लेषण के लिए नमूने का आकार निर्धारित करें; वैधता के लिए ख़तरों की गणना करें।
- पूर्व-पंजीकरण करें — किसी भी डेटा संग्रह से पहले विश्लेषण योजना, नियंत्रण स्थितियों, आवंटन, और मास्किंग को जमा दें।
- हैंडऑफ़ मेनिफ़ेस्ट अपडेट करें — अध्ययन-डिज़ाइन और पूर्व-पंजीकरण के पथ रिकॉर्ड करें।
- डिज़ाइन उत्सर्जित करें —
_inputs/study-design.md+_inputs/preregistration.md।
संरचना और आकार-निर्धारण
- संरचना डिज़ाइन में तय होती है, विश्लेषण में नहीं। डिज़ाइन प्रायोगिक इकाई और विश्लेषण की इकाई, उसकी सीडेड अनुसूची सहित आवंटन प्रक्रिया और, जब इकाइयाँ एक के बाद एक नामांकित होती हैं, उसका प्रच्छादन, किसे मास्क किया गया है (या मास्किंग क्यों अव्यवहार्य है), बाधक कारक और प्रत्येक को कैसे ब्लॉक, यादृच्छिक, या स्थिर रखा गया है, और रन क्रम को नामित करता है। यह तुलनाकर्ता और उन सकारात्मक तथा नकारात्मक नियंत्रणों की योजना बनाता है जिन्हें प्रयोग निष्पादित करेगा। जमाव के बाद जोड़ा गया नियंत्रण एक प्रकटित विचलन है।
- एक-कारक स्वीप अन्योन्यक्रिया नहीं दिखा सकते। जहाँ अवयवों या पैरामीटरों के अन्योन्यक्रिया करने का संदेह हो, डिज़ाइन संदिग्ध समुच्चय पर एक संयुक्त विन्यास जोड़ता है और जिस अन्योन्यक्रिया का वह दावा करता है उसे पूर्व-पंजीकृत करता है।
- रुचि का सबसे छोटा प्रभाव विनिर्देश से आता है। यह विनिर्देश के सफलता मीट्रिक या संश्लेषण द्वारा आधारित किसी व्यावहारिक-सार्थकता सीमा तक अनुरेखित होता है। किसी पूर्व अध्ययन का रिपोर्ट किया गया प्रभाव संभाव्य परास को सीमित करता है और कभी भी रुचि के सबसे छोटे प्रभाव का स्थान नहीं लेता।
- उस विश्लेषण के लिए आकार दें जो चलेगा। प्रत्येक प्राथमिक दावे का लक्ष्य (श्रेष्ठता, गैर-हीनता, या तुल्यता) और पक्षता डिज़ाइन में तय होते हैं, और प्रत्येक को उसके अपने रुचि के सबसे छोटे प्रभाव पर उस प्रति-परीक्षण सीमा पर सामर्थ्य दिया जाता है जो घोषित सुधार छोड़ता है। आवश्यक N को संभाव्य प्रभाव के पार एक परास के रूप में रिपोर्ट किया जाता है; जब व्यवहार्यता N को सीमित करती है, तो उस N पर सबसे छोटा पता लगाने योग्य प्रभाव रिपोर्ट किया जाता है और रुचि के सबसे छोटे प्रभाव को सामर्थ्य-रहित बताया जाता है।
- छूट और सिमुलेशन। N स्वतंत्र इकाइयों को गिनता है और समूह-भीतरी सहसंबंध के लिए बढ़ाया जाता है; संग्रह लक्ष्य एक दर्ज हानि दर के माध्यम से विश्लेषित N से आता है। जहाँ कोई बंद रूप नियोजित विश्लेषण से मेल नहीं खाता, सामर्थ्य का अनुमान सिमुलेशन द्वारा लगाया जाता है जिसमें उपकरण, संस्करण, सीड, और मोंटे कार्लो त्रुटि दर्ज की जाती है, और एक अनुक्रमिक नियम पूर्व-पंजीकरण में अपने अवलोकनों की संख्या और सीमा तय करता है।
कठोरता की निचली सीमा
तुलना-वहनकारी अध्ययन के लिए डिज़ाइन आनुभविक निचली सीमा को तय करता है और पूर्व-पंजीकृत करता है: सभी तुलित विधियों में एक एकीकृत बजट (समान वॉल-क्लॉक और, जहाँ सार्थक हो, समान मूल्यांकन गणना), स्टोकैस्टिक विधियों के लिए प्रति इंस्टेंस कम से कम तीस पुनरावृत्तियाँ, एक ऐब्लेशन कारक जो एक बार में एक अवयव को अक्षम करता है, प्रत्येक पैरामीटर पर संवेदनशीलता स्वीप, और एक असंयुक्त परीक्षण विभाजन पर मूल्यांकित प्रशिक्षण विभाजन पर स्वचालित संरूपण। निचली सीमा की गहराई लक्ष्य-प्रकाशन-स्थल की महत्वाकांक्षा के अनुरूप बढ़ती है।
विफलता विधाएँ
| लक्षण | कारण | पुनर्प्राप्ति |
|---|---|---|
| Blocked: run /research-proposal first | कोई योजना-अभिलेख नहीं | _inputs/proposal.md उत्पन्न करने के लिए /research-proposal चलाएँ |
| अपर्याप्त सामर्थ्य वाला डिज़ाइन | प्रभाव के लिए नमूना बहुत छोटा | नियोजित विश्लेषण के लिए सामर्थ्य विश्लेषण फिर से चलाएँ; नमूने का आकार बदलें, या सबसे छोटा पता लगाने योग्य प्रभाव रिपोर्ट करें और बताएँ कि रुचि के सबसे छोटे प्रभाव को सामर्थ्य नहीं दिया गया है |
| संरचना विश्लेषण पर छोड़ी गई | इकाई, आवंटन, मास्किंग, या रन क्रम डिज़ाइन में तय नहीं | उन्हें डिज़ाइन और पूर्व-पंजीकरण में तय करें; बाद में लागू किया गया कोई भी परीक्षण विन्यास द्वारा निर्मित किसी भ्रामक कारक को अलग नहीं करता |
| पूर्व अनुमान को लक्ष्य प्रभाव के रूप में उपयोग किया गया | किसी एकल अध्ययन का रिपोर्ट किया गया प्रभाव रुचि के सबसे छोटे प्रभाव का स्थान लेता है | लक्ष्य को विनिर्देश के सफलता मीट्रिक पर आधारित करें; पूर्व अध्ययन का उपयोग केवल परास को सीमित करने के लिए करें |
| विश्लेषण योजना जमा नहीं | पूर्व-पंजीकरण छोड़ा गया | डेटा संग्रह से पहले _inputs/preregistration.md रचें |
उदाहरण
# अध्ययन डिज़ाइन करें और विश्लेषण योजना का पूर्व-पंजीकरण करें
/research-design --suite-name <name>पार-संदर्भ
/research-proposal
/research-proposal — संश्लेषित अंतराल और सैद्धांतिक ढाँचे को एक वित्तपोषण-योग्य, समीक्षा-योग्य संदर्भ योजना में बदलता है: SMART लक्ष्य, आकस्मिक योजनाओं सहित व्यवहार्यता और जोखिम रजिस्टर, प्रभाव मार्ग, पूर्व-पंजीकरण योजना, डेटा प्रबंधन और साझाकरण योजना, और EQUATOR रिपोर्टिंग दिशानिर्देश चयन, साथ ही दी गई वित्तपोषक कॉल के लिए एक आवश्यकता मैट्रिक्स और एक स्वतंत्र पुनर्प्रस्तुति उत्तर — /research पाइपलाइन का प्रस्ताव चरण, /research-synthesis और /research-design के बीच।
/research-experiment
/research-experiment — डिज़ाइन किए गए अध्ययन को निष्पादित करता है और पूर्ण उद्गम के साथ कच्चा डेटा कैप्चर करता है, साथ ही एक पुनरुत्पादनीयता मैनिफ़ेस्ट (एनवायरनमेंट, सीड, प्रोटोकॉल, वर्शन पिन)।