الأوامر

هذه هي المرجعية لأوامر الشرائح (slash commands) في OpenSpec. يتم استدعاء هذه الأوامر من خلال واجهة الدردشة لمساعدك البرمجي القائم على الذكاء الاصطناعي (مثل Claude Code، وCursor، وDevin Desktop).

لمعرفة أنماط سير العمل ومتى يجب استخدام كل أمر، يُرجى الرجوع إلى سير العمل. ولأوامر سطر الأوامر (CLI)، يُرجى الرجوع إلى CLI.

تستخدم هذه الصفحات /opsx:<command> كاسم قياسي. قد تستخدم بعض الأدوات تهجئة مختلفة — فـ Cursor وGitHub Copilot يسجلان الأمر /opsx-propose، بينما يستخدم Codex $openspec-propose — لذا تحقق من قسم كيفية الاستدعاء الخاص بأداتك. الملفات التي ينشئها OpenSpec تستخدم بالفعل الصيغة الصحيحة.

المرجع السريع

المسار السريع الافتراضي (ملف `core`)

الأمر	الغرض
`/opsx:propose`	إنشاء تغيير وتوليد وثائق التخطيط في خطوة واحدة
`/opsx:explore`	التفكير في الأفكار قبل الالتزام بإجراء التغيير
`/opsx:apply`	تنفيذ المهام الواردة في التغيير
`/opsx:update`	مراجعة وثائق التخطيط للتغيير والحفاظ على تماسكها
`/opsx:sync`	دمج مواصفات التغيير (delta specs) مع المواصفات الرئيسية
`/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

You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

نصائح:

استخدم هذا للحصول على أسرع مسار من البداية إلى النهاية
إذا كنت تريد التحكم في الوثائق خطوة بخطوة، فعّل سير العمل الموسّع واستخدم /opsx:new + /opsx:continue

`/opsx:explore`

ابدأ هنا إذا كنت غير متأكد. الاستكشاف هو شريك تفكير بلا مخاطر: يقرأ قاعدة الكود الخاصة بك، يقارن الخيارات، ويحوّل فكرة غامضة إلى خطة ملموسة قبل أن يوجد أي تغيير. يأتي ضمن الملف الافتراضي. للحالة الكاملة ومزيد من الأمثلة، راجع دليل Explore First.

فكّر في الأفكار، وبحث في المشكلات، ووضّح المتطلبات قبل الالتزام بتغيير.

الصيغة:

/opsx:explore [topic]

الحجج:

الحجة	مطلوبة	الوصف
`topic`	لا	ما تريد استكشافه أو البحث فيه

ما الذي يفعله:

يفتح محادثة استكشافية دون بنية مطلوبة
يبحث في قاعدة الكود للإجابة على الأسئلة
يقارن الخيارات والمقاربات
ينشئ مخططات بصرية لتوضيح التفكير
يمكن الانتقال إلى /opsx:propose (الافتراضي) أو /opsx:new (سير عمل موسّع) عندما تتبلور الرؤى

مثال:

text

You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

نصائح:

استخدمه عندما تكون المتطلبات غير واضحة أو تحتاج إلى بحث
لا يتم إنشاء أي وثائق أثناء الاستكشاف
مفيد لمقارنة عدة مقاربات قبل اتخاذ القرار
يمكن قراءة الملفات والبحث في قاعدة الكود

`/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    # Change metadata (schema, created date)

مثال:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

نصائح:

استخدم أسماء وصفية: add-feature، fix-bug، refactor-module
تجنّب الأسماء العامة مثل update، changes، wip
يمكن أيضًا ضبط المخطط في إعدادات المشروع (openspec/config.yaml)

`/opsx:continue`

إنشاء الوثيقة التالية في سلسلة الاعتماديات. ينشئ وثيقة واحدة في كل مرة للتقدم التدريجي.

الصيغة:

