skill
سير عمل واجهة سطر الأوامر لوكلاء Google
يجب استخدام هذه المهارة عندما يرغب المستخدم في "تطوير وكيل"، "بناء وكيل باستخدام ADK"، "تشغيل الوكيل محليا"، "تصحيح أخطاء كود الوكيل"، "اختبار وكيل"، "نشر وكيل"، "مراقبة وكيل"، أو يحتاج إلى دورة حياة تطوير ADK (مجموعة تطوير الوكيل) وإرشادات الترميز. نقطة الدخول لبناء وكلاء ADK. نشطة دائما — توفر سير العمل الكامل (الهيكلة، البناء، التقييم، النشر، المراقبة)، قواعد الحفاظ على الكود، إرشادات اختيار النموذج، واستكشاف ال...
نبذة
# سير عمل وإرشادات تطوير الوكلاء
**agents-cli** هي واجهة سطر أوامر (CLI) ومجموعة أدوات للمهارات لبناء وتقييم ونشر الوكلاء على Google Cloud. تعمل مع أي وكيل برمجة — Antigravity CLI، Claude Code، Codex، أو غيرها — ومع إطار عمل الوكيل الذي تختاره (مجموعة تطوير الوكيل [Agent Development Kit (ADK)](https://adk.dev/) افتراضيا). ثبتها باستخدام `uvx google-agents-cli setup`.
> **قبل كتابة كود الوكيل، تأكد من وجود مشروع مهيكل (انظر المرحلة 2).** تخطي الهيكلة يؤدي إلى فقدان القوالب الأساسية للتقييم، وإعدادات CI/CD، واتفاقيات المشروع.
> المتطلبات: google-agents-cli ~= 1.15.0 > إذا كان الإصدار قديما، قم بتشغيل: uv tool install "google-agents-cli~=1.15.0"
> للتحقق من الإصدار: agents-cli info > [ثبت uv](https://docs.astral.sh/uv/getting-started/installation/index.md) أولا إذا لزم الأمر.
## استمرارية الجلسة والمراجع المتبادلة للمهارات
أعد قراءة المهارة ذات الصلة **قبل** كل مرحلة — وليس بعد أن بدأت بالفعل وواجهت مشكلة. قد يكون ضغط السياق قد أسقط محتوى المهارة السابق. إذا لم تكن المهارات متاحة، قم بتشغيل `uvx google-agents-cli setup` لتثبيتها.
| المرحلة | المهارة | متى يتم التحميل | |-------|-------|--------------| | 0 — الفهم | — | لا توجد مهارة مطلوبة — اقرأ `.agents-cli-spec.md` إذا كان موجودا، وإلا وضح الأهداف مع المستخدم | | 1 — دراسة الوصفات | `/google-agents-cli-adk-code` | **قم بتحميلها أثناء التصميم**، قبل الهيكلة. Python: فهرس موضوعات `references/recipes.md` يربط الحاجة بالوصفة التي تنفذها. Go: [examples/](https://github.com/google/adk-go/tree/main/examples) هي المكافئ. نعم، قم بتحميل هذا مبكرا. | | 2 — الهيكلة | `/google-agents-cli-scaffold` | قبل إنشاء أو تحسين مشروع | | 3 — البناء | `/google-agents-cli-adk-code` | قبل كتابة كود الوكيل — أنماط API، الأدوات، ردود الاتصال (callbacks)، الحالة | | 4 — التقييم | `/google-agents-cli-eval` | قبل تشغيل أي تقييم — مخطط مجموعة البيانات، المقاييس، حلقة إصلاح التقييم | | 5 — النشر | `/google-agents-cli-deploy` | قبل النشر — اختيار الهدف، استكشاف أخطاء 403/المهلات | | 6 — النشر العام | `/google-agents-cli-publish` | بعد النشر، إذا تم التسجيل في Gemini (اختياري) | | 7 — المراقبة | `/google-agents-cli-observability` | بعد النشر — التتبع، التسجيل، إعداد المراقبة |
---
## الإعداد
إذا لم يتم تثبيت `agents-cli`: ```bash uv tool install google-agents-cli ```
### أمر `uv` غير موجود
ثبت `uv` باتباع [دليل التثبيت الرسمي](https://docs.astral.sh/uv/getting-started/installation/index.md).
### تعيين أسماء المنتجات
يسمي المستخدمون المنتجات بشكل غير متسق (Vertex AI أو Agent Platform ← منصة Gemini، Agent Engine أو Agent Runtime ← Agent Runtime في منصة Gemini، إلخ). قم بتعيين مصطلحات المستخدم إلى قيم CLI باستخدام `references/terminology.md`.
---
## المرحلة 0: الفهم
قبل كتابة أو هيكلة أي شيء، افهم ما تقوم ببنائه — من خلال **حوار تصميمي**، وليس قائمة تحقق. قم بتحميل `references/brainstorming.md` واتبعه: اطرح **سؤالا واحدا في كل مرة**، اقترح 2-3 مقاربات معمارية للوكلاء غير التافهين، وتحقق من صحة التصميم قبل أي هيكلة.
إذا كان ملف `.agents-cli-spec.md` موجودا في الدليل الحالي، فاقرأه — فهو مصدرك الأساسي للحقيقة. وإلا:
لا تنتقل إلى التخطيط أو الهيكلة أو البرمجة حتى يوافق المستخدم على المواصفات. لا تفترض أو تبحث أو تملأ الفراغات بنفسك — نية المستخدم هي التي توجه كل شيء.
**قم بتكييف الإجراءات مع التعقيد:** يحتاج الوكيل التافه (أداة واحدة، شخصية ثابتة) إلى سؤالين فقط، ومواصفات من 2-3 جمل، وموافقة واحدة؛ بينما يحصل الوكيل المعقد (متعدد الوكلاء، RAG، واجهات برمجة تطبيقات خارجية/مصادقة، حرج للسلامة) على المعالجة الكاملة في `references/brainstorming.md`.
**المواضيع التي يجب تغطيتها** (سؤال واحد في كل مرة، مع التكيف مع المستخدم — انظر دليل الإجراءات):
1. **ما المشكلة التي سيحلها الوكيل؟** — الغرض الأساسي والقدرات 2. **هل هناك حاجة لواجهات برمجة تطبيقات خارجية أو مصادر بيانات؟** — الأدوات، التكاملات، متطلبات المصادقة 3. **قيود السلامة؟** — ما يجب على الوكيل ألا يفعله، حواجز الحماية 4. **تفضيل النشر؟** — نموذج أولي أولا (موصى به) أم نشر كامل؟ إذا كان سيتم النشر: Agent Runtime، Cloud Run، أم GKE؟
**اطرح الأسئلة بناء على السياق:**
- إذا كان الوكيل يحتاج إلى **قدرة لا يوفرها الهيكل** — استرجاع البيانات الخاصة بك، تنفيذ كود في بيئة معزولة، ذاكرة عبر الجلسات، موافقة OAuth، حواجز حماية السلامة، مشغلات تعتمد على الأحداث — فإن هذه القدرة تأتي من **وصفة للنسخ والدراسة**، وليس علامة هيكلة. ابحث عن الحاجة في فهرس الموضوعات في `/google-agents-cli-adk-code` ← `references/recipes.md` وادرس الوصفة المطابقة في المرحلة 1. - إذا كان الوكيل **وكيلا مباشرا أو صوتيا** (Live API، محادثة منطوقة، مقاطعة، اتصالات هاتفية) ← قم بتحميل `/google-agents-cli-adk-code` (`references/adk-python-live.md`) **قبل كتابة المواصفات**. القواعد المباشرة تستبعد A2A، تطبيق Gemini، والنموذج الافتراضي. - إذا كان الوكيل يجب أن يكون **متاحا لوكلاء آخرين** ← **بروتوكول A2A** مدمج في كل وكيل Python يتم هيكلته بواسطة agents-cli؛ لا حاجة لاختيار منفصل — فقط قم بالهيكلة بشكل طبيعي. - إذا كان كاملا
التثبيت
شغل هذا الأمر
npx skills add google/agents-cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-workflow` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة سير عمل واجهة سطر الأوامر لوكلاء Google؟
يجب استخدام هذه المهارة عندما يرغب المستخدم في "تطوير وكيل"، "بناء وكيل باستخدام ADK"، "تشغيل الوكيل محليا"، "تصحيح أخطاء كود الوكيل"، "اختبار وكيل"، "نشر وكيل"، "مراقبة وكيل"، أو يحتاج إلى دورة حياة تطوير ADK (مجموعة تطوير الوكيل) وإرشادات الترميز. نقطة الدخول لبناء وكلاء ADK. نشطة دائما — توفر سير العمل الكامل (الهيكلة، البناء، التقييم، النشر، المراقبة)، قواعد الحفاظ على الكود، إرشادات اختيار النموذج، واستكشاف ال.…
كيف أثبت سير عمل واجهة سطر الأوامر لوكلاء Google؟
شغل هذا الأمر في الطرفية:
npx skills add google/agents-cliمع أي أدوات ذكاء اصطناعي تعمل سير عمل واجهة سطر الأوامر لوكلاء Google؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور سير عمل واجهة سطر الأوامر لوكلاء Google؟
طورها google.
هل سير عمل واجهة سطر الأوامر لوكلاء Google مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى