/research-analysis
/research-analysis — يحلّل البيانات الخام وفق الخطة المُسجَّلة مسبقًا: الاختبارات المُخطَّطة، وأحجام الأثر بفترات الثقة، وفحوص المتانة، والانحرافات المُفصَح عنها.
الدور: الباحث الرئيسي (التحليل) الموضع في خط المعالجة: منتصف السلسلة
يحلّل البيانات الخام وفق الخطة المُسجَّلة مسبقًا — يُجري الاختبارات الإحصائية المُخطَّطة على وحدة التحليل المستقلّة، ويُبلّغ عن أحجام الأثر مع فترات الثقة (فترات المصداقية في ظلّ خطة بايزية؛ لا قيم p وحدها)، ويطبّق تصحيح المقارنات المتعدّدة حيث ينطبق، ويذكر كيف عولجت البيانات المفقودة، ويُجري فحوص المتانة / الحساسية، ويُفصِح عن كل انحراف عن التسجيل المسبق.
الاستدعاء المعياري
/research-analysisمع الوسائط:
/research-analysis [--suite-name NAME] [--override] [--correction METHOD] [--alpha LEVEL]المدخلات
البيانات الخام في الموضع الطبيعي للمضيف الذي سجّلته مرحلة التجربة، إضافةً إلى _inputs/preregistration.md (خطة التحليل المُجمَّدة).
المخرجات
_outputs/analysis.md (الاختبارات المُسجَّلة مسبقًا مع أحجام الأثر، وفترات الثقة، ووحدة التحليل، وحُكم تحيّز لكل مجال لكل نتيجة رئيسية؛ وتصحيح المقارنات المتعدّدة؛ ومعالجة البيانات المفقودة؛ وفحوص المتانة؛ والانحرافات المُفصَح عنها) ＋ الأشكال / الجداول في موضع طبيعي للمضيف.
المراحل اللاحقة
/research-paper (المستهلِك اللاحق)
مراحل سير العمل
يتّبع الأمر سير عمل خط معالجة /research القياسي:
- تحميل السياق — قراءة البيانات الخام والتسجيل المسبق.
- التحقّق من بوابة التسلسل — التأكّد من وجود مخرجات التجربة؛ وإلا التوقّف مع
Blocked: run /research-experiment first. - التحليل — تشغيل الاختبارات المُسجَّلة مسبقًا على وحدة التحليل المستقلّة؛ وتشخيص الافتراضات دون ترك التشخيصات تختار الاختبار؛ والإبلاغ عن أحجام الأثر ＋ فترات الثقة؛ وتصحيح المقارنات المتعدّدة؛ وذكر معالجة البيانات المفقودة؛ وإجراء فحوص المتانة / الحساسية.
- الإفصاح عن الانحرافات — تسجيل كل خروج عن الخطة المُسجَّلة مسبقًا. والانتقال إلى بديل يُسمّيه التسجيل المسبق يُدوَّن بوصفه تكيُّفًا مُخطَّطًا؛ وأيّ استبدال آخر انحراف.
- تحديث بيان التسليم — تسجيل مسار التحليل والأشكال / الجداول.
- إصدار التحليل —
_outputs/analysis.md＋ الأشكال / الجداول.
الانضباط الإحصائي
- الاختبار يتبع التصميم. يبقى الاختبار الرئيسي المُسجَّل مسبقًا قائمًا ما لم يُطلَق مُحفِّز البديل الذي يحدّده التسجيل المسبق نفسه؛ واختبار الفحص الذي يفشل في الرفض لا يُثبت أنّ افتراضًا ما متحقّق.
- يَعُدّ n الوحدات المستقلّة. تُجمَّع القياسات المتكرّرة والعيّنات الفرعية والعناقيد والبذور إلى مستوى الوحدة أو تُنمذَج بوصفها اعتمادًا، ولا تُعَدّ أبدًا تكرارات مستقلّة.
- النتيجة الصفرية تُقرأ بثلاث طرق. يُبلَّغ معًا عن فترة حجم الأثر، ونتيجة التكافؤ مقابل أصغر أثر ذي أهمية، وبيان الحساسية (أصغر أثر قابل للكشف عند n المُحلَّل المُتحقَّق). ولا يُبلَّغ أبدًا عن القوة المحسوبة من الأثر المرصود.
- الخطط البايزية بشروطها الخاصة. تُبلِغ الخطة البايزية المُسجَّلة مسبقًا عن ملخّص التوزيع اللاحق مع فترة المصداقية الخاصة به، وتُجري فحوص الحساسية للتوزيع المسبق، وتشخيص الحوسبة، والتنبّؤ اللاحق قبل الإبلاغ عن أيّ توزيع لاحق، وتستخدم منطقة تكافؤ عملي مُثبَّتة مسبقًا للنتائج الصفرية.
- التحيّز على مستوى النتيجة والأشكال. تحمل كلّ نتيجة رئيسية حُكمًا منخفضًا / بعض المخاوف / مرتفعًا لكل مجال، مُستمَدًّا من سجلّ التهديدات للصلاحية في التصميم ولا يُجمَع أبدًا في درجة واحدة، ويستوفي كلّ شكل الحدّ الأدنى للترميز والإفصاح عن عدم اليقين وإمكانية الوصول.
الحدّ الأدنى للصرامة
تُشغَّل طريقة عشوائية لا تقلّ عن ثلاثين تكرارًا مستقلًّا لكل مثيل أو شرط، وأكثر حين يكون التشتّت عبر التكرارات واسعًا قياسًا إلى الفروق محلّ الاختبار، حتى تستقرّ إحصاءات الملخّص. وتُبلَّغ نتائجها بوصفها الأفضل والمتوسّط والوسيط والانحراف المعياري والأسوأ عبر التكرارات، مع منحنيات التقارب ومخطّطات التوزيع. وتستخدم المقارنات اختبارات لا معلميّةً — اختبار الرتب المُوقَّعة المُزدوَج للمقارنة الثنائية، واختبار رتب شامل مع تصحيح بَعدِيّ عبر الطرائق — مُبلَّغًا عنها مع حجم أثر التفوّق العشوائي ومخطّط الفروق الحرجة. ولا تتقدّم نتيجةٌ إلى الورقة إلا حين تجتاز بوّابة التقدّم: أن تتفوّق على مُقارِناتها تفوّقًا مُقنِعًا وذا دلالة، وأن يُسجَّل هذا الاجتياز في سجلّ تشغيل قابل للتدقيق.
أنماط الفشل
| العَرَض | السبب | المعالجة |
|---|---|---|
| Blocked: run /research-experiment first | لا توجد بيانات خام | شغّل /research-experiment لإنتاج البيانات ＋ السجلّ |
| الإبلاغ عن قيمة p دون حجم الأثر | تقرير إحصائي غير مكتمل | بلِّغ عن أحجام الأثر ＋ فترات الثقة |
| مشاهدات معتمِدة عُدّت تكرارات | عوملت القياسات المتكرّرة أو العيّنات الفرعية أو العناقيد أو البذور بوصفها مستقلّة | اجمعها إلى مستوى الوحدة المستقلّة أو نمذِج الاعتماد؛ فـ n يَعُدّ الوحدات |
| الإبلاغ عن القوة المرصودة لنتيجة صفرية | حُسبت القوة من الأثر المرصود | احذفها؛ وبلِّغ عن الفترة ونتيجة التكافؤ وبيان الحساسية |
| انحراف تحليلي غير مُفصَح عنه | انحرفت الخطة بصمت | أفصِح عن الانحراف مقابل التسجيل المسبق |
أمثلة
# حلِّل البيانات الخام وفق الخطة المُسجَّلة مسبقًا
/research-analysis --suite-name my-studyالإحالات المرجعية
/research-experiment
/research-experiment — يُنفّذ الدراسة المُصمَّمة ويلتقط البيانات الخام بمنشأ كامل، إضافةً إلى بيان قابلية الإعادة (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).
/research-paper
/research-paper — يجمّع مسودة ورقة بحثية من الطراز الأول (من الملخّص حتى الخاتمة إضافةً إلى المراجع) انطلاقًا من التركيب والتصميم والتحليل، مع التحقّق من أنّ كل استشهاد قابل للحلّ.