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

الشيء الوحيد الذي يجب معرفته هو أن OpenSpec له نوعان من الأوامر، ويتم تشغيلها في مكانين مختلفين.

• تعمل أوامر openspec ... في الطرفية (terminal). (مثال: openspec init.)
• تعمل أوامر /opsx:... في دردشة مساعد الذكاء الاصطناعي الخاص بك. (مثال: /opsx:propose.)

إذا قمت بكتابة /opsx:propose في الطرفية ولم يحدث شيء، فهذه الصفحة هي السبب. أنت تتحدث إلى نصف خاطئ من OpenSpec. أوامر الشرطة المائلة (Slash commands) ليست أوامر طرفية. إنها تعليمات تقدمها لمساعد البرمجة بالذكاء الاصطناعي الخاص بك، وذلك في نفس مربع الدردشة الذي كنت ستكتب فيه "إضافة نموذج تسجيل دخول".

هذا التمييز البسيط هو العائق الأكثر شيوعًا للمستخدمين الجدد، لذا دعونا نوضح الأمر تمامًا.

النصفان

OpenSpec هو مشروع يرتدي قبعتين.

الواجهة السطرية (CLI - الطرفية). وهو برنامج يسمى openspec تقوم بتثبيته وتشغيله من خلال Shell الخاص بك. يقوم بإعداد مشروعك، ويستعرض التغييرات ويتحقق منها، ويعرض لوحة تحكم، وأرشفة العمل المنجز. أنت تكتب هذه الأوامر في iTerm أو الطرفية الخاصة بـ VS Code أو PowerShell، وفي أي مكان كنت ستشغل فيه git أو npm.

openspec init        # إعداد OpenSpec في هذا المشروع
openspec list        # عرض التغييرات النشطة
openspec view        # فتح لوحة التحكم التفاعلية

أوامر الشرطة المائلة (Slash commands - الدردشة). وهي أوامر قصيرة مثل /opsx:propose و/opsx:apply تكتبها في مساعد الذكاء الاصطناعي الخاص بك. تخبر هذه الأوامر الذكاء الاصطناعي باتباع سير عمل OpenSpec: صياغة اقتراح، وكتابة المواصفات، والبناء من قائمة المهام، والأرشفة عند الانتهاء. أنت تكتب هذه الأوامر في Claude Code أو Cursor أو Windsurf أو Copilot، أو أي مساعد تستخدمه.

/opsx:propose add-dark-mode    (تكتب في دردشة الذكاء الاصطناعي)
/opsx:apply                    (تكتب في دردشة الذكاء الاصطناعي)
/opsx:archive                  (تكتب في دردشة الذكاء الاصطناعي)

