المسرد
كل مصطلح في OpenSpec، سطر واحد لكل منه.
يعيد OpenSpec استخدام كلمات تحمل معاني أخرى في git وCI وأدوات الوكلاء. كل صف يوضح المعنى الخاص بـ OpenSpec. العمود الأخير يربط بمزيد من التفاصيل حيثما توفرت.
| المصطلح | التعريف | المزيد |
|---|---|---|
| Apply | تنفيذ المهام في مقترح التغيير. المهارة: openspec-apply-change. | تنفيذ تغيير |
| Archive | إكمال مقترح التغيير: دمج تغييراته في المواصفات الرئيسية ونقل مجلده إلى openspec/changes/archive/. | البداية السريعة |
| Artifact | وثيقة تخطيط داخل مقترح التغيير: proposal.md، مواصفات التغيير، design.md، tasks.md. ليست ناتجاً للبناء. | الوثائق |
| Capability | مجال سلوك واحد في نظامك. لكل منها مواصفة واحدة في openspec/specs/<capability>/spec.md. | المجالات |
| Change proposal | وحدة عمل واحدة: مجلد تحت openspec/changes/<name>/ يحتوي على وثائق التخطيط الخاصة به. غالباً ما يُختصر إلى "تغيير". ليس تزامناً (commit) في git. | اقتراح |
| Command | نقطة دخول مكتوبة لسير عمل. تختلف الصيغة حسب الأداة (/opsx:propose، /opsx-propose). تسمي الوثائق سير العمل بالمهارة بدلاً من ذلك. | الأدوات المدعومة |
| Continue | إنشاء وثيقة التخطيط التالية لمقترح تغيير موجود. المهارة: openspec-continue-change. | المهارات |
| Delivery | كيفية تثبيت سير العمل: كمهارات، أو أوامر، أو كلاهما. | إعداد مشروعك |
| Delta spec | مواصفة داخل مقترح التغيير تسرد فقط ما يتغير، تحت عناوين ADDED، MODIFIED، REMOVED، وRENAMED. | مواصفات التغيير |
| Explore | التفكير في فكرة مع الوكيل قبل تقديم المقترح. لا يكتب أي كود. المهارة: openspec-explore. | استكشاف فكرة |
| Fast-forward | إنشاء مقترح تغيير بجميع وثائق التخطيط دفعة واحدة، جاهزاً للتنفيذ. المهارة: openspec-ff-change. ليس fast-forward في git. | المهارات |
| Legacy workflow | أوامر /openspec:* السابقة قبل OPSX. | |
| Loop | الدورة التي يمر بها مقترح التغيير: استكشاف، اقتراح، مراجعة، تطبيق، أرشفة. | البداية السريعة |
| Main specs | شجرة openspec/specs/: السلوك الحالي المتفق عليه لنظامك. الأرشفة تدمج التغييرات فيها. المجال الذي لا توجد له مواصفة يحصل على واحدة من متطلباته ADDED. | الأرشفة |
| OpenSpec root | شجرة openspec/ التي يحلها الأمر ويعمل عليها: مستودعك، أو مستودع المتجر. | المتاجر |
| OPSX | نظام سير عمل OpenSpec الحالي، وبادئة الأوامر التي يثبتها (/opsx:). | |
| Profile | سير العمل الذي يثبته init: core أو custom. | الملفات الشخصية |
| Propose | إنشاء مقترح تغيير وتوليد جميع وثائق التخطيط الخاصة به في خطوة واحدة. المهارة: openspec-propose. | البداية السريعة |
| Registry | قائمة المتاجر المسجلة على مستوى الجهاز، في registry.yaml. ليس سجل حزم. | CLI |
| Requirement | سلوك واحد يجب أن يمتلكه النظام، مكتوب بـ SHALL: ### Requirement: في المواصفة. | مواصفات التغيير |
| Scenario | مثال قابل للاختبار تحت متطلب، بصيغة WHEN/THEN. | مواصفات التغيير |
| Schema | تعريف الوثائق التي ينتجها مقترح التغيير، وبأي ترتيب. ليس JSON Schema. | المخططات |
| Skill | تعليمات سير العمل، مثبتة حيث تقرأها أداة الذكاء الاصطناعي (.agents/skills/، ...). | المهارات |
| Spec | ملف يصف كيف يتصرف مجال واحد حالياً، في openspec/specs/<capability>/spec.md. | الأرشفة |
| spec-driven | المخطط الافتراضي: الاقتراح، ثم مواصفات التغيير، ثم التصميم، ثم المهام. | spec-driven |
| Store | مستودع OpenSpec مستقل مسجل على جهازك، للتخطيط الذي يمتد عبر مستودعات. ليس مخزن بيانات. | المتاجر (تجريبي) |
| Sync | دمج التغييرات المنفذة في المواصفات الرئيسية دون أرشفة. المهارة: openspec-sync-specs. | المهارات |
| Template | المحتوى الأولي الذي يمنحه المخطط لكل وثيقة. | المخططات |
| Update | كمهارة (openspec-update-change): مراجعة وثائق التخطيط لمقترح التغيير. كأمر CLI (openspec update): تحديث ملفات OpenSpec المثبتة. | تحديث تغيير، CLI |
| Verify | التحقق من أن التنفيذ يطابق وثائق مقترح التغيير قبل الأرشفة. المهارة: openspec-verify-change. | المهارات |
| Workflow | إجراء OpenSpec مُسمّى (اقتراح، تطبيق، أرشفة، ...)، مثبت في أداة الذكاء الاصطناعي كمهارة أو أمر. | إعداد مشروعك |
| Workset | مجموعة شخصية محلية من المجلدات مفتوحة معاً في أداة واحدة. ليس متجراً، ولا يتم مشاركة أي شيء. | مجموعات العمل (تجريبي) |