/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 | لا توجد خطة عمل معتمَدة | شغّل /research-proposal لإنتاج _inputs/proposal.md |
| تصميم ضعيف القوة | العيّنة أصغر من أن تلتقط الأثر | أعِد تشغيل تحليل القوة للتحليل المُخطَّط؛ أعِد تحجيم العيّنة، أو أبلِغ عن أصغر أثر قابل للكشف واذكر أنّ أصغر أثر ذي أهمية لا يملك قوة كافية |
| البنية متروكة للتحليل | الوحدة أو التخصيص أو التعمية أو ترتيب التشغيل غير مُثبَّت في التصميم | ثبِّتها في التصميم والتسجيل المسبق؛ فلا اختبار يُطبَّق لاحقًا يفصل التباسًا بناه التخطيط |
| تقدير سابق مُستخدَم أثرًا مستهدَفًا | أثرٌ مُبلَّغ عنه في دراسة واحدة يحلّ محلّ أصغر أثر ذي أهمية | رسِّخ الهدف في مقاييس النجاح في المواصفة؛ واستخدم الدراسة السابقة لحدّ النطاق فقط |
| خطة التحليل غير مُجمَّدة | تَخطِّي التسجيل المسبق | اكتب _inputs/preregistration.md قبل جمع البيانات |
أمثلة
# صمّم الدراسة وسجّل خطة التحليل مسبقًا
/research-design --suite-name <name>إحالات مرجعية
/research-proposal
/research-proposal — يحوّل الفجوة المُركَّبة والإطار النظري إلى خطة مرجعية قابلة للتمويل وللمراجعة: أهداف SMART، وسجلّ الجدوى والمخاطر مع خطط الطوارئ، ومسار الأثر، وخطة التسجيل المسبق، وخطة إدارة البيانات ومشاركتها، واختيار دليل الإبلاغ EQUATOR، إضافةً إلى مصفوفة متطلّبات لدعوة تمويل مُقدَّمة وردٍّ مستقلّ على إعادة التقديم — مرحلة المقترح في خط معالجة /research، بين /research-synthesis و/research-design.
/research-experiment
/research-experiment — يُنفّذ الدراسة المُصمَّمة ويلتقط البيانات الخام بمنشأ كامل، إضافةً إلى بيان قابلية الإعادة (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).