skill

سير عمل واجهة سطر الأوامر لوكلاء Google

يجب استخدام هذه المهارة عندما يرغب المستخدم في "تطوير وكيل"، "بناء وكيل باستخدام ADK"، "تشغيل الوكيل محليا"، "تصحيح أخطاء كود الوكيل"، "اختبار وكيل"، "نشر وكيل"، "مراقبة وكيل"، أو يحتاج إلى دورة حياة تطوير ADK (مجموعة تطوير الوكيل) وإرشادات الترميز. نقطة الدخول لبناء وكلاء ADK. نشطة دائما — توفر سير العمل الكامل (الهيكلة، البناء، التقييم، النشر، المراقبة)، قواعد الحفاظ على الكود، إرشادات اختيار النموذج، واستكشاف ال...

google581,786+ تثبيتموثوق

نبذة

# سير عمل وإرشادات تطوير الوكلاء

**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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل سير عمل واجهة سطر الأوامر لوكلاء Google ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدم هذا عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجوبن…1,041,607+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (commit، فرع، وسم، أو merge-base) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات…840,484+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
الذكاء الاصطناعي من Azure
بناء تطبيقات Azure AI Search وSpeech وOpenAI وDocument Intelligence واستكشاف أخطائها وإصلاحها. متى: AI Search، البحث المتجه، البحث الهجين، البحث الدلا…727,368+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة