/research-experiment
/research-experiment — يُنفّذ الدراسة المُصمَّمة ويلتقط البيانات الخام بمنشأ كامل، إضافةً إلى بيان قابلية الإعادة (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).
الدور: الباحث الرئيسي (التنفيذ) الموضع في خط الأنابيب: منتصف السلسلة
يُنفّذ الدراسة أو التجربة المُصمَّمة ويلتقط البيانات الخام بمنشأ كامل. يضمن قابلية الإعادة: يسجّل البيئة والبذرة وسجلّ البروتوكول وتثبيت الإصدارات حتى يتمكّن طرف مستقل من إعادة التشغيل.
الاستدعاء المعياري
/research-experimentمع وسائط:
/research-experiment [--suite-name NAME]المدخلات
_inputs/study-design.md (التصميم) و_inputs/preregistration.md (خطة التحليل المُجمَّدة).
المخرجات
_outputs/experiment-log.md (أثر البروتوكول المختوم زمنيًا، إضافةً إلى سجلّ الإغلاق لحملة مستقلّة)، والبيانات الخام في موقع طبيعي للمضيف، و_outputs/reproducibility-manifest.md (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).
في المصبّ
/research-analysis (المستهلك في المصبّ)
مراحل سير العمل
يتبع الأمر سير عمل خط أنابيب /research المعياري:
- تحميل السياق — قراءة تصميم الدراسة والتسجيل المسبق.
- التحقّق من بوّابة التسلسل — تأكيد وجود
_inputs/study-design.md؛ وإلا فالتوقّف برسالةBlocked: run /research-design first. - التشغيل والتسجيل — تنفيذ البروتوكول؛ التقاط البيانات الخام بمنشأها؛ تسجيل أثر البروتوكول المختوم زمنيًا.
- التقاط قابلية الإعادة — تسجيل البيئة والبذرة والبروتوكول وتثبيت الإصدارات.
- تحديث بيان التسليم — تسجيل موقع البيانات وبيان قابلية الإعادة.
- إصدار السجلّ —
_outputs/experiment-log.md+ البيانات الخام +_outputs/reproducibility-manifest.md.
الحدّ الأدنى للصرامة
يُجري التنفيذُ تمريرة تجريبية استطلاعية لمعايرة الميزانيات والنطاقات، ثم المقارنة الكاملة تحت خطّة مُعلَنة لاستغلال الحوسبة (توزيع الأنوية، وسقوف الذاكرة، والتوازي الآمن للتكرارات المستقلّة). وتُشغّل كلُّ طريقة عشوائية نظامَ تكرارها المُسجَّل مسبقًا مع بذور مُسجَّلة وعتاد مُوثَّق. وتتوفّر حلقةُ تجربة مستقلّة اختيارية معطَّلة افتراضيًّا. فمقابل مِطواعٍ (harness) مُجمَّد، تقترح تغييرًا على هدف واحد قابل للتحوير، وتذكر تنبّؤًا قابلًا للتفنيد قبل كلّ تشغيل، وتشغّله بالميزانية المُثبَّتة. ويُقرأ المقياس الرئيسي من سجلّ التشغيل بوصفه إشارتين: إشارة بحث توجّه الحلقة، وإشارة قبول من مجموعة منفصلة، تؤكّد التغيير أو ترفضه قبل الاحتفاظ به: إذ يجب أن يجتاز التغيير مرحلة البحث، ثم يتفوّق على القائم في القبول بأكثر من هامش الضجيج المُعلَن (أو يعادله مع تقليل التعقيد). وتُدوَّن كلّ تجربة في اليوميّات، ويُعَدّ كلّ استعلام قبول ويُفصَح عنه.
تُقيَّم مجموعة نهائية لم تُمَسّ مرّةً واحدة، عند الإغلاق. والحملة التي لا تملك مثلها تَسِم نتيجتها بأنها ملوّثة بالاختيار واستكشافية، وأيّ رقم تُبلِغ عنه الحملة يُعاد قياسه وفق نظام التكرار أعلاه. ويؤكّد المُشغِّل الهدف، والمِطواع، والمقياس، ومجموعات التقييم، وقاعدة القبول، والميزانية، ومساحة العمل مرّةً واحدة، ويجوز له تثبيت معايير التوقّف؛ وعند التوقّف، يدخل سجلّ الإغلاق (أعداد التجارب، والاحتفاظ، والاستبعاد، والأعطال، واستعلامات القبول، والمكسب مقارنةً بخط الأساس، ونتيجة المجموعة التي لم تُمَسّ) في سجلّ التجربة حتى تتمكّن مرحلة التحليل من تصنيف النتيجة التي اختارتها الحلقة.
أنماط الفشل
| العَرَض | السبب | الاسترداد |
|---|---|---|
| Blocked: run /research-design first | لا يوجد تصميم للدراسة | شغّل /research-design لإنتاج _inputs/study-design.md |
| التشغيل غير قابل للإعادة | سجلّ البذرة / البيئة مفقود | سجّل بيان قابلية الإعادة الكامل قبل المتابعة |
| انحراف البروتوكول غير موثّق | تغيير في أثناء التشغيل لم يُسجَّل | سجّل الانحراف في سجلّ التجربة؛ وأفصِح عنه عند التحليل |
| نتيجة الحلقة مقدَّمة بوصفها تأكيدية | وجّهت الحلقة نفسها بناءً على مجموعة القبول، أو لم تُقرأ أيّ مجموعة لم تُمَسّ عند الإغلاق | سِم النتيجة بأنها ملوّثة بالاختيار واستكشافية؛ فإشارة البحث توجّه، وإشارة القبول تقرّر، والمجموعة التي لم تُمَسّ تُقرأ مرّةً واحدة |
أمثلة
# شغّل الدراسة المُصمَّمة والتقط بيانات خام قابلة للإعادة
/research-experiment --suite-name <name>إحالات مرجعية
/research-design
/research-design — يُحوّل الفرضيات إلى تنبؤات قابلة للاختبار ويُصمّم الدراسة (المتغيّرات، الضوابط، العيّنة، القوة)، ثم يُجمِّد خطة التحليل بوصفها تسجيلًا مسبقًا.
/research-analysis
/research-analysis — يحلّل البيانات الخام وفق الخطة المُسجَّلة مسبقًا: الاختبارات المُخطَّطة، وأحجام الأثر بفترات الثقة، وفحوص المتانة، والانحرافات المُفصَح عنها.