وكيل البرمجة CLI

يشحن adk-rust CLI ثلاثة أوامر برمجة أصلية. تعمل جميعها على تشغيل وكيل فعلي داخل مساحة عمل معزولة، وتستخدم نموذج Gemini 3 افتراضيًا، وتحل مفتاح API بشكل غير تفاعلي من --api-key أو البيئة (GEMINI_API_KEY/GOOGLE_API_KEY، OPENAI_API_KEY، …) — ولذلك لا تتوقف أبدًا بانتظار مطالبة إعداد.

code — مهمة تُنفَّذ مرة واحدة

adk-rust code "make the failing test pass"
adk-rust code --dir ./project "add a /health route"
adk-rust code --read-only "explain how auth works"   # no writes / no shell

يستكشف الوكيل الملفات ويعدلها وينفذ الأوامر، ويبث عمله (استدعاءات الأدوات، والنتائج، والنصوص) بالإضافة إلى الخطة النهائية.

goal — وضع الهدف المستقل (دائم، قابل للاستئناف)

نمط /goal الخاص بـ Codex/Hermes: حدّد هدفًا وشرط نجاح قابلًا للتحقق (--until هو أمر shell يجب أن يخرج بالرمز 0). يكرر الوكيل الدورة التخطيط ← التنفيذ ← التحقق، ويصحح نفسه استنادًا إلى مخرجات الفحص، حتى ينجح أو يتم بلوغ حد التكرارات.

adk-rust goal "make all tests pass" --until "cargo test" --max-iters 8
adk-rust goal "port utils.py to type hints" --until "mypy utils.py" --dir ./svc

دائم وقابل للاستئناف. بعد كل تكرار، تُحفَظ حالة الهدف تلقائيًا وبشكل ذري في <dir>/.adk/goal.json (يمكن التجاوز باستخدام --state <path>). إذا تمت مقاطعة التشغيل، فتابعه:

adk-rust goal "…" --until "cargo test" --resume

يتعرف --resume على الهدف المكتمل باعتباره عملية لا أثر لها، ويواصل تشغيل running أو التشغيل ذي الميزانية exhausted من حيث توقف.

شرط النجاح هو ما يجعل وضع الأهداف آمنًا وفعّالًا — اختر شيئًا يمكن التحقق منه (مجموعة اختبارات، أو أداة للتحقق من الأنواع، أو عملية بناء) بحيث يكون لدى الوكيل تعريف واضح يمكن للآلة التحقق منه لكلمة «تم».

ultracode — المراجعة الفائقة المتوازية

نمط ultracode/ultrareview الخاص بـ Claude Code: نفّذ المهمة، ثم وزّعها على مراجعين متخصصين متوازين (الصحة، والحالات الطرفية، والأسلوب)، واجمع أحكامهم، ثم راجِع العمل حتى يوافقوا عليه — مبني على adk-graph.

adk-rust ultracode "add input validation to the parser"
adk-rust ultracode --dir ./project --max-rounds 3 "implement a retry wrapper"

سترى حكم كل مراجع، والقرار المُركَّب لكل جولة، وخطوات المراجعة، التي تنتهي بـ finalize.

اختيار نموذج

تقبل الأوامر الثلاثة جميعها العلامات العامة --model / --provider / --api-key. الإعداد الافتراضي هو gemini-3.1-flash-lite (استخدام سريع وموثوق للأدوات على مراحل متعددة). بالنسبة إلى OpenAI: --provider openai --model gpt-5.6-terra (مع OPENAI_API_KEY).

التالي: سير العمل ←