/opsx:continue [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد المتابعة فيه (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يستعلم عن رسم بياني لاعتماديات الوثائق
يعرض الوثائق الجاهزة مقابل المحظورة
ينشئ أول وثيقة جاهزة
يقرأ ملفات الاعتماديات للسياق
يعرض ما يصبح متاحًا بعد الإنشاء

مثال:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs, design)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: design
     Run /opsx:continue to create the next artifact.

نصائح:

استخدمه عندما تريد مراجعة كل وثيقة قبل المتابعة
مفيد للتغييرات المعقدة حيث تريد التحكم
قد تصبح عدة وثائق جاهزة في نفس الوقت
يمكنك تعديل الوثائق المنشأة قبل المتابعة

`/opsx:ff`

التقديم السريع عبر إنشاء الوثائق. ينشئ جميع وثائق التخطيط دفعة واحدة.

الصيغة:

/opsx:ff [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد تقديمه سريعًا (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

ينشئ جميع الوثائق بترتيب الاعتماديات
يتتبع التقدم عبر قائمة المهام
يتوقف عندما تكتمل جميع وثائق apply-required
يقرأ كل اعتمادية قبل إنشاء الوثيقة التالية

مثال:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

نصائح:

استخدمه عندما يكون لديك صورة واضحة عما تبنيه
أسرع من /opsx:continue للتغييرات المباشرة
يمكنك ما زال تعديل الوثائق لاحقًا
مناسب للميزات الصغيرة إلى المتوسطة

`/opsx:apply`

تنفيذ المهام من التغيير. يعمل عبر قائمة المهام، يكتب الكود ويشطب العناصر.

الصيغة:

/opsx:apply [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد تنفيذه (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يقرأ tasks.md ويحدد المهام غير المكتملة
يعمل عبر المهام واحدة تلو الأخرى
يكتب الكود، ينشئ الملفات، يشغّل الاختبارات حسب الحاجة
يعلّم المهام المكتملة بعلامات [x]

مثال:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

نصائح:

يمكن الاستئناف من حيث توقفت إذا انقطع
استخدمه للتغييرات المتوازية بتحديد اسم التغيير
حالة الاكتمال تتعقب في علامات tasks.md

`/opsx:update`

مراجعة وثائق التخطيط الموجودة للتغيير والحفاظ على اتساقها مع بعضها البعض. وثائق التخطيط فقط - لا يعدّل الكود أبدًا.

الصيغة:

text

/opsx:update [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد تحديثه (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يقرأ وثائق التغيير عبر openspec status --change <name> --json
يطبّق المراجعة المطلوبة منك، أو يراجع الوثائق بحثًا عن تناقضات إذا لم تسمِّ واحدة
يوفق الوثائق الأخرى الموجودة في أي اتجاه (تعديل التصميم قد يرتد إلى المقترح)
يؤكد كل تعديل معك قبل الكتابة، وثيقة واحدة في كل مرة
ينتهي بتوصية بالخطوة التالية: /opsx:continue (وثائق مفقودة)، /opsx:apply (نقل خطة معدّلة إلى الكود)، أو /opsx:archive (كل شيء منتهٍ)

مثال:

text

You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage

AI:  Reading add-dark-mode artifacts...

     The design references localStorage in two places; tasks 1.3 covers
     localStorage persistence; the proposal doesn't mention storage.

     Proposed revisions:
     1. design.md - swap localStorage decision for cookie storage
     2. tasks.md - reword task 1.3 to cookie persistence

     Apply revision 1? (design.md)

نصائح:

لن ينشئ وثائق مفقودة - ذلك دور /opsx:continue
إذا كان التغيير قد نُفِّذ بالفعل، تابع بـ /opsx:apply ليتطابق الكود مع الخطة المعدّلة
إذا غيّرت مراجعتك النية من التغيير، ابدأ من جديد بتغيير جديد (راجع When to Update vs. Start Fresh)

`/opsx:verify`

التحقق من أن التنفيذ يطابق وثائق التغيير الخاصة بك. يفحص الاكتمال، والصحة، والاتساق.

الصيغة:

/opsx:verify [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد التحقق منه (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يفحص ثلاثة أبعاد لجودة التنفيذ
يبحث في قاعدة الكود عن أدلة التنفيذ
يبلغ عن المشكلات مصنّفة كـ CRITICAL أو WARNING أو SUGGESTION
لا يمنع الأرشفة، لكنه يُبرز المشكلات

أبعاد التحقق:

البُعد	ما يتحقق منه
الاكتمال	جميع المهام منجزة، جميع المتطلبات منفّذة، السيناريوهات مغطّاة
الصحة	التنفيذ يطابق نية المواصفات، الحالات الحدّية معالجة
الاتساق	قرارات التصميم منعكسة في الكود، الأنماط متّسقة

مثال:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

نصائح:

شغّله قبل الأرشفة لالتقاط عدم التطابق مبكرًا
التحذيرات لا تمنع الأرشفة لكنها تشير إلى مشكلات محتملة
مفيد لمراجعة عمل الذكاء الاصطناعي قبل الالتزام
يمكن كشف الانحراف بين الوثائق والتنفيذ

`/opsx:sync`

أمر اختياري. دمج مواصفات الفروق من تغيير في المواصفات الرئيسية. سيطالب الأرشفة بالمزامنة إذا لزم الأمر، لذا عادةً لا تحتاج لتشغيل هذا يدويًا.

الصيغة:

/opsx:sync [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد مزامنته (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يقرأ مواصفات الفروق من مجلد التغيير
يحلّل أقسام ADDED/MODIFIED/REMOVED/RENAMED
يدمج التغييرات في مجلد openspec/specs/ الرئيسي
يحافظ على المحتوى الموجود غير المذكور في الفروق
لا يؤرشف التغيير (يبقى نشطًا)

مثال:

text

You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

متى تستخدمه يدويًا:

السيناريو	استخدم المزامنة؟
تغيير طويل الأمد، تريد المواصفات في الرئيسية قبل الأرشفة	نعم
تغييرات متوازية متعددة تحتاج المواصفات الأساسية المحدّثة	نعم
تريد معاينة/مراجعة الدمج بشكل منفصل	نعم
تغيير سريع، تنتقل مباشرة إلى الأرشفة	لا (الأرشفة تتكفل به)

نصائح:

المزامنة ذكية، ليست نسخًا ولصقًا
يمكن إضافة سيناريوهات إلى متطلبات موجودة دون تكرار
يبقى التغيير نشطًا بعد المزامنة (غير مؤرشف)
معظم المستخدمين لن يحتاجوا إطلاقًا لاستدعاء هذا مباشرةً - الأرشفة تطالب عند الحاجة

`/opsx:archive`

أرشفة تغيير مكتمل. ينهي التغيير وينقله إلى مجلد الأرشفة.

الصيغة:

/opsx:archive [change-name]

الحجج:

الحجة	مطلوبة	الوصف
`change-name`	لا	أي تغيير تريد أرشفته (يُستنتج من السياق إذا لم يُقدَّم)

ما الذي يفعله:

يتحقق من حالة اكتمال الوثائق
يتحقق من اكتمال المهام (يحذّر إذا لم تكتمل)
يعرض مزامنة مواصفات الفروق إذا لم تتم مزامنتها بعد
ينقل مجلد التغيير إلى openspec/changes/archive/YYYY-MM-DD-<name>/
يحافظ على جميع الوثائق لأغراض التدقيق

مثال:

text

You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

نصائح:

الأرشفة لن تمنع على المهام غير المكتملة، لكنها ستحذّر
يمكن مزامنة مواصفات الفروق أثناء الأرشفة أو قبلها
التغييرات المؤرشفة محفوظة للتاريخ
استخدم /opsx:verify أولًا لالتقاط المشكلات

`/opsx:bulk-archive`

أرشفة عدة تغييرات مكتملة دفعة واحدة. يتعامل مع تعارضات المواصفات بين التغييرات.

الصيغة:

/opsx:bulk-archive [change-names...]

الحجج:

الحجة	مطلوبة	الوصف
`change-names`	لا	تغييرات محددة لأرشفتها (يُطلب الاختيار إذا لم تُقدَّم)

ما الذي يفعله:

يعرض جميع التغييرات المكتملة
يتحقق من كل تغيير قبل الأرشفة
يكتشف تعارضات المواصفات عبر التغييرات
يحل التعارضات بفحص ما نُفِّذ فعليًا
يؤرشف بترتيب زمني

مثال:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

نصائح:

مفيد لمسارات العمل المتوازية
حل التعارضات ذكي (يفحص قاعدة الكود)
التغييرات تُؤرشف بترتيب الإنشاء
يطلب قبل تجاوز محتوى المواصفات

`/opsx:onboard`

تدريب موجّه عبر سير عمل OpenSpec الكامل. شروحات تفاعلية باستخدام قاعدة الكود الفعلية الخاصة بك.

الصيغة:

/opsx:onboard

ما الذي يفعله:

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

المرحلات:

الترحيب وتحليل قاعدة الكود
إيجاد فرصة تحسين
إنشاء تغيير (/opsx:new)
كتابة المقترح
إنشاء المواصفات
كتابة التصميم
إنشاء المهام
تنفيذ المهام (/opsx:apply)
التحقق من التنفيذ
أرشفة التغيير
الملخص والخطوات التالية

مثال:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

نصائح:

الأفضل للمستخدمين الجدد الذين يتعلمون سير العمل
يستخدم كودًا حقيقيًا، لا أمثلة تعليمية
ينشئ تغييرًا حقيقيًا يمكنك الإبقاء عليه أو التخلي عنه
يستغرق 15-30 دقيقة لإكماله

صيغة الأوامر حسب أداة الذكاء الاصطناعي

تستخدم أدوات الذكاء الاصطناعي المختلفة صيغًا مختلفة قليلًا لبناء الأوامر. استخدم الصيغة التي تناسب أداتك:

ملف أوامر أداتك	مثال على الصيغة	أدوات كمثال
`.../commands/opsx/<id>.*`	`/opsx:propose`, `/opsx:apply`	Claude Code, Gemini CLI, Crush
`.../opsx-<id>.*`	`/opsx-propose`, `/opsx-apply`	Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
لا يوجد — مهارات فقط	`/openspec-propose`, `/openspec-apply-change`	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, `.agents` المشتركة
لا يوجد — Kimi Code	`/skill:openspec-propose`	Kimi Code
لا يوجد — Codex CLI	`$openspec-propose`	Codex

Devin Desktop مقابل Devin Local: توفر ملفات .devin/workflows/opsx-*.md لأداة Devin Desktop أمر /opsx-propose. لا تحتوي Devin Local على سير عمل — استخدم المهارات التي يكتبها OpenSpec إلى .devin/skills/، على سبيل المثال /openspec-propose، والتي تعمل على كلا الوكيلين.

الهدف واحد عبر الأدوات، لكن طريقة عرض الأوامر قد تختلف حسب التكامل. يعرض كيفية الاستدعاء قائمة بكل أداة مدعومة؛ يوضح هذا الجدول أمثلة فقط لكل نوع.

ملاحظة: أوامر GitHub Copilot (.github/prompts/*.prompt.md) متاحة فقط في إضافات بيئة التطوير المتكاملة (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 لمزيد من التحكم

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

سير العمل - الأنماط الشائعة ومتى تستخدم كل أمر
واجهة سطر الأوامر - أوامر الطرفية للإدارة والتحقق
التخصيص - إنشاء مخططات وسير عمل مخصصة

الأوامر ​

المرجع السريع ​

المسار السريع الافتراضي (ملف core) ​

أوامر سير العمل الموسعة (اختيار سير عمل مخصص) ​

مرجع الأوامر ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:update ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

صيغة الأوامر حسب أداة الذكاء الاصطناعي ​

الأوامر القديمة ​

استكشاف الأخطاء وإصلاحها ​

"التغيير غير موجود" ​

"لا توجد مخرجات جاهزة" ​

"المخطط غير موجود" ​

الأوامر غير معروفة ​

المخرجات لا تُنشأ بشكل صحيح ​

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

الأوامر

المرجع السريع

المسار السريع الافتراضي (ملف `core`)

أوامر سير العمل الموسعة (اختيار سير عمل مخصص)

مرجع الأوامر

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:update`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

صيغة الأوامر حسب أداة الذكاء الاصطناعي

الأوامر القديمة

استكشاف الأخطاء وإصلاحها

"التغيير غير موجود"

"لا توجد مخرجات جاهزة"

"المخطط غير موجود"

الأوامر غير معروفة

المخرجات لا تُنشأ بشكل صحيح

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