skill
هيكل سطر أوامر وكلاء Google
يجب استخدام هذه المهارة عندما يرغب المستخدم في "إنشاء مشروع وكيل"، "بدء مشروع ADK جديد"، "بناء وكيل جديد لي"، "إضافة CI/CD إلى مشروعي"، "إضافة نشر"، "تحسين مشروعي"، أو "ترقية مشروعي". وهي جزء من مجموعة مهارات agents-cli. تغطي أوامر `agents-cli scaffold create` و`scaffold enhance` و`scaffold upgrade`، وخيارات القوالب، وأهداف النشر، وسير عمل "النموذج الأولي أولا". لا تستخدمها لكتابة كود الوكيل (لمشاريع ADK: استخدم google-agents-cli-adk-code...).
نبذة
# دليل إعداد المشروع
> **يتطلب:** `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يعمل مع
خطوات التثبيت
ثبت باستخدام `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 مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/docx ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى