حل المشكلات مع الوكلاء العامين: دورة مكثفة في 90 دقيقة

7 مبادئ · 4 أدوات · 80% من الاستخدام الحقيقي

---

يفتح شخصان الوكيل نفسه صباح الاثنين. المهمة نفسها: مراجعة مجلد عقود مورّدين، تحديد البنود غير القياسية، وإنتاج مذكرة مقارنة.

ينتهي الشخص الأول خلال 22 دقيقة بمخرج نظيف تم التحقق منه. يقضي الثاني 90 دقيقة في حلقات تصحيح، يلوث السياق، ثم يبدأ من جديد.

الوكيل نفسه. القدرة نفسها. الفرق أن الأول يعرف سبعة أشياء لا يعرفها الثاني. هذه الدورة تعلّم تلك الأشياء.

لمن هذه الدورة؟ لكل من سيستخدم وكيلاً عاماً لحل مشكلة حقيقية: مهندسون يستخدمون Claude Code أو OpenCode، وخبراء مجال يستخدمون Claude Cowork أو OpenWork. المجال يتغير؛ الانضباط لا يتغير.

الوكيل العام زميل ذكاء اصطناعي يتخذ أفعالاً نيابة عنك: يشغل أوامر، يقرأ ملفات، يكتب ملفات، ويستدعي خدمات. ليس chatbot يجيب فقط؛ إنه أداة لها يدان.

الأدوات الأربع:

• الهندسة: Claude Code وOpenCode.
• العمل المعرفي: Claude Cowork وOpenWork.

حيث تختلف الأدوات، استخدم جدول المقارنة. في بقية الدورة، يعمل المبدأ نفسه في الأدوات الأربع.

الأساسيات في خمس نقاط

1. لا تطلب نتيجة كبيرة دفعة واحدة؛ قسّمها إلى وحدات صغيرة قابلة للتحقق.
2. اجعل الأداة تفعل ما تجيده: القراءة، التنفيذ، التحويل، والتحقق.
3. اكتب الحالة المهمة في ملفات، لا في ذاكرة المحادثة فقط.
4. ضع قيوداً واضحة؛ القيود ترفع الاستقلالية لأنها تجعل الطريق آمناً.
5. لا تثق بما لا تستطيع رؤيته أو التحقق منه.

لماذا تبدو هذه المبادئ قديمة: أثر Lindy

أفضل مبادئ العمل مع الوكلاء ليست جديدة تماماً. Bash، الكود كواجهة، الاختبارات، التفكيك، الملفات، القيود، والملاحظة كلها مبادئ قديمة لأنها نجت طويلاً. الجديد هو أن الوكيل يجعل تجاهلها أكثر كلفة، لأن السرعة تضخم الخطأ.

الجزء 1: المبادئ السبعة

المبدأ 1 — Bash هو المفتاح

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

ماذا يعني "Bash" في كل أداة

الأداة	الشكل العملي
Claude Code	أوامر terminal داخل repo
OpenCode	أوامر shell مع مرونة النماذج
Cowork	أفعال سطح المكتب والملفات والموصلات
OpenWork	سطح عمل مفتوح مع أوامر وتكاملات

أمثلة

• بدلاً من "راجع المشروع"، قل: "شغّل pnpm test، واقرأ الملفات التي تفشل، واقترح أصغر إصلاح."
• بدلاً من "حلل العقود"، قل: "اقرأ contracts/، واستخرج البنود التي تختلف عن standard-msa.md في جدول."

تمرين: Hello world

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

طبّق على عملك

اسأل: ما الأمر أو الفعل الذي يثبت أن المهمة أنجزت؟ إذا لم تستطع تسميته، فالمهمة لا تزال غامضة.

المبدأ 2 — الكود كواجهة عامة

الكود لا يعني البرمجة فقط. يعني أي تمثيل منظم يقلل الالتباس: JSON، CSV، SQL، YAML، regex، أو مخطط جدول. النثر يصف؛ البنية تحدد.

