OpenSpecالتطوير المبني على المواصفات لمساعدي الذكاء الاصطناعي

فلسفتنا:

→ مرن وليس جامد
→ تكراري وليس شلالي
→ سهل وليس معقد
→ مبني للمشاريع القائمة وليس فقط للمشاريع الجديدة
→ قابل للتوسع من المشاريع الشخصية إلى المؤسسات

تابع @0xTab على X للتحديثات · انضم إلى OpenSpec Discord للحصول على المساعدة والأسئلة.

شاهده في العمل ​

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

البدء السريع ​

يتطلب Node.js الإصدار 20.19.0 أو أعلى.

قم بتثبيت OpenSpec عالمياً:

npm install -g @fission-ai/openspec@latest

ثم انتقل إلى دليل مشروعك وقم بالتهيئة:

cd your-project
openspec init

الآن أخبر الذكاء الاصطناعي الخاص بك: /opsx:propose <ما تريد بناءه>

إذا كنت ترغب في سير العمل الموسّع (/opsx:new، /opsx:continue، /opsx:ff، /opsx:verify، /opsx:sync، /opsx:bulk-archive، /opsx:onboard)، حدد باستخدام openspec config profile وطبّق باستخدام openspec update.

التوثيق ​

→ البدء: الخطوات الأولى
→ سير العمل: التجميعات والأنماط
→ الأوامر: أوامر الشرطة المائلة والمهارات
→ واجهة سطر الأوامر: مرجع الطرفية
→ الأدوات المدعومة: تكاملات الأدوات ومسارات التثبيت
→ المفاهيم: كيف تتصل كل الأجزاء
→ متعدد اللغات: الدعم متعدد اللغات
→ التخصيص: اجعله خاصاً بك

لماذا OpenSpec؟ ​

مساعدو البرمجة بالذكاء الاصطناعي قويون لكنهم غير متوقعين عندما تكون المتطلبات موجودة فقط في سجل المحادثات. يضيف OpenSpec طبقة مواصفات خفيفة حتى تتفق على ما يجب بناؤه قبل كتابة أي كود.

• اتفق قبل البناء — يتوافق البشر والذكاء الاصطناعي على المواصفات قبل كتابة الكود
• ابق منظماً — كل تغيير يحصل على مجلده الخاص مع العرض والمواصفات والتصميم والمهام
• اعمل بمرونة — حدّث أي مخرج في أي وقت، لا توجد مراحل تقييدية صارمة
• استخدم أدواتك — يعمل مع أكثر من 20 مساعد ذكاء اصطناعي عبر أوامر الشرطة المائلة

كيف نقارن ​

مقارنة بـ Spec Kit (GitHub) — شامل لكنه ثقيل. مراحل تقييدية صارمة، الكثير من Markdown، إعداد Python. OpenSpec أخف وزناً ويتيح لك التكرار بحرية.

مقارنة بـ Kiro (AWS) — قوي لكنك مقيد ببيئتهم التطويرية ومحصور في نماذج Claude فقط. OpenSpec يعمل مع الأدوات التي تستخدمها بالفعل.

مقارنة بالعدم — البرمجة بالذكاء الاصطناعي بدون مواصفات تعني مطالبات غامضة ونتائج غير متوقعة. يجلب OpenSpec التنبؤ دون الطقوس المعقدة.

تحديث OpenSpec ​

ترقية الحزمة

npm install -g @fission-ai/openspec@latest

تحديث تعليمات الوكيل

قم بتشغيل هذا داخل كل مشروع لإعادة إنشاء إرشادات الذكاء الاصطناعي والتأكد من تفعيل أحدث أوامر الشرطة المائلة:

openspec update

ملاحظات الاستخدام ​

اختيار النموذج: يعمل OpenSpec بشكل أفضل مع النماذج عالية الاستدلال. نوصي بـ Opus 4.5 و GPT 5.2 لكل من التخطيط والتنفيذ.

نظافة السياق: يستفيد OpenSpec من نافذة سياق نظيفة. امسح سياقك قبل البدء في التنفيذ وحافظ على نظافة السياق طوال جلستك.

المساهمة ​

إصلاحات صغيرة — يمكن تقديم إصلاحات الأخطاء، وتصحيح الأخطاء الإملائية، والتحسينات الطفيفة مباشرة كطلبات سحب.

تغييرات أكبر — للميزات الجديدة، أو إعادة الهيكلة الكبيرة، أو التغييرات المعمارية، يرجى تقديم عرض تغيير OpenSpec أولاً حتى نتمكن من التوافق على النية والأهداف قبل البدء في التنفيذ.

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

الكود المولّد بالذكاء الاصطناعي مرحب به — طالما أنه تم اختباره والتحقق منه. يجب أن تذكر طلبات السحب التي تحتوي على كود مولّد بالذكاء الاصطناعي وكيل البرمجة والنموذج المستخدم (على سبيل المثال، "تم التوليد باستخدام Claude Code باستخدام claude-opus-4-5-20251101").

التطوير ​

• تثبيت التبعيات: pnpm install
• البناء: pnpm run build
• الاختبار: pnpm test
• تطوير واجهة سطر الأوامر محلياً: pnpm run dev أو pnpm run dev:cli
• الالتزامات التقليدية (سطر واحد): type(scope): subject

أخرى ​

الترخيص ​

MIT