Skip to content

الأوامر

هذا هو المرجع لأوامر الشرطة المائلة الخاصة بـ 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

ما يفعله:

  • يسير عبر دورة كاملة لسير العمل مع شرح
  • يفحص قاعدة الكود للعثور على فرص تحسين حقيقية
  • ينشئ تغييرًا فعليًا بعناصر حقيقية
  • ينفذ عملًا فعليًا (تغييرات صغيرة وآمنة)
  • يؤرشف التغيير المكتمل
  • يشرح كل خطوة أثناء حدوثها

المراحل:

  1. الترحيب وتحليل قاعدة الكود
  2. العثور على فرصة للتحسين
  3. إنشاء تغيير (/opsx:new)
  4. كتابة الاقتراح
  5. إنشاء المواصفات
  6. كتابة التصميم
  7. إنشاء المهام
  8. تنفيذ المهام (/opsx:apply)
  9. التحقق من التنفيذ
  10. أرشفة التغيير
  11. ملخص والخطوات التالية

مثال:

أنت: /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 للحصول على مزيد من التحكم

الخطوات التالية