skill

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

يجب استخدام هذه المهارة عندما يرغب المستخدم في "إنشاء مشروع وكيل"، "بدء مشروع ADK جديد"، "بناء وكيل جديد لي"، "إضافة CI/CD إلى مشروعي"، "إضافة نشر"، "تحسين مشروعي"، أو "ترقية مشروعي". وهي جزء من مجموعة مهارات agents-cli. تغطي أوامر `agents-cli scaffold create` و`scaffold enhance` و`scaffold upgrade`، وخيارات القوالب، وأهداف النشر، وسير عمل "النموذج الأولي أولا". لا تستخدمها لكتابة كود الوكيل (لمشاريع ADK: استخدم google-agents-cli-adk-code...).

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

نبذة

# دليل إعداد المشروع

> **يتطلب:** `agents-cli` (`uv tool install google-agents-cli`) — [ثبت uv](https://docs.astral.sh/uv/getting-started/installation/index.md) أولا إذا لزم الأمر.

استخدم واجهة سطر الأوامر `agents-cli` لإنشاء مشاريع وكلاء جديدة أو تحسين المشاريع الحالية بإعداد النشر، CI/CD، والبنية التحتية.

---

## المتطلب الأساسي: توضيح المتطلبات (إلزامي للمشاريع الجديدة)

**قبل إعداد مشروع جديد، حمل `/google-agents-cli-workflow` وأكمل المرحلة 0** — وضح متطلبات المستخدم قبل تشغيل أي أمر `scaffold create`. اسأل عما يجب أن يفعله الوكيل، وما هي الأدوات/APIs التي يحتاجها، وما إذا كانوا يريدون نموذجا أوليا أو نشرا كاملا.

---

## الخطوة 1: اختيار البنية

**ربط خيارات المستخدم بعلامات CLI:**

| الخيار | علامة CLI | |--------|----------| | الاسترجاع/RAG، التنفيذ في بيئة معزولة، الذاكرة عبر الجلسات، موافقة OAuth، حواجز الحماية، التشغيل المجدول | **لا توجد علامة** — هذه تأتي من وصفات الاستنساخ والدراسة. **ADK Python:** انظر فهرس الموضوعات في `/google-agents-cli-adk-code` → `references/recipes.md`؛ في الأطر الأخرى، انظر كتالوج الوكلاء الذي يأتي مع قالب الإطار | | بروتوكول A2A | مدمج في التطبيق المعد — قم بالإعداد بشكل طبيعي (**ADK Python:** `--agent adk_python`، الافتراضي؛ **ADK Go:** `--agent adk_go`) | | نموذج أولي (بدون نشر) | `--prototype` | | هدف النشر | `--deployment-target <agent_runtime\|cloud_run\|gke>` | | مشغل CI/CD | `--cicd-runner <github_actions\|google_cloud_build>` | | تخزين الجلسات | `--session-type <in_memory\|cloud_sql\|agent_platform_sessions>` |

### ربط أسماء المنتجات

الأسماء الحالية (والأسماء القديمة التي قد يستخدمها المستخدمون) ← قيم CLI (اسم حزمة `vertexai` SDK لم يتغير):

- Agent Runtime في منصة Gemini (Agent Engine / Vertex AI Agent Engine / Agent Runtime) → `--deployment-target agent_runtime` - الجلسات في منصة Gemini (Agent Engine sessions / Agent Platform Sessions) → `--session-type agent_platform_sessions` - البحث / البحث المتجه في منصة Gemini (Vertex AI Search / Vertex AI Vector Search) / RAG → وصفة استنساخ ودراسة، وليست علامة

> **علامات محذوفة.** لم تعد `--datastore`، وقالب `agentic_rag`، و`agents-cli infra datastore` / > `agents-cli data-ingestion` موجودة. إذا كنت تبحث عن إحداها، فأنت تريد وصفة بدلا من ذلك.

---

## الخطوة 2: إنشاء أو تحسين المشروع

### إنشاء مشروع جديد

```bash agents-cli scaffold create <project-name> \ --agent <template> \ --deployment-target <target> \ --region <region> \ --prototype ```

**القيود:** - يجب أن يكون اسم المشروع **26 حرفا أو أقل**، أحرف صغيرة، أرقام، وواصلات فقط. - لا تقم بإنشاء دليل المشروع باستخدام `mkdir` قبل تشغيل `create` — واجهة سطر الأوامر تنشئه تلقائيا. إذا قمت بإنشائه أولا، سيفشل `create` أو يتصرف بشكل غير متوقع. - مرر `--agent-guidance-filename` لبيئة التطوير المتكاملة (IDE) الخاصة بك: `GEMINI.md` ل Antigravity CLI، `CLAUDE.md` ل Claude Code، `AGENTS.md` بخلاف ذلك. - عند تحسين مشروع موجود، تحقق من مكان وجود كود الوكيل. إذا لم يكن في `app/`، مرر `--agent-directory <dir>` (على سبيل المثال `--agent-directory agent`). ارتكاب خطأ هنا يتسبب في أن يفوت التحسين الملفات أو يضعها في غير مكانها.

### ملفات مرجعية

| الملف | المحتويات | |------|----------| | `references/flags.md` | مرجع كامل للعلامات لأوامر `create` و`enhance` |

### تحسين مشروع موجود

```bash agents-cli scaffold enhance . --deployment-target <target> agents-cli scaffold enhance . --cicd-runner <runner> ```

قم بتشغيل هذا من داخل دليل المشروع (أو مرر المسار بدلا من `.` ).

### ترقية مشروع

قم بترقية مشروع موجود إلى إصدار أحدث من agents-cli، مع تطبيق التحديثات بذكاء مع الحفاظ على تخصيصاتك:

```bash agents-cli scaffold upgrade # ترقية الدليل الحالي agents-cli scaffold upgrade <project-path> # ترقية مشروع محدد agents-cli scaffold upgrade --dry-run # معاينة التغييرات دون تطبيق agents-cli scaffold upgrade --auto-approve # تطبيق التغييرات غير المتعارضة تلقائيا agents-cli scaffold upgrade --force # الكتابة فوق ملفات الإعداد عندما يفشل الدمج الذكي agents-cli scaffold upgrade --force --dry-run # سرد ما ستقوم --force بالكتابة فوقه ```

`--force` هو حل بديل عندما يفشل الدمج الذكي. يتوقف الدمج الذكي أيضا عندما لا يكون إصدار agents-cli الذي أنشأ المشروع موجودا على PyPI، لأنه يحتاج إلى قالب هذا الإصدار؛ استخدم `--force` في هذه الحالة أيضا. يقوم بالكتابة فوق ملفات الإعداد بالقالب الجديد ويحتفظ بكود الوكيل، وملفات التكوين، و`README.md`، وملف إرشادات الوكيل، ومجموعات بيانات التقييم وتكوينها. لا يقوم أبدا بإزالة التبعيات أو الملفات التي أسقطها القالب الجديد (على سبيل المثال، سير عمل CI الذي تم إزالته)، لذا قم بإزالة الملفات غير المستخدمة يدويا. بعد ذلك، تحقق من عمليات الاستيراد الخاصة بك وقم بتشغيل اختباراتك. استخدم `--dry-run` أولا لمعرفة الملفات التي ستتغير.

### أوضاع التنفيذ

تكون واجهة سطر الأوامر افتراضيا في **وضع برمجي صارم** — يجب توفير جميع المعلمات المطلوبة كعلامات CLI أو سيتم رفع `UsageError`. لا توجد علامات موافقة مطلوبة. مرر جميع المعلمات المطلوبة بشكل صريح.

### سير العمل الشائعة

التثبيت

شغل هذا الأمر

npx skills add google/agents-cli

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-scaffold` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

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

يجب استخدام هذه المهارة عندما يرغب المستخدم في "إنشاء مشروع وكيل"، "بدء مشروع ADK جديد"، "بناء وكيل جديد لي"، "إضافة CI/CD إلى مشروعي"، "إضافة نشر"، "تحسين مشروعي"، أو "ترقية مشروعي". وهي جزء من مجموعة مهارات agents-cli. تغطي أوامر `agents-cli scaffold create` و`scaffold enhance` و`scaffold upgrade`، وخيارات القوالب، وأهداف النشر، وسير عمل "النموذج الأولي أولا". لا تستخدمها لكتابة كود الوكيل (لمشاريع ADK: استخدم goo…

كيف أثبت هيكل سطر أوامر وكلاء 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/docx ~/.claude/skills/
ملف Docx
استخدم هذه المهارة كلما أراد المستخدم إنشاء مستندات Word (ملفات .docx) أو قراءتها أو تعديلها أو معالجتها، أو قوالب Word (ملفات .dotx). تشمل المحفزات:…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط مستندات النطاق. يتم تشغيله مرة واحدة قبل الاستخدام…1,076,003+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
ابحث في سؤال مقابل مصادر أولية موثوقة للغاية وقم بتوثيق النتائج كملف Markdown في المستودع. استخدم هذا عندما يرغب المستخدم في البحث عن موضوع، أو جمع حق…756,925+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+

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

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

المزيد في إنشاء المحتوى