التوجيه الفعّال لكتابة الشِفرة
الحصول على شِفرة جيّدة من الوكيل لا يعتمد على كلمات سحرية، بل على التحديد الدقيق لـالهدف والقيود — أن توضّح بجلاء ما تريده وما يجب على الوكيل ألّا يفعله.
ما الذي يقوله الطلب الجيّد
يحمل التوجيه القوي لكتابة الشِفرة أربعة أشياء. أغفِل واحداً منها يملأ الوكيل الفراغ بالتخمين.
- الهدف — ما الذي ينبغي أن تفعله الشِفرة، بعبارات واضحة.
- النطاق — أي الملفات تُعدَّل، وما الذي يُترَك دون مساس.
- القيود — الأسلوب والمكتبات والأنماط التي تُتّبع أو تُتجنّب.
- كيف ستتحقّق منها — معايير القبول التي تجعل «الاكتمال» أمراً ملموساً.
ضيِّق نطاقها
مهمة واحدة واضحة أفضل من طلب ضخم غامض. النطاق الصغير أسهل على الوكيل أن يُصيبه — وأسهل عليك أن تتحقّق منه وأن تتراجع عنه حين يخطئ.
حدِّد متى تكتمل
قدِّم معايير القبول منذ البداية. قولُ «تكتمل حين تنجح الاختبارات» أو «تكتمل حين تفعل كذا» يحوّل طلباً غامضاً إلى شيء يمكنك التحقّق منه فعلاً.
- الهدف القابل للتحقّق يتيح للوكيل أن يعرف بنفسه هل نجح.
- وهو يرسّخ مراجعتك — إذ تعرف ما الذي تبحث عنه.
- تمضي الوحدة الرابعة بهذا أبعد: اكتب الاختبار أولاً، ثم اطلب الشِفرة.
توقّع أن تكرّر
المُخرَج الأول مسوّدة توجّهها، لا إجابة نهائية. اقرأه، وأشِر إلى ما هو خطأ، ثم حسِّن. التوجيه الجيّد محادثة — لا جملة واحدة مثالية عليك إصابتها من المحاولة الأولى.
طبّقها
كيف تُطبّقها: خذ طلباً غامضاً مثل «اجعلها أفضل» وأعِد صياغته إلى هدف + نطاق + قيود + معايير قبول — ثم استخدم تلك الصيغة لتوجيه وكيلك.
- متتبّع مهام الذكاء الاصطناعي الأسبوعية — «أضِف نقطة نهاية تُعيد مهام هذا الأسبوع بصيغة JSON، دون المساس بشِفرة المصادقة، وتكتمل حين ينجح هذا الاختبار» توجيهٌ نموذجي.
- موقع علامتك الشخصية — «اكتب قسم المشاريع من هذه المستودعات، بثلاث نقاط لكلٍّ منها، دون أي ادعاءات ليست في المصدر» يبقيه صادقاً ومحدود النطاق.
ما الذي تعلّمته
التوجيه الجيّد لكتابة الشِفرة يذكر الهدف والنطاق والقيود وكيف ستتحقّق منه. ضيِّق النطاق، وعرِّف الاكتمال منذ البداية، وتوقّع أن توجّه المسوّدة.