نصائح
7 قواعد لكتابة طلبات تعطيك نتائج أدق
الفرق بين طلب غامض وطلب واضح هو الفرق بين محاولة واحدة وعشر محاولات. سبع قواعد عملية لكتابة طلبات لوكيل البرمجة توفّر وقتك ورصيدك.
· 2 دقيقة قراءة
الوكيل ذكي، لكنه مش بيقرا أفكارك. كل معلومة ناقصة في طلبك هيخمّنها، وكل تخمين غلط معناه محاولة جديدة ورصيد زيادة. القواعد السبعة دي هتخلّي أغلب طلباتك تنجح من أول مرة.
1. قول "ماذا" و"لماذا"
بدل "عدّل الزر"، اكتب: "كبّر زر اطلب الآن في الصفحة الرئيسية لأن العملاء على الموبايل مش بيلاحظوه". السبب بيساعد الوكيل ياخد قرارات صح في التفاصيل اللي ما ذكرتهاش.
2. حدد المكان
اسم الملف أو الصفحة أو المكوّن بيوفّر على الوكيل وقت البحث: "في Hero.tsx" أو "في صفحة الإعدادات".
3. ادّي المراجع اللي عندك
رسالة الخطأ كاملة، لقطة شاشة، رابط التوثيق، أو "الألوان موجودة في theme.css". أي معلومة عندك وفّرها بدل ما الوكيل يدوّر عليها.
4. اذكر القيود
- "من غير مكتبات جديدة."
- "ما تغيّرش شكل الـ API."
- "لازم يشتغل على المتصفحات القديمة."
5. اطلب خطة للمهام الكبيرة
للتعديلات الكبيرة ابدأ بـ: "اقترح خطة لتنفيذ نظام الكوبونات من غير ما تكتب كود". راجع الخطة، عدّل عليها، وبعدها اطلب التنفيذ. ولو المهمة طويلة جدًا، استخدم الأمر /goal علشان الوكيل يكمّل عليها عبر عدة جولات.
6. اطلب التحقق
اختم طلبك بـ "شغّل الاختبارات" أو "شغّل البناء وتأكد إنه نجح". كده الوكيل بيكتشف أخطاءه ويصلحها قبل ما يرجع لك.
7. مهمة واحدة لكل محادثة
المحادثات القصيرة المركّزة أدق وأرخص. لما تخلص مهمة، ابدأ محادثة جديدة للمهمة اللي بعدها. ولو المحادثة طولت، استخدم /compact علشان تلخّصها وتكمّل بسياق أصغر.
اكتب بالعربي أو الإنجليزي أو الاتنين مع بعض. المهم الوضوح، مش اللغة.
قبل وبعد
| طلب غامض | طلب واضح |
|---|---|
| صلّح الصفحة | صفحة الدفع بتظهر بيضا على سفاري. الخطأ في الكونسول: … صلّحه وجرّب البناء. |
| ضيف بحث | ضيف خانة بحث في قائمة المنتجات تفلتر بالاسم أثناء الكتابة، من غير طلبات للسيرفر. |
| خلّي الموقع أسرع | قيس حجم صفحة الرئيسية واقترح أكبر 3 أسباب للبطء قبل ما تغيّر حاجة. |
