وكلاء البرمجة بارعون في العمل الطويل والمحدّد والممل: إضافة اختبارات لخمسين وحدة، أو نقل كل مواضع الاستدعاء إلى API جديدة، أو إصلاح ألف تحذير lint. هذا النوع من العمل لا يحتاج إلى مراقبتك. بل يحتاج إلى مكان آمن للتشغيل، ومهمة واضحة، وحراس يمنعون التعثّر، وطريقة لمراجعة النتيجة مع قهوة الصباح.
هذه قائمة تحقق لإعداد ذلك.
1. كيف تعزل وكيلًا يعمل دون مراقبة؟
الوكيل الذي يعمل دون مراقبة يشغّل أوامر صدفة لا يوافق عليها أحد. افترض أنه سيشغّل في النهاية شيئًا لم تكن لتشغّله: يحذف المجلد الخطأ، أو يثبّت حزمة، أو يدفع إلى مستودع بعيد. فاحتوِه.
- حاوية أو آلة افتراضية، لا حساب المستخدم الرئيسي في حاسوبك. تغطي وثائق الأمان في Docker الضوابط؛ وكحد أدنى شغّله كمستخدم غير root، وأسقط الصلاحيات (capabilities) التي لا تحتاجها.
- اربط المستودع فقط. لا مجلد منزلي، ولا مفاتيح SSH، ولا بيانات اعتماد سحابية، ولا
~/.configمليء بالرموز السرية. - لا أسرار إنتاج. استخدم قواعد بيانات اختبار ومفاتيح API وهمية. وإذا احتاج الوكيل إلى خدمة حقيقية، فأعطه مفتاحًا محدود النطاق قابلًا للإبطال.
- قيّد الشبكة. يحتاج الوكيل إلى واجهة النموذج وربما إلى سجلّ حزم. ونادرًا ما يحتاج إلى أي شيء آخر.
- لا صلاحيات دفع. دعه يودِع محليًا، وادفع أنت بعد المراجعة.
مفتاح API الخاص بالنموذج هو بيانات الاعتماد الوحيدة التي يجب أن يملكها الوكيل. استخدم مفتاحًا مُنشأً لهذا الغرض، وإذا كان مزوّدك يدعم ذلك، فقيّده بعنوان IP الخارجي لبيئة العزل. تدعم مفاتيح BroadNet قوائم السماح لعناوين IP بحد أقصى 32 مدخلًا، فيصبح المفتاح المسرَّب عديم الفائدة من أي مكان آخر.
2. لماذا تمنح كل وكيل فرعه الخاص؟
اعمل على فرع مخصّص، لا على main أبدًا. وإذا شغّلت أكثر من وكيل، فأعطِ كلًّا منها مجلد عمل خاصًا به باستخدام git worktree:
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
كل worktree نسخة عمل مستقلة من المستودع نفسه، فلا يكتب الوكلاء فوق ملفات بعضهم، ويُظهر كل فرع بالضبط ما فعله وكيل واحد.
ثم أودِع بعد كل خطوة مكتملة. يفعل Aider ذلك افتراضيًا. وللوكلاء الآخرين، أضفه إلى التعليمات أو أحِط الحلقة بحيث يحدث إيداع كلما نجحت الاختبارات. وتاريخ من الإيداعات الصغيرة يحوّل عبارة “كسر الوكيل شيئًا في الثالثة فجرًا” إلى “الإيداع 14 كسره؛ احتفظ بالإيداعات من 1 إلى 13”.
3. ماذا يحوي ملف المهمة؟
الأمر المكوّن من سطر واحد الذي ينجح تفاعليًا يفشل ليلًا، لأنه لا أحد هناك ليجيب عن أول سؤال يطرحه الوكيل. اكتب ملف مهمة:
# Task: add unit tests to src/billing/
## Goal
Every public function in src/billing/ has at least one unit test.
## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit
## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.
## Notes
Append decisions and skipped items to NOTES.md as you go.
قسم “Done when” (متى تكتمل المهمة) هو الجزء المهم. فهو يمنح الوكيل طريقة لمعرفة أنه انتهى، ويمنحك طريقة للتحقق. ويؤدي ملف الملاحظات دور الذاكرة أيضًا إذا أُعيد التشغيل أو ضُغط السياق؛ راجع إدارة السياق للوكلاء طويلي التشغيل.
4. ما الحراس الذين يوقفون وكيلًا عالقًا؟
“دون مراقبة” يعني أن أحدًا لن يلاحظ الوكيل العالق حتى الصباح. أربعة حراس:
- حد أقصى للخطوات. عدد أقصى ثابت لاستدعاءات النموذج في كل مهمة.
- موعد نهائي. توقّف عند وقت محدد بالساعة، مثل 07:00، أيًا كانت الحالة.
- كشف التكرار. توقّف حين يعيد استدعاء الأداة نفسه النتيجة نفسها ثلاث مرات، أو حين لا يتغيّر أي ملف لعدد محدد من الخطوات.
- مهلة لكل أداة. لا ينبغي أن تُعلّق مجموعة اختبارات متوقفة الليلة كلها.
وحين يُطلق أحد الحراس، ينبغي أن يكتب الوكيل السبب في ملف الملاحظات ويخرج بشكل نظيف. ويشرح دليل تكلفة وكلاء البرمجة، في قسم حدّد سقفًا للخطوات في كل مهمة، لماذا تهم حدود الخطوات وحدود إعادة المحاولة في التكلفة.
ومن السهل تشغيل Aider بهذه الطريقة: إذ تعرض وثائق السكربتات الخيار --message لتشغيل تعليمة واحدة ثم الخروج، و--yes-always لقبول طلبات التأكيد تلقائيًا. أحِط ذلك بحلقة صدفة على قائمة مهام، مع timeout حول كل تشغيل، فيصبح لديك طابور ليلي بسيط.
5. أيهما أرخص ليلًا: جلسة خطة أم الفوترة لكل رمز؟
التشغيل الليلي يغيّر سؤال التكلفة. فلا أحد يراقب العدّاد، والوكيل العالق قد يدور في حلقة لساعات.
على مفتاح بالفوترة لكل رمز، تعتمد التكلفة على مقدار ما يرسله الوكيل. والوكلاء يعيدون إرسال السياق في كل خطوة، فيتراكم تشغيل مدته ثماني ساعات. ويساعد التخزين المؤقت للأوامر كثيرًا (المدخلات المخزَّنة مؤقتًا على DeepSeek V4.1 Flash بسعر $0.0055 لكل مليون رمز مقابل $0.175 للمدخلات الجديدة)، لكن رموز الإخراج والاستدلال المنطقي تُحاسَب كاملة. فتحتاج إلى ميزانية رموز لكل تشغيل وحد إنفاق على الحساب.
على جلسة خطة، لا يوجد عدّاد للرموز. فجلسة البدر (Full Moon) بسعر $60 شهريًا لاستخدام غير محدود لـ DeepSeek V4.1 Flash، وهذا هو السقف مهما طال تشغيل الوكيل أو دار في حلقات. وفي العمل الليلي هذه هي الميزة الأساسية: الفاتورة في أسوأ الأحوال معروفة قبل أن تنام.
| مفتاح بالفوترة لكل رمز | جلسة خطة | |
|---|---|---|
| أسوأ تكلفة لليلة عالقة | تزداد مع الرموز | ثابتة عند سعر الخطة |
| الوكلاء المتوازيون | حتى 4 طلبات قيد التنفيذ لكل مفتاح دفع حسب الاستخدام | طلب واحد في كل مرة لكل جلسة |
| النماذج | كل نماذج المحادثة | DeepSeek V4.1 Flash فقط |
| هل ما زلت تحتاج إلى الحراس؟ | نعم، للتكلفة والوقت | نعم، للوقت |
ملاحظتان عمليتان عن الجلسات. تشغّل الجلسة طلبًا واحدًا في كل مرة، فيتناوب وكيلان يتشاركان جلسة واحدة؛ وتعمل المهام على الجلسة الواحدة بالتتابع، وهذا مقبول غالبًا ليلًا. وإذا أردت وكلاء يعملون جنبًا إلى جنب، فاشترِ جلسة لكل وكيل. ويتناول مقال الوكلاء المتوازيون على API بسعر ثابت الحسابات.
وبالسرعة المعتادة البالغة نحو 100 رمز في الثانية، تستطيع جلسة واحدة إنتاج نحو 259 مليون من رموز الإخراج في شهر من الاستخدام المتواصل. أما هل يتفوّق ذلك على التسعير لكل رمز في حالتك، فيعتمد على الحجم؛ ومثال BroadNet المحسوب لوكيل برمجة يعمل بدوام كامل يبلغ نحو $65.40 شهريًا بالدفع حسب الاستخدام. احسب أرقامك في حاسبة السعر الثابت مقابل السعر لكل رمز. كما تحتاج التشغيلات الطويلة دون مراقبة إلى انضباط في السياق وإعادة محاولات تصمد أمام الأعطال: راجع المهل وإعادة المحاولات ونقاط الحفظ.
6. كيف تراجع التشغيل في الصباح؟
لا تتحقق قيمة التشغيل الليلي إلا عند المراجعة. فاجعلها سريعة:
- اقرأ NOTES.md أولًا. ما الذي أنهاه الوكيل، وما الذي تخطّاه، وأين علق؟
- تحقّق من سبب التوقف. انتهى، أم بلغ حد الخطوات، أم الموعد النهائي، أم التكرار؟
- شغّل الاختبارات بنفسك. لا تثق بتقرير الوكيل عن نجاح الاختبارات.
- اقرأ الفروقات إيداعًا إيداعًا. فالإيداعات الصغيرة تجعل التغييرات السيئة سهلة الاكتشاف والحذف.
- ادمج (squash) أو أعد تأسيس (rebase) ما تحتفظ به، ثم افتح طلب دمج عاديًا.
في معظم الصباحات ستحتفظ بمعظم العمل وتصلح بضعة إيداعات يدويًا. وفي الصباحات السيئة تحذف فرعًا. وفي الحالتين، لم يلمس شيء main دونك.
كيف تجرّبه بأمان في الليلة الأولى؟
ابدأ بمهمة واحدة محددة جيدًا، ووكيل واحد، وجلسة واحدة. وساعة من خطة الشهاب (Meteor) ($1) تكفي للتحقق من أن إعداد العزل والفرع والحراس يعمل قبل أن تترك أي شيء يعمل طوال الليل. وللوكيل نفسه، يحوي دليل Aider إعدادات الاتصال الدقيقة، ويساعدك مقال أفضل نموذج مفتوح لوكلاء البرمجة في اختيار نموذج، ويتناول كيف تعمل جلسات الخطط المفاتيح والجلسات.