إليك النموذج العقلي في صورة واحدة:

        الطرفية (YOUR TERMINAL)                         دردشة مساعد الذكاء الاصطناعي (YOUR AI ASSISTANT'S CHAT)
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   تثبّت (installs)    │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   الأوامر (commands) │  /opsx:archive                │
   └──────────────────────┘    & المهارات (skills)   └──────────────────────────────┘
        تشغيل openspec هنا                       تشغيل /opsx:* هنا

لاحظ السهم. تشغيل openspec init في الطرفية هو ما يثبّت أوامر الشرطة المائلة في أداة الذكاء الاصطناعي الخاصة بك. النصف الخاص بالطرفية يقوم بإعداد النصف الخاص بالدردشة. بعد ذلك، يتم القيادة اليومية بشكل أساسي في الدردشة.

"كيف أبدأ الوضع التفاعلي؟"

لا يوجد وضع تفاعلي منفصل للبدء. هذا السؤال يطرح بكثرة، لذا يستحق إجابة واضحة.

أنت لا تدخل وضع OpenSpec خاصًا. أنت فقط تفتح مساعد البرمجة بالذكاء الاصطناعي الخاص بك كما تفعل دائمًا، وتكتب أمر شرطة مائلة في الدردشة. إن أمر الشرطة المائلة هو الطريقة التي "تدخل" بها إلى OpenSpec. يتعرف عليه مساعدك، ويقوم بتحميل مهارة OpenSpec المطابقة، ويبدأ باتباع سير العمل.

لذلك التعليمات الحقيقية هي:

1. افتح مساعد البرمجة بالذكاء الاصطناعي الخاص بك (Claude Code أو Cursor أو Windsurf، وما إلى ذلك) في مشروعك.
2. اكتب /opsx:propose في الدردشة الخاصة به، وفي نفس المكان الذي تكتب فيه أي طلب آخر.
3. راقب خاصية الإكمال التلقائي: إذا كان OpenSpec مثبتًا، فستظهر لك /opsx:propose و/opsx:apply والأصدقاء عند كتابة الشرطة المائلة.

هذا كل شيء. لا يوجد وضع للتبديل إليه، ولا شيطان (daemon) لتشغيله، ولا نافذة منفصلة.

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

لماذا يوجد هذا الانقسام؟

من المفيد فهم ذلك، لأنه يفسر سبب عمل OpenSpec مع أكثر من 25 أداة ذكاء اصطناعي مختلفة.

الواجهة السطرية (CLI) هي المحرك. إنها تعرف القواعد: كيف تبدو مجلدات التغييرات، وما هي المصنوعات التي تعتمد على الأخرى، وكيفية دمج مواصفات دلتا (delta spec) في مصدر الحقيقة الخاص بك. هذا هو نفسه في كل مكان.

أوامر الشرطة المائلة هي عجلة القيادة، ولكل أداة ذكاء اصطناعي عجلتها الخاصة قليلاً. Claude Code يسميها أوامر. Cursor وWindsurf لديهما تنسيقات خاصة بهما. بعض الأدوات تسميها مهارات (skills). عندما تقوم بتشغيل openspec init، يقوم OpenSpec بإنشاء النوع الصحيح من الملفات لكل أداة اخترتها، بحيث يعمل نفس قصد /opsx:propose بغض النظر عن المساعد الذي تفضله.

قوة هذا التصميم هي: أنت تتعلم سير العمل مرة واحدة وتحمله عبر الأدوات. المقابل هو: قد يختلف التنسيق الدقيق للأمر قليلاً بين الأدوات، وهذا هو القسم التالي.

بناء جملة أوامر الشرطة المائلة حسب الأداة

القصد واحد في كل مكان. لكن علامات الترقيم تختلف. استخدم الشكل الذي يتناسب مع مساعدك.

الأداة	كيفية كتابته
Claude Code	/opsx:propose، /opsx:apply
Cursor	/opsx-propose، /opsx-apply
Windsurf	/opsx-propose، /opsx-apply
GitHub Copilot (IDE)	/opsx-propose، /opsx-apply
Kimi CLI	نمط المهارة (skill-style)، مثل /skill:openspec-propose
Trae	نمط المهارة (skill-style)، مثل /openspec-propose

تستخدم معظم الأدوات إما الشكل الذي يحتوي على النقطتين (/opsx:propose) أو الشكل الذي يحتوي على الشرطة (/opsx-propose). بعض الأدوات تعرض OpenSpec كمهارات مسماة بدلاً من أوامر شرطة مائلة؛ بالنسبة لتلك، فإنك تستدعي المهارة بالاسم. القائمة الكاملة لكل أداة، بما في ذلك الملفات التي يتم كتابتها بالضبط وأين، موجودة في الأدوات المدعومة.

عند الشك، اكتب شرطة مائلة في دردشة الذكاء الاصطناعي الخاص بك وانظر إلى الإكمال التلقائي. سيعرض لك أداتك الشكل الذي تتوقعه.

كيف وصلت الأوامر: المهارات والأوامر

عندما تقوم بتشغيل openspec init (أو openspec update)، يقوم OpenSpec بكتابة ملفات صغيرة في مشروعك حتى يتمكن مساعد الذكاء الاصطناعي الخاص بك من العثور على سير العمل. اعتمادًا على أداتك وإعداداتك، تكون هذه إما مهارات (skills) أو أوامر (commands) أو كليهما.

• المهارات (Skills): توجد في أماكن مثل .claude/skills/openspec-*/SKILL.md. إنها المعيار الناشئ المشترك بين الأدوات: مجلد من التعليمات يكتشفه مساعدك تلقائيًا.
• الأوامر (Commands): توجد في أماكن مثل .claude/commands/opsx/<id>.md. وهي ملفات أوامر الشرطة المائلة القديمة الخاصة بكل أداة.

لست بحاجة إلى الاهتمام بأي منهما تستخدم أداتك. أنت فقط تكتب الأمر الشرطة المائلة ويعمل. لكن معرفة وجود هذه الملفات يساعد عندما يسوء شيء ما: إذا اختفت الأوامر، فهذا يعني عادةً أن هذه الملفات مفقودة أو قديمة، وopenspec update يعيد إنشائها.

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

التأكد من تثبيتها

تحققات سريعة، والأسرع أولاً:

1. اكتب شرطة مائلة في دردشة الذكاء الاصطناعي الخاص بك. ابدأ بالكتابة /opsx وراقب اقتراحات الإكمال التلقائي. إذا ظهرت، فأنت جاهز.
2. ابحث عن الملفات. بالنسبة لـ Claude Code، تحقق من أن .claude/skills/ يحتوي على مجلدات openspec-*. تستخدم الأدوات الأخرى أدلتها الخاصة (الأدوات المدعومة تسردها).
3. أعد تشغيل الإعداد. من جذر مشروعك، قم بتشغيل openspec update. هذا يعيد إنشاء ملفات المهارة والأمر لأي أدوات قمت بتهيئة إعدادها.
4. أعد تشغيل مساعدك. العديد من الأدوات تفحص المهارات والأوامر عند بدء التشغيل، لذا قد تكون النافذة الجديدة هي الخطوة المفقودة.

ما هي الأوامر التي أملكها؟

افتراضيًا، يقوم OpenSpec بتثبيت مجموعة الأساسية (core) من أوامر الشرطة المائلة:

• /opsx:explore: التفكير في فكرة مع الذكاء الاصطناعي قبل الالتزام بالتغيير (خطوة أولى رائعة عندما تكون غير متأكد)
• /opsx:propose: إنشاء تغيير وصياغة جميع مواد تخطيطه في خطوة واحدة
• /opsx:apply: بناء التغيير من خلال العمل على قائمة مهامه
• /opsx:sync: دمج تحديثات مواصفات التغيير في مواصفاتك الرئيسية (عادة ما يكون تلقائيًا)
• /opsx:archive: إنهاء تغيير وأرشفته

إيقاع جيد افتراضي: explore عندما تكون تفكر فيما يجب فعله، ثم propose وapply وarchive. يرشد دليل Explore First إلى سبب فائدة هذه الخطوة الافتتاحية.

هناك أيضًا مجموعة موسعة (expanded) لأولئك الذين يريدون تحكمًا أدق (/opsx:new، /opsx:continue، /opsx:ff، /opsx:verify، /opsx:bulk-archive، /opsx:onboard). يمكنك تشغيلها باستخدام openspec config profile، ثم تطبيقها باستخدام openspec update.

هل أنت جديد على كل هذا؟ /opsx:onboard (في المجموعة الموسعة) يرشدك خلال تغيير كامل في قاعدة الكود الخاصة بك، ويروي كل خطوة. إنها ألطف مقدمة ممكنة.

لمعرفة ما يفعله كل أمر بالتفصيل، راجع الأوامر. ولمعرفة متى يجب اللجوء إلى أي منها، راجع سير العمل.

التشغيل الأول النظيف

بتجميع كل شيء، إليك التسلسل الكامل مع تسمية كل خطوة بالمكان الذي تحدث فيه:

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (يثبّت أوامر الشرطة المائلة في أداة الذكاء الاصطناعي الخاصة بك)

AI CHAT      /opsx:explore
              (اختياري: التفكير في الفكرة مع الذكاء الاصطناعي أولاً)

AI CHAT      /opsx:propose add-dark-mode
              (يقوم الذكاء الاصطناعي بصياغة الاقتراح والمواصفات والتصميم والمهام)

AI CHAT      /opsx:apply
              (يبنيها الذكاء الاصطناعي، ويتحقق من المهام)

AI CHAT      /opsx:archive
              (يتم دمج التغيير في مواصفاتك وأرشفته)

خطوتان في الطرفية للإعداد. ثم تعيش في الدردشة. هذا هو الإيقاع.

ذات الصلة

• Getting Started: دليل المرور الأول الكامل بالتغييرات
• Commands: كل أمر شرطة مائلة بالتفصيل
• CLI: كل أمر طرفية بالتفصيل
• Supported Tools: التنسيق ومواقع الملفات لكل أداة
• FAQ: المزيد من الإجابات السريعة
• Troubleshooting: الإصلاحات عندما لا تظهر الأوامر