مسرد المصطلحات

كل مصطلح في OpenSpec في مكان واحد، مُعرّف بلغة بسيطة. ألقِ نظرة سريعة عليه وستقرأ بقية الوثائق بسرعة أكبر.

تُجمّع المصطلحات حسب الموضوع، ثم تُرتب أبجدياً داخل كل مجموعة.

الأسماء الأساسية

المواصفة (Spec). وثيقة تصف كيفية تصرف جزء من نظامك. تعيش المواصفات في مجلد openspec/specs/، وهي منظمة حسب المجال، وتتكون من متطلبات وسيناريوهات. تمثل المواصفة الإجابة المتفق عليها على السؤال: "ماذا يفعل هذا البرنامج؟". انظر المفاهيم.

مصدر الحقيقة. المجلد openspec/specs/ ككل. يحتفظ بسلوك نظامك الحالي والمتفق عليه. تقترح التغييرات تعديلات عليه؛ ويتم تطبيقها عبر الأرشفة.

التغيير (Change). وحدة عمل واحدة، مغلفة كمجلد تحت openspec/changes/<name>/. يحمل التغيير كل شيء يتعلق بذلك العمل: مقترحه، وتصميمه، ومهامه، وتعديلات المواصفات التي يقدمها. تغيير واحد لكل ميزة أو إصلاح.

الأثر (Artifact). وثيقة داخل تغيير. الآثار القياسية هي المقترح، ومواصفات الدلتا، والتصميم، والمهام. يتم إنشاؤها حسب ترتيب الاعتماديات وتتغذى إحداها بالأخرى.

مواصفة الدلتا (Delta spec). مواصفة داخل تغيير تصف فقط ما يتغير، باستخدام أقسام ADDED و MODIFIED و REMOVED، بدلاً من إعادة ذكر المواصفة بالكامل. هذا هو ما يسمح لـ OpenSpec بتعديل الأنظمة الحالية بنظافة. انظر المفاهيم.

المجال (Domain). تجميع منطقي للمواصفات، مثل auth/ أو payments/ أو ui/. تختار المجالات التي تتوافق مع طريقة تفكيرك في نظامك.

داخل المواصفة

المتطلب (Requirement). سلوك واحد يجب أن يمتلكه النظام، يُكتب عادةً بكلمة مفتاحية من RFC 2119: "يجب على النظام إنهاء الجلسات بعد 30 دقيقة". تحدد المتطلبات ماذا وليس كيف.

السيناريو (Scenario). مثال ملموس وقابل للاختبار لمتطلب أثناء التنفيذ، عادةً بصيغة Given/When/Then. تجعل السيناريوهات المتطلب قابلاً للتحقق: يمكنك كتابة اختبار آلي منه.

كلمات RFC 2119 المفتاحية. الكلمات MUST و SHALL و SHOULD و MAY، والتي تحمل معنى موحداً حول مدى صرامة المتطلب. MUST و SHALL مطلقة. SHOULD موصى به مع وجود مجال للاستثناءات. MAY اختياري. يأتي الاسم من وثيقة معايير الإنترنت التي عرّفتها.

الآثار

المقترح (proposal.md). الـ لماذا والـ ماذا للتغيير: نيته، ونطاقه، والنهج عالي المستوى. وهو أول أثر تقوم بإنشائه.

التصميم (design.md). الـ كيف: النهج التقني، وقرارات الهندسة المعمارية، والملفات التي تتوقع لمسها. اختياري للتغييرات البسيطة.

المهام (tasks.md). قائمة مراجعة للتنفيذ، مع مربعات اختيار. يعمل الذكاء الاصطناعي خلالها خلال /opsx:apply ويحدد العناصر كمنجزة أثناء تنقله فيها.

دورة الحياة

الأرشفة (Archive). فعل إنهاء تغيير. تندمج مواصفات الدلتا الخاصة به ضمن المواصفات الرئيسية، وينتقل مجلد التغيير إلى openspec/changes/archive/YYYY-MM-DD-<name>/. بعد الأرشفة، تصف مواصفاتك الواقع الجديد. انظر المفاهيم.

المزامنة (Sync). دمج مواصفات الدلتا الخاصة بالتغيير ضمن المواصفات الرئيسية بدون أرشفة التغيير. يحدث تلقائياً عادةً (يقدم الأرشفة القيام بذلك)، لكنه متاح بشكل مستقل كأمر /opsx:sync للتغييرات طويلة الأمد. انظر الأوامر.

سير العمل والأوامر

OPSX. سير عمل OpenSpec القياسي الحالي، مبني حول إجراءات سائلة بدلاً من مراحل جامدة. جميع أوامره الشريطية تبدأ بـ /opsx:. انظر سير عمل OPSX.

الأمر الشريطي (Slash command). أمر تكتبه في دردشة مساعد الذكاء الاصطناعي الخاص بك، مثل /opsx:propose. تقود الأوامر الشريطية سير العمل. ليست أوامر طرفية (terminal commands). انظر كيف تعمل الأوامر.

استكشاف (/opsx:explore). أمر شريك التفكير. يقرأ قاعدة الكود الخاصة بك، ويقارن الخيارات، ويوضح فكرة غامضة إلى خطة ملموسة، دون إنشاء آثار أو كتابة كود. نقطة البداية الموصى بها كلما كان لديك مشكلة ولكن ليس لديك خطة بعد. انظر استكشف أولاً.