هل Bash ليس كوداً أصلاً؟

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

القوى الخمس التي يفتحها الكود

1. يزيل الغموض من الحقول والأنواع.
2. يجعل التحقق آلياً.
3. يسمح بإعادة التشغيل.
4. يقلل الجدل حول التنسيق.
5. يحول المعرفة إلى أصل قابل للنقل.

ما الذي يبقى عليك

تبقى عليك النية والحكم: ما المشكلة؟ ما المخاطر؟ وما الشكل المقبول للمخرج؟

المبدأ 3 — التحقق خطوة أساسية

"يبدو صحيحاً" نمط فشل. لا تجعل انطباع الوكيل هو الدليل. اطلب تحققاً مناسباً للمجال: اختبار، diff، query، عينة، checksum، أو مراجعة مصدر.

ماذا يعني التحقق في كل أداة

العمل	التحقق
كود	test/lint/build
عقد	مقارنة مع standard clause library
محاسبة	tie-out إلى spreadsheet أو ledger
تسويق	قائمة ادعاءات ومصدر كل ادعاء

المبدأ 4 — تفكيك صغير وقابل للعكس

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

أمثلة:

• "أضف حقل CSV واحداً" أفضل من "أعد بناء pipeline".
• "راجع عقداً واحداً" أفضل من "راجع كل العقود وأرسل التقرير النهائي".
• "اكتب مسودة جدول المقارنة" أفضل من "اكتب مذكرة قانونية كاملة".

المبدأ 5 — حفظ الحالة في الملفات

المحادثة متطايرة. الملفات ذاكرة. اكتب القواعد، القرارات، الخطط، والمخرجات الوسيطة في ملفات قابلة للبحث.

# Project: my-app

## What this is
Short description of the work.

## Where things live
- `src/`
- `tests/`
- `docs/`

## Critical rules
- Verify before claiming done.
- Do not touch generated files.

استخدم الشكل نفسه خارج البرمجة:

# Monthly close, FY26

## Variance thresholds
- Flag any variance above 5%.

## Commentary tone
- Concise, finance-leadership style.

## Critical rules
- Never infer missing ledger values.

المبدأ 6 — القيود والسلامة

القيود لا تعطل الوكيل؛ تجعل استقلاليته قابلة للثقة. قل ما يستطيع قراءته، وما يستطيع كتابته، وما يحتاج إلى موافقة، وما هو خارج النطاق.

روافع الثقة الثلاث

1. النطاق: ما الملفات أو الأنظمة المسموح بها؟
2. الأفعال: هل يقرأ فقط، أم يكتب، أم ينفذ، أم يرسل؟
3. الموافقة: ما الذي يحتاج إلى إنسان قبل المتابعة؟

سلّم الاستقلالية

المستوى	الوصف
0	جواب فقط
1	قراءة وتلخيص
2	خطة بلا تنفيذ
3	تنفيذ صغير مع موافقة
4	تنفيذ ضمن قيود
5	تشغيل مجدول أو AFK تحت مراقبة

فخ حقن التعليمات

إذا قرأ الوكيل بريداً أو صفحة ويب أو عقداً، فقد يحتوي المحتوى تعليمات خبيثة. ذكّره بأن المستندات بيانات لا أوامر. لا تسمح للمحتوى غير الموثوق بتغيير قواعد الجلسة.

المبدأ 7 — القابلية للملاحظة

لا تستطيع توجيه ما لا تراه. اطلب من الوكيل أن يعرض ما قرأه، وما سيفعله، وما فعله، وما فشل. في العمل المعرفي يعني ذلك قائمة مصادر وملاحظات. في الكود يعني أوامر ونتائج وdiff.

أعراض خروج الجلسة عن المسار

1. يتوقف عن ذكر الأدلة.
2. يغير النطاق بصمت.
3. يكرر الفشل نفسه.
4. يخلط بين مصادر موثوقة وغير موثوقة.
5. يعطي ملخصاً واثقاً بلا مسار تحقق.

