Skip to content
Apothem
أوامر خط الأنابيب

/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 القياسي:

  1. تحميل السياق — قراءة السؤال / الملاحظات، والقواعد، وأي حالة قائمة للحزمة.
  2. صياغة السؤال — التفكيك إلى فرضيات قابلة للدحض بنطاق صريح ومعايير تضمين / استبعاد؛ وإظهار كل التباس عبر قناة الاستفسار المُهيكَل.
  3. تحديد مقاييس النجاح — بيان المعايير القابلة للقياس التي سيُحكَم بها على البحث.
  4. التحقّق من المخرجات — التأكّد من أن المواصفة قاطعة (كل فجوة في بيانات السلطة قد حُلّت عبر قناة الاستفسار المُهيكَل، ولم يُترَك أيٌّ منها كعنصر نائب تأكيد غير معبّأ) وأنها تجتاز الحدّ الأدنى لتفويض الصرامة.
  5. تحديث بيان التسليم — تسجيل مسار المواصفة وأعداد الاستفسارات المفتوحة / المحلولة.
  6. إصدار المواصفة_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

الإحالات المرجعية

On this page