واجهة سطر الأوامر (CLI). برنامج openspec الذي تشغله في طرفيتك. يقوم بإعداد المشاريع، وعرض التغييرات والتحقق منها، وفتح لوحة التحكم، وأرشفتها. النصف الطرفي لـ OpenSpec. انظر CLI.

مهارة (Skill). مجلد يحتوي على تعليمات (.../skills/openspec-*/SKILL.md) يكتشفها مساعد الذكاء الاصطناعي تلقائياً ويتبعها. المهارات هي المعيار الناشئ عبر الأدوات لتوصيل سير عمل OpenSpec إلى مساعدك.

ملف الأمر (Command file). ملف أمر شريطي خاص بكل أداة (.../commands/opsx-*). آلية التوصيل الأقدم، لا تزال مدعومة جنباً إلى جنب مع المهارات. نادراً ما تتعامل معها مباشرة.

الملف الشخصي (Profile). مجموعة الأوامر الشريطية المثبتة في مشروعك. الجوهري (الافتراضي) هو propose و explore و apply و update و sync و archive. المجموعة الموسعة تضيف new و continue و ff و verify و bulk-archive و onboard. قم بتغييره باستخدام openspec config profile.

التوصيل (Delivery). سواء كان OpenSpec يثبت مهارات أو ملفات أوامر أو كليهما لأدواتك. يتم تكوينه عالمياً ويُطبق باستخدام openspec update.

التخصيص

المخطط (Schema). تعريف الآثار التي يمتلكها سير العمل وكيفية اعتمادها على بعضها البعض. الافتراضي المدمج هو spec-driven (مقترح → مواصفات → تصميم → مهام). يمكنك استنساخه أو كتابة مخططك الخاص. انظر التخصيص.

القالب (Template). ملف Markdown داخل مخطط يشكل ما يولده الذكاء الاصطناعي لأثر معين. يؤدي تعديل قالب إلى تغيير إخراج الذكاء الاصطناعي فوراً، بدون إعادة بناء.

تكوين المشروع (openspec/config.yaml). إعدادات خاصة بالمشاريع: المخطط الافتراضي، و context: المُحقن في كل طلب تخطيط، و rules: الخاصة بكل أثر. أسهل طريقة لتعليم OpenSpec حول مجموعتك التقنية واتفاقياتك. انظر التخصيص.

حقن السياق (Context injection). وضع خلفية المشروع في حقل context: في config.yaml بحيث تتم إضافتها تلقائياً إلى كل أثر يولده الذكاء الاصطناعي. أكثر موثوقية من أمل قراءة الذكاء الاصطناعي لملف منفصل.

رسم الاعتماديات (Dependency graph). الرسم البياني الموجه الناتج عن علاقات requires: للأثر. إنه رسم بياني غير دوري موجه (DAG: الأسهم تشير للأمام فقط، ولا تدور أبداً)، ويستخدمه OpenSpec لمعرفة ما يمكنك إنشاؤه التالي.

تمكين، وليس عقبات. المبدأ الذي ينص على أن اعتماديات الأثر تظهر ما يصبح ممكناً التالي، وليس ما هو مطلوب التالي. يمكنك مراجعة وتحرير أي أثر في أي وقت. انظر المفاهيم الأساسية بإيجاز.

التنسيق عبر المستودعات (تجريبي)

تنطبق هذه المصطلحات فقط إذا كان تخطيطك يمتد عبر أكثر من مستودع. هي في مرحلة تجريبية. يمكن لمعظم المستخدمين تجاهلها. انظر دليل المستخدم للمستودعات.

المستودع (Store). مستودع مستقل وظيفته الكاملة هي التخطيط. له نفس شكل openspec/ الذي تعرفه بالفعل (مواصفات وتغييرات) بالإضافة إلى ملف هوية صغير. تسجله على جهازك مرة واحدة، بالاسم، وبعد ذلك يمكن لأي أمر OpenSpec العمل فيه من أي مكان.

المرجع (Reference). إعلان، في openspec/config.yaml لمستودع الكود، عن مستودع يستند إليه هذا المستودع. المراجع للقراءة فقط: يحتفظ المستودع بجذره الخاص، ويحصل openspec instructions على فهرع لمواصفات المستودع المرجعي، لكل منها الأمر الدقيق لجلبها.

سياق العمل (Working context). ما تجمعته openspec context للمستودع الحالي: جذر OpenSpec الخاص به بالإضافة إلى كل مستودع يشير إليه، كل منها مع كيفية جلبه. الإجابة على السؤال: "مع ماذا أعمل؟"

مجموعة العمل (Workset). مجموعة شخصية ومحلية على الجهاز من المجلدات تفتحها معاً (مستودع جنباً إلى جنب مع مستودعات الكود التي تعمل عليها). يتم إنشاؤها صراحةً باستخدام openspec workset create; لا يتم الالتزام بأي شيء يتعلق بهذه المسارات المحلية في مستودع التخطيط المشترك.

انظر أيضاً

• المفاهيم الأساسية بإيجاز: الأفكار الخمس، في صفحة واحدة
• المفاهيم: الشرح المفصل
• كيف تعمل الأوامر: الأوامر الشريطية مقابل واجهة سطر الأوامر