وثائق OpenSpec ​

مرحباً بك. هذا هو الموقع الرئيسي لكل ما يتعلق بـ OpenSpec.

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

إذا قرأت صفحة واحدة فقط، فاقرأ هاتين الصفحتين:

1. البدء: التثبيت، التهيئة، وتنفيذ أول تغيير لك.
2. كيف تعمل الأوامر: المكان الذي تكتب فيه فعلياً /opsx:propose (تلميح: في دردشة مساعد الذكاء الاصطناعي الخاص بك، وليس في الطرفية). هذه النقطة تربك الجميع مرة واحدة على الأقل.

هذه النقطة الثانية أهم مما تبدو عليه. يتكون OpenSpec من نصفين: أداة سطر أوامر تشغلها في طرفيتك، وأوامر شلش (slash commands) تعطيها لمساعد الذكاء الاصطناعي. معرفة الفرق بينهما يوفر عليك أكثر لحظات الارتباك شيوعاً.

أفضل عادة يمكنك بناءها أولاً: عندما لا تكون متأكداً مما يجب بناؤه، ابدأ بـ /opsx:explore. إنه شريك تفكير بلا مخاطر يقرأ كودك، ويزن الخيارات، ويشحذ الفكرة الغامضة إلى خطة ملموسة قبل وجود أي وثيقة أو كود. دليل استكشاف أولاً يقدم الحجة لذلك.

اختر مسارك ​

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

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

لدي قاعدة أكواد كبيرة موجودة بالفعل. أنت لا توثق كل شيء. يظهر استخدام OpenSpec في مشروع قائم كيفية البدء في كود حقيقي (brownfield) دون المبالغة في التعقيد.

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

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

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

أعمل ضمن فريق. يوضح OpenSpec ضمن فريق كيف يرتبط التغيير بغصن (branch) وسحب طلب (pull request)، وكيف يقوم زملاء الفريق بمراجعة الخطة قبل الكود.

أنتقل من سير العمل القديم. يشرح دليل الترحيل ما تغير ولماذا، ويضمن أن عملك الحالي آمن.

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

شيء ما معطّل. يجمع استكشاف الأخطاء وإصلاحها الأعطال التي يواجهها الناس فعلياً، مع الحلول.

الخريطة الكاملة ​

ابدأ من هنا ​

استخدامه يومياً ​

فهمه بعمق ​

اجعلها خاصة بك ​

عندما تحتاج إلى مساعدة ​

النسخة المختصرة (ثلاثون ثانية) ​

1. تثبيت        npm install -g @fission-ai/openspec@latest
2. تهيئة     cd your-project && openspec init
3. استكشاف        (في دردشة الذكاء الاصطناعي)  /opsx:explore           ← اختياري، لكنه عادة رائعة
4. اقتراح        (في دردشة الذكاء الاصطناعي)  /opsx:propose add-dark-mode
5. بناء          (في دردشة الذكاء الاصطناعي)  /opsx:apply
6. أرشفة        (في دردشة الذكاء الاصطناعي)  /opsx:archive

الخطوتان 1 و 2 تحدثان في طرفيتك. الباقي يحدث في دردشة مساعد الذكاء الاصطناعي الخاص بك. هذا التقسيم هو الشيء الوحيد الذي يستحق الحفظ، وكيف تعمل الأوامر يشرح بالضبط السبب. الخطوة 3 اختيارية، لكن البدء بـ /opsx:explore عندما تكون غير متأكد هو العادة الأكثر أهمية لتكوينها.

أين تجد المساعدة أيضاً ​

• Discord: discord.gg/YctCnvvshC للأسئلة، الأفكار، والمساعدة.
• مشكلات GitHub: github.com/Fission-AI/OpenSpec/issues للأخطاء وطلبات الميزات.
• openspec feedback "رسالتك" يرسل الملاحظات مباشرة من طرفيتك (يفتح مشكلة على GitHub).

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