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

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

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

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

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

النصفان

OpenSpec هو مشروع واحد يؤدي دورين مختلفين.

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

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

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

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

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

        الطرفية الخاصة بك                         دردشة مساعد الذكاء الاصطناعي الخاصة بك
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   تُثبِّت       │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   أوامر       │  /opsx:archive                │
   └──────────────────────┘    ومهارات    └──────────────────────────────┘
        شغِّل 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 أداة ذكاء اصطناعي مختلفة.

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

أوامر الشرطة المائلة هي مقود السيارة، ولكل أداة ذكاء اصطناعي مقودها الخاص المختلف قليلاً. يسمي Claude Code هذه الأوامر أوامر. تمتلك Cursor و Windsurf تنسيقاتها الخاصة. تسمي بعض الأدوات هذه المهارات. عند تشغيل 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
CodeArts	بنمط المهارات، مثل /openspec-propose
Codex	بنمط المهارات عبر .codex/skills/openspec-*
Oh My Pi	/opsx-propose، /opsx:apply
Kimi CLI	بنمط المهارات، مثل /skill:openspec-propose
Trae	/opsx-propose، /opsx-apply

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تشغيل أول سلس

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

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

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

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

دردشة الذكاء الاصطناعي      /opsx:apply
              (الذكاء الاصطناعي يبنيها، مع تحديد المهام المكتملة)

دردشة الذكاء الاصطناعي      /opsx:archive
              (تم دمج التغيير في مواصفاتك وأرشفته)

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

ذات صلة

• البدء: الدليل الكامل لأول تغيير
• الأوامر: كل أمر شرطة مائلة بالتفصيل
• واجهة سطر الأوامر: كل أمر طرفي بالتفصيل
• الأدوات المدعومة: بناء الجملة ومواقع الملفات لكل أداة
• الأسئلة الشائعة: المزيد من الإجابات السريعة
• استكشاف الأخطاء وإصلاحها: الإصلاحات عندما لا تظهر الأوامر