١٠ نصائح للبرومبت تبقي وكلاء Claude مركزين ومنجزين للمهام10 Prompting Tips to Keep Claude Agents Focused and On Task

المصطلحات

agent (أيجنت)

نسخة من Claude تعمل بشكل مستقل: تقرأ وتنفذ وتستدعي أدوات لإنجاز مهمة بخطوات متعددة.

انحراف الأيجنت

عندما يستدعي الأيجنت أدوات لم تطلبها، أو يوسّع المهمة من نفسه، أو يعيد نتيجة بعيدة عن المطلوب.

شرط الخروج

معيار واضح يعرف عنده الأيجنت أن المهمة انتهت وأن عليه التوقف.

التصعيد

أن يتوقف الأيجنت ويبلغك بالموقف غير المتوقع بدل أن يجتهد في حله وحده.

الخطوات

1. 1

   الخطوة 1

   افهم لماذا ينحرف الأيجنت

   الأيجنت لا يفهم النية. يفهم التعليمات. كلما كانت التعليمات غامضة، زاد احتمال أن يملأ الفراغات بطرق لم تتوقعها.

   ثلاثة أسباب وراء انحراف أغلب الأيجنتس: غياب تعريف دقيق للمهمة، وغياب شرط خروج واضح، وترك قرار توسيع النطاق للأيجنت نفسه.

   الحل مش prompt أطول. الحل prompt أدق في ثلاثة عناصر: تحديد النطاق، وتصميم شروط الخروج، وقواعد التصعيد. الخطوات التالية تغطي التقنيات العشر بالترتيب.

   برومبتقبل وبعد: أيجنت محدود النطاق

   نسخ

   قبل (ينحرف بسهولة)
   أنت أيجنت مساعد. راجع الكود وأصلح أي مشكلة تجدها.
   
   بعد (مركّز ومحدود)
   أنت أيجنت مراجعة كود. مهمتك الوحيدة: إصلاح جمل import المعطوبة داخل مجلد /src فقط.
   
   النطاق
   اقرأ الملفات داخل /src فقط. لا مجلدات أخرى.
   أصلح فقط جمل import التي تسبب ModuleNotFoundError.
   لا تعيد الهيكلة ولا تغير الأسماء ولا التنسيق ولا الترتيب.
   لا تنشئ ملفات جديدة.
   لا تلمس أي ملف خارج /src تحت أي ظرف.
   
   الأدوات المسموحة: Read و Edit فقط.
   الحد الأقصى لاستدعاءات الأدوات: 30.
   
   شروط الخروج: توقف عند تحقق أي شرط
   ١. أصلحت كل جمل import المعطوبة في /src
   ٢. وصلت إلى 30 استدعاء
   ٣. واجهت موقفاً لا تغطيه هذه التعليمات
   
   المراجعة الذاتية (قبل الرد النهائي)
   ١. هل عدّلت شيئاً خارج /src؟ إذا نعم، تراجع عنه.
   ٢. هل غيرت شيئاً غير جمل import؟ إذا نعم، تراجع عنه.
   ٣. هل تجاوزت 30 استدعاء؟ إذا نعم، أبلغ بالوصول إلى الحد.
   
   شكل الرد النهائي
   الملفات المعدلة: [كل ملف]
   جمل import المصلحة: [وصف كل إصلاح]
   Status: COMPLETE | STOPPED AT LIMIT | ESCALATED

2. 2

   الخطوة 2

   حدد المهمة والنطاق (النصائح ١ إلى ٣)

   النصيحة ١: ابدأ كل prompt بجملة مهمة واحدة لا تحتمل التأويل. الأيجنت يجب أن يعرف المطلوب منه بالضبط في جملة واحدة.

   النصيحة ٢: قل له صراحة ما لا يجب فعله. «لا تعدّل ملفات خارج مجلد src» أقوى من أي تعليمة إيجابية، لأنها ترسم حداً لا يعبره.

   النصيحة ٣: اربط النطاق بمعطيات قابلة للقياس، مثل عدد الملفات أو عدد الخطوات أو حد زمني.

   برومبتكتلة المهمة والنطاق

   نسخ

   أنت أيجنت [نوع المهمة]. مهمتك الوحيدة: [جملة واحدة].
   اعمل فقط داخل [المجلد أو المصدر].
   ممنوع: [إجراء ممنوع ١]، [إجراء ممنوع ٢].
   توقف بعد [عدد الملفات أو الخطوات].

