سير العمل الأول بالمواصفات
حدد المتطلبات قبل كتابة أي كود.
OpenSpecالتطوير القائم على المواصفات لمساعدي الذكاء الاصطناعي
مواصفات خفيفة الوزن لبناء وإدارة مشاريع مساعدي الذكاء الاصطناعي.
مرحباً بك. هذا هو المقر الرئيسي لكل ما يتعلق بـ OpenSpec.
يساعدك OpenSpec أنت ومساعد البرمجة بالذكاء الاصطناعي الخاص بك على الاتفاق على ما ستقوم ببنائه قبل كتابة أي كود. أنت تصف التغيير المطلوب، يقوم الذكاء الاصطناعي بإعداد مسودة قصيرة للمواصفات وقائمة مهام، تنظران معاً إلى نفس الخطة، ثم يبدأ العمل. لن تضطر بعد الآن إلى اكتشاف في منتصف الطريق أن الذكاء الاصطناعي بنى الشيء الخطأ.
إذا لم تقرأ أي شيء آخر، فاقرأ هاتين الصفحتين:
/opsx:propose (تلميح: في محادثة الذكاء الاصطناعي الخاصة بك، وليس في الطرفية). يخطئ الجميع تقريباً في هذا الأمر مرة واحدة على الأقل.هذا الأمر الثاني أهم مما يبدو. يحتوي OpenSpec على نصفين: أداة سطر أوامر تعملها في الطرفية، وأوامر مائلة تعطيها لمساعد الذكاء الاصطناعي الخاص بك. معرفة الفرق بينهما توفر لك اللحظة الأكثر شيوعاً من الارتباك.
أفضل عادة يمكنك بناؤها أولاً: عندما لا تكون متأكداً مما ستقوم ببنائه، ابدأ بـ
/opsx:explore. إنه شريك تفكير بدون مخاطر يقرأ الكود الخاص بك، يقيّم الخيارات، ويُصقل الفكرة الغامضة إلى خطة ملموسة قبل وجود أي artifacts أو كود. يشرح دليل استكشف أولاً هذه الفائدة.
أنا جديد تماماً. ابدأ بـ ابدأ الآن، ثم تصفح بسرعة المفاهيم الأساسية في لمحة. عندما يبدو لك شيء غامض، ستجد الأسئلة الشائعة والمصطلحات قريبين.
لدي مشكلة ولكن ليس لدي خطة. هذه هي الحالة الأكثر شيوعاً، ولها إجابة مخصصة: استكشف أولاً. استخدم /opsx:explore للتفكير في الأمر مع الذكاء الاصطناعي قبل الالتزام بأي شيء.
لدي قاعدة كود كبيرة موجودة بالفعل. لست بحاجة إلى توثيق كلها. يشرح لك استخدام OpenSpec في مشروع موجود بالفعل كيف تبدأ مع كود موجود مسبقاً دون محاولة غلي المحيط.
أريد فقط أن أجعلها تعمل. اذهب إلى التثبيت، قم بتشغيل openspec init، ثم اقرأ كيف تعمل الأوامر لكي يصل أمرك المائل الأول إلى المكان الصحيح.
أتعلم من خلال الأمثلة. تمشي صفحة الأمثلة والوصفات مع تغييرات حقيقية من البداية إلى النهاية: ميزة صغيرة، إصلاح عيب، إعادة هيكلة، استكشاف.
الذكاء الاصطناعي للتو أعد مسودة خطة — ماذا الآن؟ اقرأها. يشرح لك مراجعة التغيير الفحص السريع الذي يستغرق دقيقتين ويقوم بالتقاط الانحراف الخطأ قبل أن يصبح مكلفاً، ويغطي كتابة مواصفات جيدة ما الذي تتكون منه الخطة التي تستحق الموافقة.
أعمل ضمن فريق. يشرح لك OpenSpec ضمن فريق كيف يتم تعيين التغيير إلى فرع وطلب سحب، وكيف يراجع أعضاء الفريق الخطة قبل كتابة الكود.
أنا قادم من سير العمل القديم. يشرح لك دليل الترحيل ما الذي تغير ولماذا، ويؤكد لك أن عملك الحالي آمن.
أريد تكييفه ليناسب عملية فريقك. يغطي قسم التخصيص إعدادات المشروع، المخططات المخصصة، والسياق المشترك.
حدث عطل ما. يجمع قسم استكشاف الأخطاء وإصلاحها الأعطال التي يواجهها الناس فعلياً، مع الحلول الخاصة بها.
| المستند | ما يقدمه لك |
|---|---|
| ابدأ الآن | التثبيت، التهيئة، وتشغيل أول تغيير لك من البداية إلى النهاية |
| استكشف أولاً | استخدم /opsx:explore للتفكير في الفكرة قبل الالتزام بها |
| كيف تعمل الأوامر | المكان الذي تعمل فيه الأوامر المائلة، ماذا يعني "الوضع التفاعلي"، الفرق بين الطرفية والمحادثة |
| المفاهيم الأساسية في لمحة | النموذج الذهني بالكامل في صفحة واحدة: المواصفات، التغييرات، الدلتا، الأرشيف |
| التثبيت | npm، pnpm، yarn، bun، Nix، وكيف تتحقق من أن التثبيت نجح |
| المستند | ما يقدمه لك |
|---|---|
| سير العمل | الأنماط الشائعة ومتى تستخدم كل أمر |
| الأمثلة والوصفات | جولات كاملة لتغييرات حقيقية، قابلة للنسخ واللصق |
| كتابة مواصفات جيدة | كيف تبدو المتطلبات القوية والسيناريوهات، وكيف تحدد الحجم المناسب للتغيير |
| مراجعة التغيير | الفحص السريع الذي يستغرق دقيقتين للخطة المسودة قبل كتابة أي كود |
| OpenSpec ضمن فريق | كيف تتوافق التغييرات مع الفروع، طلبات السحب، والمراجعة |
| استخدام OpenSpec في مشروع موجود بالفعل | اعتماد OpenSpec على قاعدة كود كبيرة قديمة موجودة مسبقاً |
| تحرير وتكرار التغيير | تحديث الـ artifacts، العودة للخلف، التوفيق بين التعديلات اليدوية |
| الأوامر | مرجع لكل أمر مائل /opsx:* |
| CLI | مرجع لكل أمر طرفي openspec |
| المستند | ما يقدمه لك |
|---|---|
| المفاهيم | الشرح المفصل للمواصفات، التغييرات، الـ artifacts، المخططات، والأرشيف |
| سير عمل OPSX | لماذا سير العمل مرن بدلاً من أن يكون مقيداً بالمراحل، بالإضافة إلى غوص عميق في البنية المعمارية |
| المصطلحات | تعريف كل مصطلح في مكان واحد |
| المستند | ما يقدمه لك |
|---|---|
| التخصيص | إعدادات المشروع، المخططات المخصصة، والسياق المشترك |
| متعدد اللغات | إنشاء الـ artifacts بلغات غير الإنجليزية |
| الأدوات المدعومة | أكثر من 25 أداة ذكاء اصطناعي يتكامل معها OpenSpec، والمكان الذي تصل إليه الملفات |
| المستند | ما يقدمه لك |
|---|---|
| الأسئلة الشائعة | إجابات سريعة للأسئلة التي يطرحها الناس أكثر ما يمكن |
| استكشاف الأخطاء وإصلاحها | حلول ملموسة للأعطال الملموسة |
| دليل الترحيل | الانتقال من سير العمل القديم إلى OPSX |
| المستند | ما يقدمه لك |
|---|---|
| المتاجر: دليل المستخدم | وضع الخطة في مستودع خاص بها عندما يمتد عملك عبر مستودعات أو فرق متعددة |
| عقد الوكيل | أسطح واجهة سطر الأوامر القابلة للقراءة آلياً التي تعمل بها الوكلاء |
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 عندما لا تكون متأكداً هي العادة الأكثر استحقاقاً للتبني.
openspec feedback "your message" يرسل الملاحظات مباشرة من الطرفية الخاصة بك (يفتح مشكلة على GitHub).وجدت شيئاً في هذه الوثائق خاطئاً، قديماً، أو غامضاً؟ هذا عطل. افتح مشكلة أو طلب سحب. تحسينات الوثائق هي بعض من أكثر المساهمات قيمة التي يمكنك تقديمها.