تفكيك وكلاء برمجة مفتوحة المصدر: Codex وOpenCode وgoose
هذا القسم يقرأ شيفرة المصدر. المشاريع الثلاثة كلها وكلاء برمجة مفتوحة المصدر للطرفية أو سطح المكتب: Codex CLI من OpenAI (Rust، Apache-2.0)، وOpenCode (TypeScript، MIT، والقراءة كانت للبنية الجديدة في 2.3.0)، وgoose (Rust، Apache-2.0، 1.60.0، وهو الآن مشروع تحت AAIF التابعة لمؤسسة Linux). استنسخناها في 20/11/2026، ومسارات الملفات وأرقام الأسطر أدناه تقابل تلك النسخة.
ستكتشف: الحلقة الأساسية شبه مطابقة تمامًا لما كتبته أنت، والفروق كلها في «الفرامل» و«تفاصيل الهندسة».
1. الحلقة: كلها «ما دامت هناك حاجة إلى أدوات فاستمر»
حلقة Codex (codex-rs/core/src/session/turn.rs) تستخدم متغيرًا واحدًا لتحديد ما إذا كانت هناك حاجة إلى جولة أخرى:
let needs_follow_up = model_needs_follow_up || has_pending_input;إذا أراد النموذج استدعاء أداة، أو أدخل المستخدم كلامًا جديدًا في المنتصف، فاستمر؛ وإلا break. هذا هو نفس الأمر الذي يفعله if not msg.tool_calls: return في myagent.
OpenCode يسميها needsContinuation (تكون صحيحة إذا كانت هناك استدعاءات أدوات نُفِّذت محليًا في هذه الخطوة)، وgoose يسميها ends_turn (تنتهي إذا كانت آخر رسالة ردًّا بلا طلبات أدوات).
الفرق في الفرامل:
| حد الخطوات | ماذا يحدث عند بلوغ الحد | |
|---|---|---|
| myagent | 12 خطوة | توقف مباشر، مع رد بجملة «تم تجاوز الحد الأقصى للخطوات» |
| OpenCode | لا حد افتراضيًا، ويمكن تعيين steps لكل Agent | إيقاف الأدوات (toolChoice: "none")، مع إضافة جملة «تم بلوغ الحد الأقصى للخطوات»، لإجبار النموذج على تلخيص التقدم الحالي بالكلمات |
| goose | GOOSE_MAX_TURNS الافتراضي 1000 | تسليم التحكم وسؤال المستخدم عما إذا كان يريد المتابعة |
| Codex | لم نجد في شيفرة المصدر حدًا للخطوات | — |
نهج OpenCode أفضل من نهجنا: القطع المباشر يُفقد التقدم، أما جعل النموذج يكتب ملخصًا في الخطوة الأخيرة فيعرف المستخدم على الأقل إلى أين وصل.
2. الصلاحيات: من y/N إلى «جدول قواعد + مراجعة + صندوق رمل»
ابحثصلاحياتها…
انقر على واحد لترى.
smart_approve في goose ونموذج المراجعة لدى Grok Bot في القسم السابق ومستوى auto لدى OpenClaw هي الفكرة نفسها: ما يمكن الحكم عليه تلقائيًا يُحكم عليه تلقائيًا، وما هو غير مؤكد يُسأل عنه الإنسان.
3. الضغط: الفكرة نفسها مثل compact() عندك، مع ثلاثة أمور إضافية
| متى يبدأ الضغط | |
|---|---|
| myagent | عندما يتجاوز الحوار 24000 حرفًا |
| Codex | 90% من نافذة السياق |
| OpenCode | نافذة السياق مطروح منها max(15%, 16k token) |
| goose | عند 0.8 من النافذة |
| OpenClaw | يبدأ الضغط عند حوالي 75% |
النهج الجاهز للإنتاج يضيف ثلاثة أمور إضافية:
- الحساب بالـ token وليس بعدد الأحرف.
- كتابة الملخص كـ"ورقة تسليم". الجملة الأولى في موجه الضغط لدى Codex (
codex-rs/prompts/templates/compact/prompt.md):
You are performing a CONTEXT CHECKPOINT COMPACTION. Create a handoff summary for another LLM that will resume the task.
Include:
- Current progress and key decisions made
- Important context, constraints, or user preferences
- What remains to be done (clear next steps)
- Any critical data, examples, or references needed to continueOpenCode يطلب أيضًا أن يكون الملخص "جاهزًا لتسليمه إلى Agent آخر يتابع العمل"، ويحدد أقسامًا ثابتة مثل الأهداف والقرارات والخطوة التالية.
- عدم فصل استدعاءات الأدوات عن نتائجها. مثل حلقة while في compact() لدينا، كل المشاريع تعالج هذا.
4. ملفات التعليمات والمهارات: AGENTS.md و load_skill
جميعها تقريبًا تقرأ AGENTS.md (وصف المشروع المكتوب ليقرأه الـ Agent):
- Codex: يقرأ الملفات طبقةً طبقة من جذر git حتى الدليل الحالي ويجمعها، بحد أقصى إجمالي 32 KiB؛ وإذا وُجد
AGENTS.override.mdفي نفس الطبقة فيقرأه أولًا. - OpenCode: يبحث عن AGENTS.md، وإذا لم يوجد في نفس الدليل يتراجع لقراءة CLAUDE.md.
- goose: يقرأ
.goosehintsو AGENTS.md.
أما المهارات، فاسم الأداة في goose مطابق تمامًا لما لدينا، وهو load_skill (crates/oi-kit-agent/src/skills/operation.rs):
fn load_skill_tool() -> Tool {
Tool::new(
LOAD_SKILL_TOOL_NAME,
"Load a skill's full content into your context so you can follow its instructions.\n\n\
Skills are listed in your system instructions. When you need to use one, \
load it first to get the detailed instructions.",
schema_for_type::<LoadSkillParams>(),
)
}ما كتبته في الفصل الثاني هو الممارسة السائدة في المجال.
5. MCP: المقبس المشترك للجميع
المشاريع الثلاثة كلها تدعم MCP: Codex يُضبط تحت config.toml في [mcp_servers.名字]؛ OpenCode يُضبط في opencode.json بوضع local / remote؛ أما goose فهو الأكثر شمولًا، جميع الأدوات تمر عبر MCP، وكل امتداد هو عميل MCP، ويُسبق اسم الأداة بـ"اسم الامتداد__اسم الأداة".
تطبيق عملي: أضف ثلاثة أمور إلى myagent على هذا النحو
- 1?
- 2?
- 3?
اضغط عليها واحدة تلو الأخرى حسب الترتيب.
طريقة مرجعية للأمر الأول:
agents_md = Path("AGENTS.md")
if agents_md.exists():
SYSTEM += "\n\n项目说明(AGENTS.md):\n" + agents_md.read_text(encoding="utf-8")[:8000]اختبر معرفتكبعد قراءة شيفرة المصدر للمشاريع الثلاثة، كيف تبدو الحلقة الأساسية للـ Agent مقارنة بـ myagent الذي كتبته؟
تحقق من ذلك
- أستطيع أن أشرح كيف يعالج كل من المشاريع الثلاثة "الوصول إلى حد الخطوات"
- أستطيع أن أذكر عتبات الضغط لديها، ولماذا يُكتب الملخص كـ"ورقة تسليم"
- أضفت إلى myagent ميزة واحدة على الأقل مما تعلمته
عد إلى الأسئلة الشائعة، أو اذهب إلى درس OpenClaw ودرس Grok Bot لتطبيق هذه التصاميم.