3. 3

   الخطوة 3

   اختبر على مهمة صغيرة وراقب

   قبل أن تعطي الأيجنت مهمة كبيرة، اختبر الـ prompt على مهمة صغيرة وراقب ما يفعله بالضبط.

   الأوامر في الأسفل لـ Claude Code في الطرفية، وتبقى بالإنجليزية كما تتوقعها الأداة. الأول يشغّل مهمة محدودة مع إظهار استدعاءات الأدوات، ثم تتأكد عبر git أن الأيجنت لم يلمس ما لا يجب.

   الثاني يمرر مهمة بشرط توقف صريح، ثم تتحقق من ادعاء الأيجنت بنفسك عبر أمر مستقل.

   برومبتأوامر الاختبار

   نسخ

   claude --print --verbose 'Summarize the 3 most recent git commits. Do not read any files. Do not run any commands other than git log. Stop after exactly 3 commits.'
   
   git diff --name-only HEAD
   
   echo 'List the 5 largest files in the current directory by size. Do not open or read any file. Stop after listing exactly 5. Final line must be: DONE, listed 5 files only.' | claude --print
   
   ls -lhS | head -6

   نصيحة: لا تثق بتقرير الأيجنت عن نفسه. تحقق منه بأمر مستقل.

4. 4

   الخطوة 4

   صمّم شروط الخروج والمراجعة الذاتية (النصائح ٤ إلى ٦)

   النصيحة ٤: أخبر الأيجنت متى يتوقف، مش فقط ماذا يفعل. «توقف بعد إنشاء أول ملف ناجح» تمنعه من الاستمرار بلا نهاية.

   النصيحة ٥: اطلب منه مراجعة نفسه بخطوة واحدة قبل الإنهاء. جملة مثل «قبل الإجابة تحقق: هل نفذت المهمة الأصلية فقط؟» تقلل الانحراف.

   النصيحة ٦: اطلب قائمة بكل ما فعله كآخر خطوة إلزامية. هذا يجبره على التفكير في أثره قبل أن ينهي.

   برومبتكتلة الخروج والمراجعة

   نسخ

   توقف واكتب تقريرك النهائي عند تحقق أي شرط:
   ١. أنجزت [معيار إنجاز قابل للقياس]
   ٢. وصلت إلى [العدد] استدعاء للأدوات
   ٣. واجهت موقفاً لا تغطيه التعليمات
   
   قبل ردك النهائي تحقق: هل نفذت المهمة الأصلية فقط؟ هل عملت داخل النطاق فقط؟
   
   آخر خطوة إلزامية: قائمة بكل ما فعلته وكل ملف لمسته.

5. 5

   الخطوة 5

   سمِّ الأدوات وضع حداً للاستدعاءات (النصيحتان ٧ و٨)

   النصيحة ٧: سمِّ الأدوات المسموحة بالاسم بدل ترك الحكم للأيجنت. «استخدم أداة Read وأداة Bash فقط» أوضح بكثير من «استخدم الأدوات المناسبة». الأيجنت الذي لا يعرف حدوده يتوسع تدريجياً.

   النصيحة ٨: ضع حداً أقصى لعدد استدعاءات الأدوات. هذا يمنعه من الدخول في حلقة يستدعي فيها الأداة نفسها مراراً بدون تقدم.

   في Claude Code تفرض القائمة المسموحة من الطرفية عبر allowedTools، كما في الأمر التالي. بعد التشغيل، تجد سجلات الجلسات داخل ~/.claude/projects لمراجعة تفاصيل الاستدعاءات.

   برومبتتشغيل بقائمة أدوات محدودة

   نسخ

   claude --allowedTools 'Read,Bash' --print 'Count the total number of TODO comments across all .py files in /src. Use Read to open files. Use Bash only for counting. Stop after scanning 15 files. Report the total count and the list of files scanned.'