الجزء 2: سير العمل رباعي المراحل

EXPLORE   -> قراءة وتلخيص، بلا كتابة
PLAN      -> خطة منظمة محفوظة ومراجعة
IMPLEMENT -> خطوات صغيرة، تحقق بعد كل خطوة
COMMIT    -> تحقق نهائي، ملخص، تحديث القواعد عند الحاجة

أنماط الفشل الخمسة

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

الجزء 3: مثال عملي

المهمة: لديك ثلاثة عقود مورّدين ومذكرة شروط قياسية. تريد جدولاً يوضح البنود غير القياسية والمخاطر.

1. استكشف: "اقرأ أسماء الملفات فقط، ثم اقترح خطة. لا تكتب."
2. خطط: "اكتب plan.md يحتوي جدول المصادر، الحقول المطلوبة، ومعيار الخطر."
3. نفذ: "راجع عقداً واحداً، اكتب vendor-a-review.md، ثم توقف للتحقق."
4. التزم: "بعد مراجعة الملفات الثلاثة، اكتب comparison.md مع مصادر كل ادعاء."

في البرمجة تكون الملفات كوداً واختبارات. في القانون تكون عقوداً. في المالية تكون ledgers. المبدأ نفسه.

الجزء 4: مشروع تتويجي — طبّق الحلقة على عملك

اختر مهمة حقيقية متكررة ومؤلمة. لا تختر أكبر مهمة في شركتك. اختر شيئاً تستطيع إنهاءه خلال ساعة. اكتب:

• الهدف.
• الملفات أو المصادر المسموح بها.
• المخرجات المطلوبة.
• معيار التحقق.
• ما يحتاج إلى موافقة.

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

الجزء 5: كيف تتحسن فعلاً

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

إلى أين يقود هذا

• إذا أردت عمقاً هندسياً، انتقل إلى فصول primitives.
• إذا أردت البقاء في Mode 1، أعد مشروع التتويج على ثلاث مهام متكررة.
• إذا أردت Mode 2، أي تصنيع عمال ذكاء اصطناعي دائمين، فابدأ بأطروحة Agent Factory ومسار بناء الوكلاء.
• إذا أردت تعليم فريقك، اجعل مشروع التتويج تمريناً جماعياً بعد أن يفعله كل شخص منفرداً.

مرجع سريع

المبادئ السبعة في سطر واحد

1. Bash هو المفتاح. أعط اليدين، لا الدماغ فقط.
2. الكود كواجهة عامة. حدد الشكل وقلل غموض النثر.
3. التحقق خطوة أساسية. "يبدو صحيحاً" فشل.
4. تفكيك صغير قابل للعكس. وحدات ذرية، تحقق لكل وحدة.
5. حفظ الحالة في الملفات. المحادثة تتطاير؛ الملفات ذاكرة.
6. القيود والسلامة. القيود تمكّن الاستقلالية.
7. القابلية للملاحظة. لا توجه ما لا ترى.

شجرة قرار مستوى الثقة

السؤال	القرار
هل المهمة حساسة؟	ابدأ read-only
هل المخرج قابل للتحقق آلياً؟	اسمح بتنفيذ صغير
هل توجد بيانات خارجية غير موثوقة؟	شدد قواعد prompt injection
هل العمل متكرر؟	حوّله إلى skill أو ملف قواعد
هل سيعمل بلا حضورك؟	sandbox، logging، وموافقة مسبقة

عندما يبدو شيء غير صحيح

الوكيل ينجرف -> أعد كتابة الهدف واحفظه في ملف.
الوكيل واثق بلا دليل -> اطلب تحققاً محدداً.
التغيير كبير جداً -> قسّمه إلى شريحة واحدة.
الخطر عالٍ -> اخفض مستوى الاستقلالية.
لا ترى ما يحدث -> اطلب سجل خطوات ومصادر.