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

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

• أوامر openspec ... تُنفَّذ في طرفية (Terminal). (مثال: 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 أو Devin Desktop أو 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   └──────────────────────────────┘
        run openspec here                       run /opsx:* here

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

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

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

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

إذن التعليمات الفعلية هي:

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

هذا كل شيء. لا وضع للتبديل، ولا خادم للتشغيل، ولا نافذة منفصلة.

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

لماذا يوجد هذا التقسيم

من المفيد فهم ذلك، لأنه يشرح لماذا يعمل OpenSpec مع أكثر من 30 أداة ذكاء اصطناعي مختلفة.

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

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

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

صياغة أوامر الشرطة المائلة حسب الأداة

النية متطابقة في كل مكان. الإملاء يتبع الملف الذي تحمّله الأداة.

ملف الأوامر الخاص بأداتك	كيف تكتبه	أدوات مثال
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
لا يوجد — مهارات فقط	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, shared .agents
لا يوجد — Kimi Code	/skill:openspec-propose	Kimi Code
لا يوجد — Codex CLI	$openspec-propose	Codex

Devin هي الأداة الوحيدة التي تمتد على صفّين. Devin Desktop يقرأ .devin/workflows/، لذا يعمل /opsx-propose هناك؛ Devin Local لا يفعل، لذا استخدم مهارة /openspec-propose على ذلك الوكيل. المهارات التي يكتبها OpenSpec في .devin/skills/ تعمل على كلاهما، ولهذا السبب يشار إليها بالاسم المهاري.

كل أداة مذكورة في How To Invoke — تلك الجدول هو المرجع المعتمد. صفّان ليسا أوامر شرطة مائلة على الإطلاق: Amazon Q يحمّل ملفاته في مكتبة أوامر تُستدعى بـ @، والأصفار الثلاثة الأخيرة تستخدم اسم المهارة، والذي ليس معرّف الأمر (/opsx:apply هو مهارة openspec-apply-change).

عند الشك، اقرأ سطر "Getting started" الذي طبعته openspec init: إنه يستخدم الصيغة التي سجّلتها أدواتك بالفعل. كتابة الشرطة المائلة ومراقبة الإكمال التلقائي تعمل أيضًا، للأدوات التي تعرض أوامر الشرطة المائلة على الإطلاق.

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

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

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

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

انظر إلى Supported Tools للمسارات الدقيقة لكل أداة، وإلى Migration Guide لكيفية استبدال المهارات لمنهجية الأوامر القديمة.

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

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

1. اكتب شرطة مائلة في محادثة الذكاء الاصطناعي. ابدأ بكتابة /opsx وراقب اقتراحات الإكمال التلقائي. إذا ظهرت، فأنت جاهز. على أداة تعتمد على المهارات فقط (Codex أو Kimi Code أو CodeArts أو ForgeCode أو Hermes أو Mistral Vibe أو Zed Agent أو الهدف المشترك .agents) /opsx لا يكتمل أبدًا حتى مع تثبيت سليم — جرّب اسم المهارة من الجدول أعلاه بدلاً من ذلك.
2. ابحث عن الملفات. لـ Claude Code، تحقق من أن .claude/skills/ يحتوي على مجلدات openspec-*. الأدوات الأخرى تستخدم مجلداتها الخاصة (Supported Tools يذكرها).
3. أعد تشغيل الإعداد. من جذر مشروعك، شغّل openspec update. هذا يعيد توليد ملفات المهارات والأوامر للأدوات التي قمت بإعدادها.
4. أعد تشغيل مساعدك. كثير من الأدوات تفحص المهارات والأوامر عند التشغيل، لذا قد تكون نافذة جديدة هي الخطوة المفقودة.

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

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

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

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

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

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

لتفاصيل ما يفعله كل أمر، انظر إلى Commands. لمعرفة متى تستخدم أيًا منها، انظر إلى Workflows.

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

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

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: إصلاحات عندما لا تظهر الأوامر