كيف تمنح وكيل برمجة مواصفة يمكنه تنفيذها

تنجح وكلاء البرمجة أكثر مع خطوات واضحة ونجاح محدد. تصف Microsoft تطويراً موجهاً بالمواصفات حيث تكون المواصفة الحية مصدر الحقيقة، وتتضمن النية ومعايير القبول وتبقى متزامنة مع الكود والاختبارات.

1. اكتب النتيجة

ابدأ بالمستخدم والنتيجة المرئية قبل تحديد الملفات.

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. حدد معايير القبول

أضف المسار الطبيعي والحالات الفارغة والإدخال غير الصالح والصلاحيات والفشل.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. اطلب الفحص والتخطيط

اطلب من الوكيل رسم خريطة للمسارات والمكونات والوصول إلى البيانات والاختبارات، ثم قدم خطة قصيرة وأسئلة مفتوحة. راجع الحفاظ على العقود الحالية.

4. اجعلها قابلة للتنفيذ

ضعها في مستند version-controlled أو issue يتم تحديثه فعلاً، واربط كل معيار باختبار آلي أو فحص يدوي، ونفذ تغييرات صغيرة.

5. أبقِ الإنسان في نقاط القرار

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. حدّثها عند تغير الواقع

إذا كشفت الاختبارات قاعدة جديدة فحدث المواصفة واطلب مواءمة التنفيذ. ابدأ بميزة صغيرة واطلب دليلاً لكل معيار قبل الإكمال.