الوصف
تقدم «Spec-first Agentic Development» نهجًا منظمًا للعمل مع وكلاء البرمجة الذكية، مما يضمن أن كل تغيير يبدأ بمواصفة محددة بوضوح ومراجعة. تهدف هذه المنهجية إلى تعزيز موثوقية وصيانة الشيفرة التي تم تطويرها بواسطة وكلاء الذكاء الاصطناعي من خلال دمج الإشراف البشري والفحوصات الآلية طوال دورة حياة التطوير.
قراءة المزيد
المبدأ الأساسي يتضمن بدء كل مهمة تطوير بمواصفة مكتوبة مخزنة في المستودع. توضح هذه المواصفة الهدف، الحقائق ذات الصلة (بما في ذلك مراجع الملفات والأسطر)، الخطوات الواجب اتخاذها، ومعايير 'الانتهاء' الدقيقة. قبل كتابة أي شيفرة، يقوم مراجع جديد بفحص المواصفة مقابل قاعدة الشيفرة الموجودة للتحقق من دقتها وقابليتها للتنفيذ. بمجرد الموافقة، يتقدم وكيل الذكاء الاصطناعي لبناء الميزة على فرعه المعزول وبيئة العمل الخاصة به. يُسمح بالالتزام النهائي بالوصول إلى المستودع الرئيسي فقط بعد اجتياز جميع الفحوصات والاختبارات المحددة مسبقًا، مما يضمن جودة الشيفرة والامتثال للمواصفة.
يختلف هذا النظام بشكل كبير عن «برمجة الإحساس» التقليدية من خلال استبدال المطالبات العشوائية بمواصفة مراجعة ودائمة. يسجل كل قرار يتخذه الوكيل مع تفسيره، مما يوفر مسار تدقيق واضح ويقلل من الحاجة إلى توثيق ما بعد التطوير. تم تصميم المواصفات لتحديد النية والهندسة بدلاً من أن تكون مولدات شيفرة دقيقة بشكل مفرط، مع توفير الاختبارات وحواجز الالتزام الدقة اللازمة. تُعامل المواصفات القديمة كسجلات تغيير غير قابلة للتغيير، مشابهة للالتزامات، ولا يتم تحديثها، مما يمنع التآكل.
تدعم «Spec-first Agentic Development» التطوير المتوازي، مما يسمح لعدة وكلاء بالعمل على مواصفات مختلفة في نفس الوقت باستخدام معرفات فروع وبيئات عمل فريدة. العملية غير منقطعة، حيث تجيب المواصفات المراجعة مسبقًا على الأسئلة المفتوحة، مما يمكّن الوكلاء من البناء مباشرةً وفقًا لمعايير الانتهاء. يتم هيكلة سير العمل بالكامل، حيث تتوافق مواصفة واحدة مع فرع واحد والتزام واحد، مما يبسط طلبات السحب ويضمن الاتساق. يتم الحفاظ على الحالة في `context.yaml`، مما يجعل العمل قابلاً للاستئناف حتى بعد إعادة التشغيل.
الطريقة، والقوالب، وملحق «Claude Code» جميعها مرخصة بموجب MIT، مما يجعلها حلاً خاليًا من التكاليف. بينما يقوم ملحق «Claude Code» بأتمتة وظائف المحاسبة والحواجز، يمكن أيضًا اعتماد المنهجية مع وكلاء آخرين مثل «Codex»، و«Cursor»، أو «Copilot» من خلال اتباع `AGENTS.md` وتثبيت خطاف git commit-msg للحاجز. تم تطوير هذه الطريقة وتنقيحها من خلال إنشاء «Agent Smith»، وهو مصنع برمجي مفتوح المصدر، مما يوضح تطبيقها العملي وفعاليتها.
- الفئةمساعدو البرمجة بالذكاء الاصطناعي
- نموذج التسعيرمجاني
- النشرسحابي
- المنصاتالويب
الميزات الأساسية لـ Spec-first Agentic Development
تطوير مدفوع بالمواصفات لوكلاء البرمجة الذكية
مواصفات مراجعة تم التحقق منها مقابل الشيفرة قبل البناء
بيئات عمل معزولة لكل مهمة تطوير
التزامات محجوزة تتطلب اجتياز جميع الفحوصات
مواصفات دائمة مخزنة في المستودع
تسجيل القرارات مع التفسير من أجل تتبع الأثر
دعم التطوير المتوازي مع معرفات فروع فريدة
سير عمل قابل للاستئناف مع الحالة المخزنة في context.yaml
طريقة، قوالب، وملحق «Claude Code» مرخصة بموجب MIT
التوافق مع «Codex»، «Cursor»، «Copilot»، والمحطة الطرفية
خطاف git commit-msg لفرض حواجز الالتزام
التحقق الآلي من الأدلة لاستشهادات المواصفات
طلبات سحب منظمة لمواصفة واحدة أو سلسلة من المواصفات
السياقات والقواعد المولدة من قاعدة الشيفرة الموجودة
لا حاجة لكتابة شيفرة يدوية لعملية بناء «Agent Smith»
كيفية استخدام Spec-first Agentic Development؟
تثبيت الملحق/الخطاف: قم بتثبيت ملحق «Claude Code» أو خطاف git commit-msg في نسخة مشروعك.
تهيئة المشروع: قم بتشغيل /spec-first:bootstrap-project لتوليد السياقات والقواعد من الشيفرة الموجودة لديك.
إنشاء المواصفة: حدد مهمة جديدة مع هدف، خطوات، حقائق، ومعايير الانتهاء باستخدام مهارة create-spec.
مراجعة المواصفة: اجعل مراجعًا جديدًا يتحقق من المواصفة مقابل الشيفرة من أجل الدقة والقابلية للتنفيذ.
تطبيق المواصفة: يقوم الوكيل ببناء المواصفة على فرعه وبيئة عمله الخاصة، وفقًا لقواعد المشروع.
تسليم المواصفة: قم بالتزام التغييرات من خلال الحاجز، مع التأكد من اجتياز جميع الفحوصات، وافتح طلب سحب.
تسليم السلسلة: للتغييرات الأكبر، استخدم /spec-first:deliver-series لإدارة وتسليم عدة مواصفات مترابطة.
حالات استخدام Spec-first Agentic Development
- تطوير شيفرة وكيل الذكاء الاصطناعي
- ضمان جودة الشيفرة
- إدارة المشاريع المعقدة
- تعزيز تتبع الشيفرة
- تسهيل مراجعات الشيفرة
- أتمتة سير عمل التطوير
- توجيه المطورين الجدد
- التكامل مع الأدوات الموجودة
