/research-spec
/research-spec — يصوغ سؤال بحث حُرّ الصياغة أو ملاحظات خامًا في مواصفة بحثية بمستوى المواصفة (فرضيات قابلة للدحض، ونطاق، ومعايير، ومقاييس نجاح) جاهزة لـ /research-theory.
الدور: الباحث الرئيسي (الصياغة) الموضع في خط المعالجة: منتصف السلسلة
يصوغ سؤال بحث حُرّ الصياغة أو ملاحظات خامًا في _spec/research-spec.md بمستوى المواصفة — مجموعة فرضيات قابلة للاختبار والدحض بنطاق صريح، ومعايير تضمين / استبعاد، ومقاييس نجاح — جاهزة لـ /research-theory.
الاستدعاء المعياري
/research-specمع الوسائط:
/research-spec [path/to/question-or-notes] [--suite-name NAME] [--quick SLUG]المدخلات
سؤال بحث حُرّ الصياغة أو ملاحظات خام (يقدّمها المُشغِّل ضمن السطر أو كمسار).
المخرجات
_spec/research-spec.md (السؤال، والفرضيات القابلة للدحض، والنطاق، ومعايير التضمين / الاستبعاد، ومقاييس النجاح، والمسرد) + _inputs/handoff-manifest.yml. أمّا --quick فيكتب بدلًا من ذلك موجزًا بحثيًّا خفيفًا محليًّا للمشروع.
المراحل اللاحقة
/research-theory (المستهلِك اللاحق)
مراحل سير العمل
يتّبع الأمر سير عمل خط معالجة /research القياسي:
- تحميل السياق — قراءة السؤال / الملاحظات، والقواعد، وأي حالة قائمة للحزمة.
- صياغة السؤال — التفكيك إلى فرضيات قابلة للدحض بنطاق صريح ومعايير تضمين / استبعاد؛ وإظهار كل التباس عبر قناة الاستفسار المُهيكَل.
- تحديد مقاييس النجاح — بيان المعايير القابلة للقياس التي سيُحكَم بها على البحث.
- التحقّق من المخرجات — التأكّد من أن المواصفة قاطعة (كل فجوة في بيانات السلطة قد حُلّت عبر قناة الاستفسار المُهيكَل، ولم يُترَك أيٌّ منها كعنصر نائب تأكيد غير معبّأ) وأنها تجتاز الحدّ الأدنى لتفويض الصرامة.
- تحديث بيان التسليم — تسجيل مسار المواصفة وأعداد الاستفسارات المفتوحة / المحلولة.
- إصدار المواصفة —
_spec/research-spec.mdإضافةً إلى بيان التسليم.
الحدّ الأدنى للصرامة
يُقيَّد كلُّ إسهام مُدَّعى بأن يكون متمايزًا وجوهريًّا وقابلًا للاستئصال باستقلالية، حتى يمكن عزل أثره الحدّي لاحقًا. ويتناسب عمقُ الحدّ الأدنى للصرامة المطلوب مع طموح جهة النشر المستهدَفة؛ وحيثما لم يُحدَّد ذلك الطموح جرى تأكيده عبر الاستفسار المُهيكَل، ولا يُختلَق أبدًا.
أنماط الفشل
| العَرَض | السبب | المعالجة |
|---|---|---|
| التباس فرضية غير محلول | السؤال غير محدّد بدقة كافية | الإظهار عبر الاستفسار المُهيكَل؛ لا تختلق نطاقًا |
| لا يوجد مقياس نجاح قابل للقياس | الهدف مذكور كنشاط لا كنتيجة | إعادة الصياغة كنتيجة قابلة للاختبار والدحض |
| مدخل السؤال مفقود | لم يُقدَّم نصّ / ملاحظات | قدِّم سؤال البحث ضمن السطر أو كمسار |
أمثلة
# Frame a question into a research spec
/research-spec ~/notes/retrieval-latency-study.md --suite-name retrieval-latency
# Lightweight project-local research brief
/research-spec --quick retrieval-latencyالإحالات المرجعية
/research-ideate
/research-ideate — يصوغ فضاء المشكلة انطلاقًا من بذرة مجال: مسحُ الفرص والثغرات، ومسحُ الفرضيات السابقة المُبطَلة، وتوليدُ أسئلة بحثية مرشَّحة مُرتَّبة — المرحلة الرأسية لخط أنابيب /research، التي تُغذّي /research-spec.
/research-theory
/research-theory — يبني الإطار المفاهيمي والنظري لسؤال بحثي مُؤطَّر: نظرية التغيير، والبُنى مع تعريفاتها الإجرائية، ومخطّط نموذج مفاهيمي — مرحلة التأسيس النظري في خط أنابيب /research، بين /research-spec و/research-sources.