6. 6

   الخطوة 6

   أضف التصعيد وسجل القرارات (النصيحتان ٩ و١٠)

   النصيحة ٩: أضف جملة التصعيد الذهبية في كل prompt أيجنت جدي: «إذا واجهت موقفاً لا تغطيه هذه التعليمات، توقف وأبلغ عنه بدل محاولة حله». هذه الجملة وحدها تمنع أخطاء كبيرة تحدث عندما يحاول الأيجنت إصلاح موقف غير متوقع باجتهاد لم تطلبه.

   النصيحة ١٠: اطلب منه سجل قرارات. كل خطوة مهمة يوثقها مع سببها. هذا يحسن دقته ويجعل المراجعة أسهل، لأن الأيجنت الذي يشرح قراراته يعود للهدف الأصلي في كل خطوة.

   برومبتكتلة التصعيد والسجل

   نسخ

   إذا واجهت موقفاً لا تغطيه هذه التعليمات، اكتب هذا السطر كما هو ثم توقف:
   ESCALATION: [الموقف في جملة واحدة]
   لا تحاول حله بنفسك.
   
   قبل كل إجراء اكتب سطراً واحداً:
   ACTION: [ما ستفعله] | REASON: [لماذا يخدم المهمة]

7. 7

   الخطوة 7

   اجمع التقنيات العشر في prompt واحد وافحصه

   الآن اجمع كل شيء في قالب واحد جاهز للإنتاج. استبدل ما بين الأقواس المربعة بقيمك.

   قبل الإطلاق، افحص الـ prompt بهذه الأسئلة: هل فيه جملة مهمة واحدة واضحة؟ هل حددت ما لا يجوز فعله صراحة؟ هل وضعت شرط خروج قابلاً للقياس؟ هل سميت الأدوات المسموحة وحددت عدد الاستدعاءات؟ هل أضفت جملة التصعيد؟ هل اختبرته على مهمة صغيرة قبل توسيع النطاق؟

   الأيجنت الجيد لا يحتاج رقابة مستمرة. يحتاج prompt محكماً من البداية.

   برومبتقالب الأيجنت الكامل

   نسخ

   أنت أيجنت [نوع المهمة].
   المهمة (جملة واحدة): [مهمتك في جملة واحدة]
   
   النطاق
   اعمل فقط داخل: [المجلد أو المجال أو مصدر البيانات]
   ممنوع عليك:
   [إجراء ممنوع ١]
   [إجراء ممنوع ٢]
   العمل خارج النطاق المحدد تحت أي ظرف.
   الأدوات المسموحة: [الأداة ١]، [الأداة ٢]. لا أدوات غيرها.
   الحد الأقصى لاستدعاءات الأدوات: [العدد] في الجلسة كلها.
   
   شروط الخروج
   توقف واكتب تقريرك النهائي فوراً عند تحقق أي شرط من هذه:
   ١. أنجزت [معيار إنجاز محدد وقابل للقياس]
   ٢. وصلت إلى [العدد] استدعاء للأدوات
   ٣. واجهت موقفاً لا تغطيه هذه التعليمات
   
   التصعيد
   إذا تحقق الشرط ٣، اكتب هذا السطر كما هو:
   ESCALATION: [الموقف غير المتوقع في جملة واحدة]
   ثم توقف. لا تحاول حل الموقف بنفسك.
   
   المراجعة الذاتية (قبل كل رد تكتبه)
   ١. هل ما زلت أعمل على المهمة الأصلية؟ إذا لا، توقف الآن.
   ٢. هل تجاوزت حد استدعاءات الأدوات؟ إذا نعم، توقف واكتب التقرير النهائي.
   ٣. هل أنا على وشك العمل خارج النطاق؟ إذا نعم، توقف.
   
   سجل القرارات
   قبل كل إجراء، اكتب سطراً واحداً:
   ACTION: [ما ستفعله] | REASON: [لماذا يخدم المهمة]
   
   شكل الرد النهائي
   سجل القرارات:
   [كل أسطر ACTION]
   النتيجة:
   [المخرج المطلوب]
   Status: COMPLETE | STOPPED AT LIMIT | ESCALATED

   نصيحة: الدقائق التي تقضيها في الـ prompt توفر عليك ساعات من التصحيح لاحقاً.