الأوامر
هذا هو المرجع لأوامر الشرطة المائلة الخاصة بـ OpenSpec. يتم استدعاء هذه الأوامر في واجهة محادثة مساعد البرمجة الذكية الخاص بك (مثل Claude Code، Cursor، Windsurf).
لأنماط سير العمل ومتى يتم استخدام كل أمر، راجع أنماط سير العمل. لأوامر واجهة سطر الأوامر (CLI)، راجع واجهة سطر الأوامر.
مرجع سريع
المسار الافتراضي السريع (الملف التعريفي core)
| الأمر | الغرض |
|---|---|
/opsx:propose | إنشاء تغيير وتوليد تخطيطات التخطيط في خطوة واحدة |
/opsx:explore | التفكير في الأفكار قبل الالتزام بتغيير |
/opsx:apply | تنفيذ المهام من التغيير |
/opsx:sync | دمج مواصفات الدلتا في المواصفات الرئيسية |
/opsx:archive | أرشفة تغيير مكتمل |
أوامر سير العمل الموسع (اختيار سير عمل مخصص)
| الأمر | الغرض |
|---|---|
/opsx:new | بدء هيكل تغيير جديد |
/opsx:continue | إنشاء التخطيط التالي بناءً على التبعيات |
/opsx:ff | التقدم السريع: إنشاء جميع تخطيطات التخطيط دفعة واحدة |
/opsx:verify | التحقق من تطابق التنفيذ مع التخطيطات |
/opsx:bulk-archive | أرشفة عدة تغييرات دفعة واحدة |
/opsx:onboard | تعليمات إرشادية عبر سير العمل الكامل |
الملف التعريفي الافتراضي العام هو core. لتمكين أوامر سير العمل الموسع، قم بتشغيل openspec config profile، حدد أنماط سير العمل، ثم قم بتشغيل openspec update في مشروعك.
مرجع الأوامر
/opsx:propose
إنشاء تغيير جديد وتوليد عناصر التخطيط في خطوة واحدة. هذا هو الأمر الافتراضي للبدء في ملف core.
الصيغة:
text
/opsx:propose [change-name-or-description]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name-or-description | لا | اسم بتنسيق kebab-case أو وصف للتغيير بلغة واضحة |
ما يفعله:
- ينشئ
openspec/changes/<change-name>/ - يولد العناصر اللازمة قبل التنفيذ (لـ
spec-driven: الاقتراح، المواصفات، التصميم، المهام) - يتوقف عندما يكون التغيير جاهزًا لـ
/opsx:apply
مثال:
text
أنت: /opsx:propose add-dark-mode
الذكاء الاصطناعي: تم إنشاء openspec/changes/add-dark-mode/
✓ proposal.md
✓ specs/ui/spec.md
✓ design.md
✓ tasks.md
جاهز للتنفيذ. قم بتشغيل /opsx:apply.نصائح:
- استخدم هذا للحصول على أسرع مسار من البداية إلى النهاية
- إذا كنت ترغب في التحكم في العناصر خطوة بخطوة، قم بتمكين سير العمل الموسع واستخدم
/opsx:new+/opsx:continue
/opsx:explore
التفكير في الأفكار، والتحقيق في المشكلات، وتوضيح المتطلبات قبل الالتزام بتغيير.
الصيغة:
/opsx:explore [topic]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
topic | لا | ما تريد استكشافه أو التحقيق فيه |
ما يفعله:
- يفتح محادثة استكشافية بدون هيكل مطلوب
- يحقق في قاعدة الكود للإجابة على الأسئلة
- يقارن بين الخيارات والأساليب
- ينشئ مخططات بصرية لتوضيح التفكير
- يمكن أن يتحول إلى
/opsx:propose(افتراضي) أو/opsx:new(سير عمل موسع) عندما تتبلور الرؤى
مثال:
text
أنت: /opsx:explore
الذكاء الاصطناعي: ما الذي تريد استكشافه؟
أنت: كيف يجب أن نتعامل مع المصادقة لتطبيق الجوال؟
الذكاء الاصطناعي: دعني أتحقق من إعدادات المصادقة الحالية لديك...
[يحلل قاعدة الكود]
أرى أنك تستخدم مصادقة قائمة على الجلسة لتطبيق الويب.
للجوال، لدينا ثلاثة خيارات رئيسية:
1. رموز JWT (بدون حالة، تعمل بدون اتصال)
2. OAuth2 (إذا كنت بحاجة إلى تسجيل الدخول عبر طرف ثالث)
3. تمديد الجلسات الحالية (أبسط، لكن يتطلب اتصال)
واجهة برمجة التطبيقات لديك مهيأة بالفعل لـ CORS. أي اتجاه يثير اهتمامك؟
أنت: لنذهب مع JWT. هل يمكننا بدء تغيير لذلك؟
الذكاء الاصطناعي: جاهز متى كنت أنت جاهزًا. قم بتشغيل /opsx:propose add-jwt-auth للبدء.نصائح:
- استخدم عندما تكون المتطلبات غير واضحة أو تحتاج إلى التحقيق
- لا يتم إنشاء أي عناصر أثناء الاستكشاف
- جيد لمقارنة أساليب متعددة قبل اتخاذ القرار
- يمكنه قراءة الملفات والبحث في قاعدة الكود
/opsx:new
بدء هيكل تغيير جديد. ينشئ مجلد التغيير وينتظر حتى تقوم بإنشاء العناصر باستخدام /opsx:continue أو /opsx:ff.
هذا الأمر جزء من مجموعة سير العمل الموسع (غير مدرج في ملف core الافتراضي).
الصيغة:
/opsx:new [change-name] [--schema <schema-name>]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | اسم لمجلد التغيير (يُطلب إذا لم يتم تقديمه) |
--schema | لا | مخطط سير العمل للاستخدام (الافتراضي: من الإعدادات أو spec-driven) |
ما يفعله:
- ينشئ دليل
openspec/changes/<change-name>/ - ينشئ ملف البيانات الوصفية
.openspec.yamlفي مجلد التغيير - يعرض أول قالب عنصر جاهز للإنشاء
- يطلب اسم التغيير والمخطط إذا لم يتم تقديمهما
ما ينشئه:
openspec/changes/<change-name>/
└── .openspec.yaml # بيانات وصفية للتغيير (المخطط، تاريخ الإنشاء)مثال:
أنت: /opsx:new add-dark-mode
الذكاء الاصطناعي: تم إنشاء openspec/changes/add-dark-mode/
المخطط: spec-driven
جاهز لإنشاء: proposal
استخدم /opsx:continue لإنشائه، أو /opsx:ff لإنشاء جميع العناصر.نصائح:
- استخدم أسماء وصفية:
add-feature،fix-bug،refactor-module - تجنب الأسماء العامة مثل
update،changes،wip - يمكن أيضًا تعيين المخطط في إعدادات المشروع (
openspec/config.yaml)
/opsx:continue
إنشاء العنصر التالي في سلسلة التبعيات. ينشئ عنصرًا واحدًا في كل مرة لتحقيق تقدم تدريجي.
الصيغة:
/opsx:continue [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير للاستمرار فيه (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- يستعلم عن رسم بياني لتبعيات العناصر
- يعرض العناصر الجاهزة مقابل المحظورة
- ينشئ أول عنصر جاهز
- يقرأ ملفات التبعيات للحصول على السياق
- يعرض ما يصبح متاحًا بعد الإنشاء
مثال:
أنت: /opsx:continue
الذكاء الاصطناعي: التغيير: add-dark-mode
حالة العناصر:
✓ proposal (مكتمل)
◆ specs (جاهز)
◆ design (جاهز)
○ tasks (محظور - يحتاج إلى: specs)
جارٍ إنشاء specs...
[يقرأ proposal.md، ينشئ المواصفات بناءً على المتطلبات]
✓ تم إنشاء openspec/changes/add-dark-mode/specs/ui/spec.md
متاح الآن: tasks
قم بتشغيل /opsx:continue لإنشاء العنصر التالي.نصائح:
- استخدم عندما تريد مراجعة كل عنصر قبل المتابعة
- جيد للتغييرات المعقدة حيث تريد التحكم
- قد تصبح عناصر متعددة جاهزة في نفس الوقت
- يمكنك تعديل العناصر المنشأة قبل الاستمرار
/opsx:ff
التقدم السريع عبر إنشاء العناصر. ينشئ جميع عناصر التخطيط دفعة واحدة.
الصيغة:
/opsx:ff [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير للتقدم السريع فيه (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- ينشئ جميع العناصر بترتيب التبعيات
- يتتبع التقدم عبر قائمة المهام
- يتوقف عندما تكتمل جميع العناصر المطلوبة للتطبيق
- يقرأ كل تبعية قبل إنشاء العنصر التالي
مثال:
أنت: /opsx:ff add-dark-mode
الذكاء الاصطناعي: جارٍ التقدم السريع في add-dark-mode...
✓ إنشاء proposal.md
✓ إنشاء specs/ui/spec.md
✓ إنشاء design.md
✓ إنشاء tasks.md
اكتملت جميع عناصر التخطيط!
جاهز للتنفيذ. قم بتشغيل /opsx:apply للبدء.نصائح:
- استخدم عندما يكون لديك صورة واضحة لما تبنيه
- أسرع من
/opsx:continueللتغييرات المباشرة - لا يزال بإمكانك تعديل العناصر لاحقًا
- جيد للميزات الصغيرة إلى المتوسطة
/opsx:apply
تنفيذ مهام التغيير. يعمل عبر قائمة المهام، ويكتب الكود ويتحقق من العناصر.
الصيغة:
/opsx:apply [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير لتنفيذه (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- يقرأ
tasks.mdويحدد المهام غير المكتملة - يعمل عبر المهام واحدة تلو الأخرى
- يكتب الكود، وينشئ الملفات، ويشغل الاختبارات حسب الحاجة
- يضع علامة على المهام المكتملة بمربعات الاختيار
[x]
مثال:
أنت: /opsx:apply
الذكاء الاصطناعي: جارٍ تنفيذ add-dark-mode...
قراءة tasks.md:
- [ ] 1.1 إنشاء ThemeContext
- [ ] 1.2 إضافة خصائص CSS مخصصة
- [ ] 1.3 تنفيذ الاستمرارية في localStorage
العمل على 1.1: إنشاء ThemeContext...
[ينشئ src/context/ThemeContext.tsx]
✓ 1.1 مكتمل
العمل على 1.2: إضافة خصائص CSS مخصصة...
[يحدّث src/styles/globals.css]
✓ 1.2 مكتمل
...نصائح:
- يمكن استئنافه من حيث توقفت إذا تم مقاطعته
- استخدم للتغييرات المتوازية عن طريق تحديد اسم التغيير
- يتم تتبع حالة الاكتمال في مربعات الاختيار
tasks.md
/opsx:verify
التحقق من أن التنفيذ يتوافق مع عناصر التغيير الخاصة بك. يتحقق من الاكتمال والصحة والتماسك.
الصيغة:
/opsx:verify [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير للتحقق منه (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- يتحقق من ثلاثة أبعاد لجودة التنفيذ
- يبحث في قاعدة الكود عن أدلة التنفيذ
- يبلّغ عن المشكلات مصنفة على أنها حرجة، تحذير، أو اقتراح
- لا يمنع الأرشفة، لكنه يبرز المشكلات
أبعاد التحقق:
| البعد | ما يتحقق منه |
|---|---|
| الاكتمال | جميع المهام منجزة، جميع المتطلبات مُنفّذة، السيناريوهات مغطاة |
| الصحة | التنفيذ يتوافق مع نية المواصفات، الحالات الحدية مُعالَجة |
| التماسك | قرارات التصميم منعكسة في الكود، الأنماط متسقة |
مثال:
أنت: /opsx:verify
الذكاء الاصطناعي: جارٍ التحقق من add-dark-mode...
الاكتمال
✓ جميع المهام الثماني في tasks.md محددة
✓ جميع المتطلبات في المواصفات لها كود مقابل
⚠ السيناريو "كشف تفضيل النظام" لا يوجد تغطية اختبار له
الصحة
✓ التنفيذ يتوافق مع نية المواصفات
✓ الحالات الحدية من السيناريوهات مُعالَجة
✓ حالات الخطأ تتوافق مع تعريفات المواصفات
التماسك
✓ قرارات التصميم منعكسة في هيكل الكود
✓ اصطلاحات التسمية متسقة مع design.md
⚠ التصميم يذكر "متغيرات CSS" لكن التنفيذ يستخدم فئات Tailwind
ملخص
─────────────────────────────
مشكلات حرجة: 0
تحذيرات: 2
جاهز للأرشفة: نعم (مع تحذيرات)
توصيات:
1. إضافة اختبار لكشف تفضيل النظام
2. تحديث design.md ليعكس استخدام Tailwind، أو إعادة هيكلة لاستخدام متغيرات CSSنصائح:
- شغّله قبل الأرشفة لالتقاط عدم التطابق مبكرًا
- التحذيرات لا تمنع الأرشفة لكنها تشير إلى مشكلات محتملة
- جيد لمراجعة عمل الذكاء الاصطناعي قبل الالتزام
- يمكن أن يكشف الانحراف بين العناصر والتنفيذ
/opsx:sync
أمر اختياري. دمج مواصفات الدلتا من التغيير في المواصفات الرئيسية. ستطلب الأرشفة المزامنة إذا لزم الأمر، لذلك عادةً لا تحتاج إلى تشغيل هذا يدويًا.
الصيغة:
/opsx:sync [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير لمزامنته (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- يقرأ مواصفات الدلتا من مجلد التغيير
- يحلل أقسام ADDED/MODIFIED/REMOVED/RENAMED
- يدمج التغييرات في دليل
openspec/specs/الرئيسي - يحافظ على المحتوى الحالي غير المذكور في الدلتا
- لا يؤرشف التغيير (يبقى نشطًا)
مثال:
text
أنت: /opsx:sync
الذكاء الاصطناعي: جارٍ مزامنة مواصفات الدلتا لـ add-dark-mode...
القراءة: openspec/changes/add-dark-mode/specs/ui/spec.md
الهدف: openspec/specs/ui/spec.md
التغييرات المطلوب تطبيقها:
✓ ADDED: متطلب اختيار السمة (2 سيناريو)
✓ ADDED: متطلب إمكانية الوصول (1 سيناريو)
جارٍ الدمج...
✓ تم تحديث openspec/specs/ui/spec.md
التغيير يبقى نشطًا. قم بتشغيل /opsx:archive عند الانتهاء.متى تستخدمه يدويًا:
| السيناريو | استخدام المزامنة؟ |
|---|---|
| تغيير طويل الأمد، تريد المواصفات الرئيسية قبل الأرشفة | نعم |
| تغييرات متوازية متعددة تحتاج إلى المواصفات الأساسية المحدثة | نعم |
| تريد معاينة/مراجعة الدمج بشكل منفصل | نعم |
| تغيير سريع، الذهاب مباشرة إلى الأرشفة | لا (الأرشفة تتعامل معه) |
نصائح:
- المزامنة ذكية، وليست نسخ ولصق
- يمكنها إضافة سيناريوهات إلى المتطلبات الحالية دون تكرار
- التغيير يبقى نشطًا بعد المزامنة (غير مؤرشف)
- معظم المستخدمين لن يحتاجوا إلى استدعاؤه مباشرة—الأرشفة تطلب ذلك إذا لزم الأمر
/opsx:archive
أرشفة تغيير مكتمل. ينهي التغيير وينقله إلى مجلد الأرشيف.
الصيغة:
/opsx:archive [change-name]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-name | لا | أي تغيير لأرشفته (يُستنتج من السياق إذا لم يتم تقديمه) |
ما يفعله:
- يتحقق من حالة اكتمال العناصر
- يتحقق من اكتمال المهام (يحذر إذا لم تكتمل)
- يعرض مزامنة مواصفات الدلتا إذا لم تتم مزامنتها بعد
- ينقل مجلد التغيير إلى
openspec/changes/archive/YYYY-MM-DD-<name>/ - يحافظ على جميع العناصر لسجل التدقيق
مثال:
text
أنت: /opsx:archive
الذكاء الاصطناعي: جارٍ أرشفة add-dark-mode...
حالة العناصر:
✓ proposal.md موجود
✓ specs/ موجود
✓ design.md موجود
✓ tasks.md موجود (8/8 مهام مكتملة)
مواصفات الدلتا: لم تتم المزامنة بعد
→ هل تريد المزامنة الآن؟ (موصى به)
أنت: نعم
الذكاء الاصطناعي: ✓ تمت مزامنة المواصفات إلى openspec/specs/ui/spec.md
✓ تم النقل إلى openspec/changes/archive/2025-01-24-add-dark-mode/
تم أرشفة التغيير بنجاح.نصائح:
- الأرشفة لن تمنع بسبب المهام غير المكتملة، لكنها ستحذر
- يمكن مزامنة مواصفات الدلتا أثناء الأرشفة أو قبلها
- التغييرات المؤرشفة محفوظة للتاريخ
- استخدم
/opsx:verifyأولاً لالتقاط المشكلات
/opsx:bulk-archive
أرشفة عدة تغييرات مكتملة دفعة واحدة. يتعامل مع تعارضات المواصفات بين التغييرات.
الصيغة:
/opsx:bulk-archive [change-names...]المعاملات:
| المعامل | مطلوب | الوصف |
|---|---|---|
change-names | لا | تغييرات محددة لأرشفتها (يعرض للاختيار إذا لم يتم تقديمها) |
ما يفعله:
- يسرد جميع التغييرات المكتملة
- يتحقق من كل تغيير قبل الأرشفة
- يكتشف تعارضات المواصفات عبر التغييرات
- يحل التعارضات عن طريق التحقق مما تم تنفيذه فعليًا
- يرشف بترتيب زمني
مثال:
أنت: /opsx:bulk-archive
الذكاء الاصطناعي: تم العثور على 3 تغييرات مكتملة:
- add-dark-mode (8/8 مهام مكتملة)
- fix-login-bug (3/3 مهام مكتملة)
- update-footer (2/2 مهام مكتملة)
جارٍ التحقق من تعارضات المواصفات...
⚠ add-dark-mode و update-footer كلاهما يمس specs/ui/
جارٍ فحص قاعدة الكود للحل...
كلا التغييرين مُنفّذان. سيتم الدمج بترتيب زمني:
1. add-dark-mode (أنشئ في 20 يناير)
2. update-footer (أنشئ في 22 يناير)
هل تريد أرشفة جميع التغييرات الثلاثة؟
أنت: نعم
الذكاء الاصطناعي: ✓ تم أرشفة add-dark-mode
✓ تم أرشفة fix-login-bug
✓ تم أرشفة update-footer
تم دمج المواصفات: add-dark-mode → update-footerنصائح:
- جيد لتدفقات العمل المتوازية
- حل التعارضات ذاتي (يتحقق من قاعدة الكود)
- يتم أرشفة التغييرات بترتيب الإنشاء
- يطلب الإذن قبل الكتابة فوق محتوى المواصفات
/opsx:onboard
إرشاد توجيهي عبر سير عمل OpenSpec الكامل. درس تفاعلي باستخدام قاعدة الكود الفعلية الخاصة بك.
الصيغة:
/opsx:onboardما يفعله:
- يسير عبر دورة كاملة لسير العمل مع شرح
- يفحص قاعدة الكود للعثور على فرص تحسين حقيقية
- ينشئ تغييرًا فعليًا بعناصر حقيقية
- ينفذ عملًا فعليًا (تغييرات صغيرة وآمنة)
- يؤرشف التغيير المكتمل
- يشرح كل خطوة أثناء حدوثها
المراحل:
- الترحيب وتحليل قاعدة الكود
- العثور على فرصة للتحسين
- إنشاء تغيير (
/opsx:new) - كتابة الاقتراح
- إنشاء المواصفات
- كتابة التصميم
- إنشاء المهام
- تنفيذ المهام (
/opsx:apply) - التحقق من التنفيذ
- أرشفة التغيير
- ملخص والخطوات التالية
مثال:
أنت: /opsx:onboard
الذكاء الاصطناعي: مرحباً بك في OpenSpec!
سأرشدك عبر سير العمل الكامل باستخدام قاعدة الكود الفعلية الخاصة بك.
سنجد شيئًا صغيرًا للتحسين، وننشئ تغييرًا مناسبًا له،
وننفذه، ونؤرشفه.
دعني أفحص قاعدة الكود للعثور على فرص...
[يحلل قاعدة الكود]
وجدت بعض الأشياء التي يمكننا العمل عليها:
1. إضافة تحقق من المدخلات إلى نموذج الاتصال
2. تحسين رسائل الخطأ في تدفق المصادقة
3. إضافة حالات تحميل إلى الأزرار غير المتزامنة
أيها يثير اهتمامك؟ (أو اقترح شيئًا آخر)نصائح:
- الأفضل للمستخدمين الجدد الذين يتعلمون سير العمل
- يستخدم كودًا حقيقيًا، وليس أمثلة افتراضية
- ينشئ تغييرًا حقيقيًا يمكنك الاحتفاظ به أو التخلص منه
- يستغرق 15-30 دقيقة لإكماله
صيغة الأوامر حسب أداة الذكاء الاصطناعي
تستخدم أدوات الذكاء الاصطناعي المختلفة صيغ أوامر مختلفة قليلاً. استخدم التنسيق الذي يتوافق مع أداتك:
| الأداة | مثال على الصيغة |
|---|---|
| Claude Code | /opsx:propose, /opsx:apply |
| Cursor | /opsx-propose, /opsx-apply |
| Windsurf | /opsx-propose, /opsx-apply |
| Copilot (IDE) | /opsx-propose, /opsx-apply |
| Kimi CLI | استدعاءات قائمة على المهارات مثل /skill:openspec-propose, /skill:openspec-apply-change (بدون ملفات أمر opsx-* مولدة) |
| Trae | استدعاءات قائمة على المهارات مثل /openspec-propose, /openspec-apply-change (بدون ملفات أمر opsx-* مولدة) |
النية واحدة عبر الأدوات، ولكن كيفية ظهور الأوامر قد تختلف حسب التكامل.
ملاحظة: أوامر GitHub Copilot (
.github/prompts/*.prompt.md) متاحة فقط في إضافات IDE (VS Code، JetBrains، Visual Studio). لا يدعم GitHub Copilot CLI حاليًا ملفات الأوامر المخصصة — راجع الأدوات المدعومة للتفاصيل وحلول بديلة.
الأوامر القديمة
تستخدم هذه الأوامر سير العمل القديم "الكل دفعة واحدة". لا تزال تعمل ولكن يُوصى بأوامر OPSX.
| الأمر | ماذا يفعل |
|---|---|
/openspec:proposal | إنشاء جميع المنتجات دفعة واحدة (اقتراح، مواصفات، تصميم، مهام) |
/openspec:apply | تنفيذ التغيير |
/openspec:archive | أرشفة التغيير |
متى تستخدم الأوامر القديمة:
- المشاريع الحالية التي تستخدم سير العمل القديم
- التغييرات البسيطة حيث لا تحتاج إلى إنشاء منتجات تدريجي
- تفضيل نهج "الكل أو لا شيء"
الانتقال إلى OPSX: يمكن متابعة التغييرات القديمة باستخدام أوامر OPSX. هيكل المنتجات متوافق.
استكشاف الأخطاء وإصلاحها
"لم يتم العثور على التغيير"
لم يتمكن الأمر من تحديد التغيير الذي سيعمل عليه.
الحلول:
- حدد اسم التغيير صراحةً:
/opsx:apply add-dark-mode - تحقق من وجود مجلد التغيير:
openspec list - تأكد من أنك في دليل المشروع الصحيح
"لا توجد منتجات جاهزة"
جميع المنتجات إما مكتملة أو محجوبة بسبب تبعيات مفقودة.
الحلول:
- شغّل
openspec status --change <name>لمعرفة ما يحجب التقدم - تحقق مما إذا كانت المنتجات المطلوبة موجودة
- أنشئ منتجات التبعيات المفقودة أولاً
"لم يتم العثور على المخطط"
المخطط المحدد غير موجود.
الحلول:
- اعرض المخططات المتاحة:
openspec schemas - تحقق من إملاء اسم المخطط
- أنشئ المخطط إذا كان مخصصًا:
openspec schema init <name>
الأوامر غير معروفة
أداة الذكاء الاصطناعي لا تتعرف على أوامر OpenSpec.
الحلول:
- تأكد من تهيئة OpenSpec:
openspec init - أعد إنشاء المهارات:
openspec update - تحقق من وجود دليل
.claude/skills/(لـ Claude Code) - أعد تشغيل أداة الذكاء الاصطناعي لتحميل المهارات الجديدة
المنتجات لا تُنشأ بشكل صحيح
يقوم الذكاء الاصطناعي بإنشاء منتجات غير مكتملة أو غير صحيحة.
الحلول:
- أضف سياق المشروع في
openspec/config.yaml - أضف قواعد خاصة بكل منتج للحصول على إرشادات محددة
- قدم المزيد من التفاصيل في وصف التغيير
- استخدم
/opsx:continueبدلاً من/opsx:ffللحصول على مزيد من التحكم
الخطوات التالية
- سير العمل - الأنماط الشائعة ومتى تستخدم كل أمر
- واجهة سطر الأوامر - أوامر الطرفية للإدارة والتحقق
- التخصيص - إنشاء مخططات وسير عمل مخصصة