spec-kit

Spec Kit هي مجموعة أدوات مفتوحة المصدر من GitHub تساعد الفرق على استخدام التطوير المدفوع بالمواصفات (SDD) مع وكلاء البرمجة بالذكاء الاصطناعي. فبدلاً من التعامل مع المواصفات كسقالات مؤقتة، يجعل SDD المواصفات قابلة للتنفيذ: فهي تولّد تطبيقات عاملة مباشرة. وتوفر مجموعة الأدوات عملية جاهزة للاستخدام مدفوعة بالمواصفات يمكن تخصيصها أو استبدالها بسير العمل الخاص بك. المكوّن الرئيسي هو Specify CLI، ويُثبَّت عبر uv أو PyPI. بعد تشغيل `specify init`، يقوم بإعداد مشروع وتثبيت أوامر الشرطة المائلة أو مهارات الوكيل لوكلاء البرمجة بالذكاء الاصطناعي الشائعين. تشمل عمليات التكامل المدعومة أكثر من 30 وكيل برمجة قائماً على CLI وIDE، مثل Copilot وCodex وClaude Code وغيرها. تتبع أوامر الشرطة المائلة الأساسية سير عمل منظماً: - `/speckit.constitution` — إنشاء مبادئ المشروع وإرشادات التطوير - `/speckit.specify` — تحديد ما يجب بناؤه (المتطلبات وقصص المستخدم) - `/speckit.plan` — إنشاء خطة تنفيذ تقنية - `/speckit.tasks` — تقسيم الخطة إلى مهام قابلة للتنفيذ - `/speckit.taskstoissues` — تحويل المهام إلى قضايا GitHub - `/speckit.implement` — تنفيذ المهام لبناء الميزة - `/speckit.converge` — مقارنة التنفيذ بالمواصفات والخطة والمهام، وإضافة العمل المتبقي كمهام جديدة تشمل الأوامر الاختيارية `/speckit.clarify` لتوضيح المجالات غير المحددة بشكل كافٍ، و`/speckit.analyze` لفحوصات الاتساق عبر المخرجات، و`/speckit.checklist` لقوائم التحقق المخصصة للجودة. يتضمن المستودع أيضاً إضافات اختيارية. تضيف إضافة إصلاح الأخطاء سير عمل تقييم → إصلاح → اختبار لإصلاحات أخطاء محددة النطاق قائمة على الأدلة. وتوفر إضافة تقييم الأفكار سير عمل استقبال → بحث → تعريف → تشكيل → قرار لتحويل الأفكار الخام إلى قرارات موثقة بالمضي قدماً / الحاجة إلى توضيح / الإلغاء. يُدعم التخصيص عبر ثلاث آليات: تضيف الإضافات أوامر وقوالب جديدة، وتتجاوز الإعدادات المسبقة كيفية تصرف القوالب والأوامر الحالية، وتحزم الحزم مجموعات منسقة من الإضافات والإعدادات المسبقة والخطوات وسير العمل في إعدادات قائمة على الأدوار (مثل مدير المنتج، ومحلل الأعمال، وباحث الأمن، والمطور). وتسمح التجاوزات المحلية للمشروع بإجراء تعديلات لمرة واحدة. تُحل القوالب في وقت التشغيل، بينما تُطبق أوامر الإضافات والإعدادات المسبقة في وقت التثبيت. يتضمن Spec Kit أيضاً أوامر إدارة ذاتية مثل `specify self check` و`specify self upgrade --dry-run` و`specify self upgrade`، مع خيارات لتثبيت وسوم إصدارات محددة. تشمل موارد المجتمع الإضافات والإعدادات المسبقة والحزم والأدلة التفصيلية والمشاريع ذات الصلة على موقع الوثائق. ويستخدم المشروع نفسه بنفسه: إذ يستخدم المشرفون Spec Kit عند تطوير Spec Kit، لا سيما للميزات الكبيرة، عبر سير عمل آلي لتقييم الميزات.