برنامج تعليمي لوكلاء Antigravity المخصصين: اصنع متخصصين من صنعك
حوّل المهام المتكررة إلى وكلاء فرعيين محفوظين: ملف markdown واحد مع ترويسة YAML ضمن .agents/agents، وقائمة أدوات محدودة، وفوقها قواعد وسير عمل ومهارات — كل لقطة الشاشة من تسجيل حقيقي.
الخلاصة السريعة
- الوكيل المخصص ملف markdown واحد: ترويسة YAML (الاسم والوصف والموديل والأدوات) وجسم يضم تعليمات النظام — احفظ المتخصص المتكرر مرة واحدة ولا تعيد شرحه في كل جلسة.
- وكلاء مساحة العمل يعيشون في .agents/agents/<الاسم>.md ويُسلَّمون مع المستودع؛ أما الشخصية في ~/.gemini/config/agents/ فتنطبق على كل مشاريع الجهاز.
- tools لا يقبل إلا أسماء أدوات Antigravity الحقيقية — view_file وgrep_search وlist_dir — والاسم الخاطئ يُفشل الوكيل عند الإقلاع؛ subagent: true يجعله قابلاً للتفويض، وmainAgent: true يضيفه إلى منتقي الإدخال.
- اختبره سريعًا بسؤال "What are your tools?" في منتقي الـIDE، أو فوّضه من المحادثة الرئيسية، أو افحصه بـ /agents وAlt+J في سطر الأوامر — ثم أضف القواعد وسير العمل والمهارات.
Google Antigravity Livestream: Remote Control and Custom Agents
القناة:Google Antigravity47:43
Antigravity Customization Features That 10X Your Coding Speed
القناة:Code A Program11:02
Defining Custom Subagents (.md) — Antigravity Docs
الوثائق:antigravity.googleDocs
لقطات الشاشة صور ثابتة من تسجيل شاشة Code A Program (مُشار إليه أعلاه)؛ أما مسار إنشاء ملف الوكيل المخصص فيوثَّق من البث المباشر الرسمي لجوجل ووثائق subagents في Antigravity — فلا يوجد حتى الآن تسجيل طرف ثالث نظيف يغطيه.
استند التحقق من الوقائع أيضًا إلى فيديي Use AI with Tech Dad وAI with Surya عن الوكلاء المخصصين. جميع العلامات التجارية ملك لجوجل؛ هذا دليل مستقل لا تربطه أي صلة بجوجل.
من مجلد فارغ إلى متخصص موثوق
1 · حدّ ملامح المتخصص
- 1
اكتشف دورًا يستحق الحفظ
يستحق الوكيل المخصص ملفه عندما يتكرر العمل نفسه: مراجع أكواد بقائمة فحص ثابتة، أو محدِّث تبعيات، أو مشغّل اختبارات، أو صيانة توثيق. إذا كانت التعليمات مستقرة ومختلفة عن مساعدك العام ويمكن تسمية صندوق الأدوات مسبقًا فاحفظ الدور. أما الطلبات لمرة واحدة فالأفضل لها أن تبقى موجهًا عاديًا.
- 2
اعرف الفرق بينه وبين الوكلاء الفرعيين والمهارات
الوكيل الفرعي هو مقعد العمل: جلسة يفوّض إليها وكيلك الرئيسي. والوكيل المخصص هو الملف الشخصي المحفوظ الذي يمكن أن يجلس على ذلك المقعد — أو تُحادثه مباشرة. والمهارات شيء آخر: فهي تلخّص معرفة المهمة التي يلتقطها أي وكيل، بينما يغيّر الوكيل المخصص تعليماته الجوهرية وصلاحيات أدواته. للعامل لمرة واحدة لا تحتاج ملفًا؛ يمكن لـAntigravity أن يولّد وكيلًا فرعيًا مؤقتًا بأداة define_subagent في منتصف الجلسة.
- 3
اختر النطاق: المستودع أم الجهاز
يكتشف Antigravity ملفات .md للوكلاء المخصصين في ثلاثة مواضع. تخصيصات مساحة العمل تعيش في .agents/agents/<الاسم>.md (أو .agents/agents/<الاسم>/agent.md) وتسافر مع المستودع — الأنسب للاصطلاحات المشتركة. التخصيصات العامة تعيش في ~/.gemini/config/agents/<الاسم>.md وتنطبق على كل مشاريع الجهاز — الأنسب للمتخصصين الشخصيين. ويمكن للإضافات أن تحزم وكلاء في plugins/<اسم_الإضافة>/agents/.
صفحة Rules من وثائق Antigravity: القواعد العامة تعيش في ~/.gemini/GEMINI.md وتنطبق على كل مساحات العمل، وقواعد مساحة العمل في مجلد .agents — التقسيم نفسه الذي تتبعه ملفات الوكلاء المخصصين.شاهد عند 0:30
2 · اكتب ملف الوكيل
- 4
أنشئ ملف الوكيل
داخل مشروعك أنشئ المجلد والملف دفعة واحدة — اسم الملف أو المجلد يصبح هوية الوكيل، فاجعله بأحرف صغيرة وشرطات: .agents/agents/codereviewer/agent.md. يمكنك أيضًا أن تطلب من وكيل Antigravity بناءه: في العرض الرسمي أعادت جملة واحدة "I have an idea for a custom agent" المسار الكامل undefined/.agents/agents/codereviewer/agent.md مع تعريف جاهز للتعديل.
- 5
املأ ترويسة YAML
تعلن الترويسة هوية المتخصص وحدوده. name يجب أن يكون فريدًا — به ستُشير إليه بـ@. description تخبر Antigravity متى يُستدعى المتخصص فاكتبها كإعلان وظيفة. model: inherit يحافظ على مستوى موديل الأب، وtools يسرد بالضبط ما يسمح به للدور. وعلمان يكملان الصورة: subagent افتراضه true (قابل للتفويض) وmainAgent افتراضه false (اجعله true لتختار المتخصص مباشرة من منتقي الإدخال).
- 6
اكتب جسم تعليمات النظام
كل ما تحت فاصل الترويسة يصبح تعليمات النظام للوكيل. المثال الرسمي يفتتح بشخصية ("You are an expert, meticulous Code Reviewer") ويسرد المسؤوليات الجوهرية — الصحة والأمان والأداء والأسلوب — ويختم بصيغة مخرجات صارمة: حكم Summary، وموجزات Critical حاجزة مع أرقام الأسطر، واقتراحات غير حاجزة. صيغة التقرير الثابتة هي ما يجعل نتائج المتخصص جديرة بالثقة.
---
name: codereviewer
description: >-
Code review specialist that analyzes diffs, inspects code for bugs,
architectural issues, performance bottlenecks, and style compliance.
model: inherit
tools:
- view_file
- grep_search
- list_dir
subagent: true
---
# Code Reviewer Persona & Instructions
You are an expert, meticulous Code Reviewer. Inspect proposed changes,
pull requests, and codebase files for correctness, security, performance,
and style.
## Review Output Format
- **Summary**: high-level assessment (LGTM / Changes Requested)
- **Critical findings**: blocking issues with line references and fixes
- **Suggestions & Improvements**: non-blocking refactors3 · وسّعه وقيّده
- 7
قيّد صندوق الأدوات بأسماء أدوات حقيقية
تأخذ ترويسة tools قائمة سماح صريحة، ويجب أن تطابق الأسماء أدوات Antigravity الحقيقية. في العرض الرسمي ورد في الملف المولَّد read — ومات الوكيل بخطأ "Agent execution terminated due to error" حتى صُحح إلى view_file. التزم بأسماء مثل view_file وgrep_search وlist_dir، وأعطِ الدور ما يتطلبه عمله فقط؛ فالمراجع نادرًا ما يحتاج صلاحية الكتابة.
ملف إعداد لمساحة العمل يسرد أسماء الأدوات التي يمكن للوكيل استدعاؤها — view_file وgrep_search وread_file — وهي المفردات ذاتها التي تتوقعها قائمة tools للوكيل المخصص.شاهد عند 4:44 - 8
قرر متى يعمل
مع subagent: true (الافتراضي) يصبح متخصصك جاهزًا للتفويض: صف المهمة للوكيل الرئيسي فيُسلّم العمل المحصور إلى المتخصص ويعود تقريره إلى المحادثة الرئيسية. يرث الوكلاء الفرعيون المفوَّضون حدود صلاحيات الأب — الأوامر المسموحة ونطاقات الملفات وإعدادات الحماية — وتظهر الطلبات التي تحتاج موافقة المستخدم في الواجهة الرئيسية. اجعل mainAgent أيضًا true فيظهر المتخصص في منتقي الإدخال جاهزًا للحوار المباشر.
- 9
افتح Customizations وسمِّ قاعدة
تزداد ذكاءً الوكلاء المخصصون سريعًا حين تضيف قواعد البيت. في بيئة التطوير افتح قائمة "..." أعلى لوحة الوكيل واختر Customizations — اللوحة نفسها تضم Rules وWorkflows. تحت Rules أنشئ قاعدة جديدة: القواعد العامة تعيش في ~/.gemini/GEMINI.md وتنطبق على كل مساحات العمل، وقواعد مساحة العمل تعيش في مجلد .agents بجذر مساحة العمل أو git. ملف القاعدة محدود بـ12,000 حرف.
لوحة Customizations في لوحة الوكيل بمحرر Antigravity: تبويب Rules نشط ويُكتب اسم قاعدة جديدة حيث يقول النص التوضيحي e.g. code-style-guide.شاهد عند 0:56 - 10
اختر نمط التنشيط
تجيب كل قاعدة عن سؤال واحد: متى تنطبق؟ Always On يحقنها في كل محادثة؛ Manual ينتظر @إشارة في صندوق الإدخال؛ Model Decision يتيح للوكيل تفعيلها بناءً على وصفها باللغة الطبيعية؛ Glob لا تنطبق إلا على الملفات المطابقة لنمط مثل *.test.ts. اختر أضيق نمط يفي بالغرض — قاعدة مراجعة لا تنطلق إلا على الفروق تبقى مركزة.
قائمة Activation Mode المنسدلة في محرر قواعد Antigravity والخيارات الأربعة ظاهرة — Always On وManual وModel Decision وGlob.شاهد عند 1:04 - 11
اكتب محتوى القاعدة
القواعد قيود بـMarkdown خالص: "التعليقات تشرح لماذا وُجد الكود لا ماذا يفعل"، "استخدم JSDoc للدوال"، "لا تترك عناصر TODO". اجعل لكل قاعدة غرضًا واحدًا — فالوكيل يقرأها حرفيًا في كل محادثة مطابقة. القواعد تشكّل طريقة عمل متخصصك؛ والطبقتان التاليتان تمنحانه الإجراءات والمعرفة.
ملف قاعدة اسمه comments.md في محرر Antigravity، ونمط التنشيط Always On، وجاهز لتلقي تعليمات Markdown التي ستتبعها كل محادثة.شاهد عند 1:02 - 12
حزم الإجراءات المتكررة كسير عمل
حين يتعين على المتخصص تكرار إجراء متعدد الخطوات — تنظيف الفروع المدمجة، إصدار نسخة، إعادة توليد توثيق الواجهات — احفظه كسير عمل بدل إعادة كتابة الخطوات. سير العمل ملفات Markdown بوصف YAML في الترويسة، يُستدعى بأمر شرطة مائلة: اكتب /cleanup-branches فينفّذ الوكيل كل خطوة مدرجة.
قسم Workflows من وثائق Antigravity: ملفات سير العمل تعيش في مجلد workflows داخل .agent وتُستدعى في المحادثة بأمر /workflow-name.شاهد عند 5:40 - 13
أنشئ ملف سير العمل
اطلب من الوكيل بناءه أو افعلها بنفسك: mkdir -p .agent/workflows ثم أنشئ cleanup-branches.md بوصف موجز في الترويسة وقائمة خطوات مرقمة. في المثال المسجَّل تمتد الخطوات من git fetch --prune إلى حذف الفروع المدمجة — ولأن كل خطوة صريحة، يتوقف الوكيل ويسأل قبل الخطوات المدمِّرة.
محادثة في Antigravity ينفذ فيها الوكيل mkdir -p .agent/workflows وnano ثم يستلم ماركداون سير العمل — ترويسة وصف إضافة إلى قائمة git من عشر خطوات.شاهد عند 6:20
4 · اختبره وأرسله وافصل بين الطبقات
- 14
شاهد حاجز الأمان وهو يعمل
تنتهي جلسة تشغيل مسار العمل المسجَّلة ببلاغ الوكيل عن الفرع المجلوب، وتصنيفه feature/about-page كمدمج وآمن للحذف، ويسأل "Would you like me to proceed with deleting these?" قبل لمس أي شيء. وهذه عادة الموافقة تشمل الوكلاء المخصصين المفوَّضين: الإجراءات التي تحتاج تصريح المستخدم تظهر في الواجهة الرئيسية، فلا يعبر المتخصص أي حد في صمت.
تقرير الوكيل عن سير العمل: الفرع feature/about-page مدمج وآمن للحذف، ويسأل "Would you like me to proceed?" قبل تشغيل git branch -d وgit gc.شاهد عند 7:46 - 15
علّمه مهارة
القواعد تصوغ السلوك؛ والمهارات تضيف المعرفة. المهارة مجلد يضم ملف SKILL.md — مهارات مساحة العمل تحت .agents/skills/<اسم-المهارة>/ والشخصية تحت ~/.gemini/skills. يخبر name وdescription في الترويسة الوكيل متى تكون المهارة ذات صلة، ويحمل الجسم التعليمات الكاملة والسكربتات والمراجع. الوكلاء المخصصون والمهارات يتكاملان: يمكن لـcodereviewer أن يستعين بمهارة nextjs-reviewer للفحوص الخاصة بالإطار.
قسم Agent Skills من وثائق Antigravity: أنشئ مجلدًا في أحد أدلة المهارات وأضف ملف SKILL.md بترويسة YAML.شاهد عند 8:42 - 16
اكتب ترويسة SKILL.md
اكتب description كمُحفِّز: "Reviews Next.js and TypeScript code for critical issues only — types, performance, security, and App Router patterns". فإذا طابق الطلب حُمّلت المهارة كاملة، وإلا فلا تعترق الطريق. هذا التحميل التدريجي هو بالضبط سبب وضع المراجع العميقة في مهارة لا في تعليمات نظام الوكيل.
ملف SKILL.md لمهارة nextjs-reviewer في محرر Antigravity: تحمل الترويسة اسم المهارة ووصفها — Reviews Next.js and TypeScript code for critical issues only.شاهد عند 9:16 - 17
شاهد المهارة تنطلق في مراجعة حقيقية
في الجلسة المسجلة، طلب مراجعة كود Next.js جعل الوكيل يحمّل مهارة المراجعة ويحلل الصفحة ويجيب بمراجعة مهيكلة: أبرزت Project Strengths الدوال المكتوبة الأنواع وتحسين الخطوط، وسأل الوكيل "Would you like me to apply these fixes for you?" قبل التعديل. يرث وكيلك المخصص هذا الانضباط إذا اشترط موجهه صيغة المخرجات نفسها.
وكيل المراجعة في العمل: يسرد نقاط قوة المشروع — دوال مكتوبة الأنواع وnext/image وأنماط App Router — ويسأل إن كان ينبغي تطبيق إصلاحاته.شاهد عند 10:15 - 18
اختبره من بيئة التطوير ومن سطر الأوامر
مع mainAgent: true يظهر المتخصص في منتقي الإدخال — اختره واسأله "What are your tools?" للتأكد من توصيل صندوق الأدوات؛ فقائمة أدوات معطوبة تفشل فورًا بخطأ تنفيذ، وهو أسرع اختبار دخان. في سطر الأوامر يسرد /agents الوكلاء المكتشفة ويفتح Alt+J لوحة الوكلاء الفرعيين لمتابعة العمل المفوَّض مباشرة.
- 19
أرسل المجلد حتى يستخدم الفريق المتخصصين أنفسهم
كل ما يحتاجه المتخصص صار في المستودع: .agents/agents/ لتعريفات الوكلاء، إضافة إلى مجلد .agent بالقواعد والمهارات وسير العمل بجوار المصدر. أودعها فيجد كل زميل — وكل تشغيل CI — المتخصصين أنفسهم بالحدود نفسها. أما التعريفات الشخصية في ~/.gemini فتبقى خارج المستودع؛ فهي تفضيلات على مستوى الجهاز.
مستكشف Antigravity والمجلد .agent مفتوح — agent وrules وskills وworkflows بجوار الكود المصدري، جاهزة للإيداع.شاهد عند 9:04 - 20
اعرف أي طبقة تفعل ماذا
طبقات التخصيص الثلاث تكمل ملف الوكيل ولا تستبدله: Rules معايير كود دائمة (أو تنطلق بنمط)، وWorkflows إجراءات بأوامر الشرطة المائلة، وSkills معرفة خبيرة تُكتشف تلقائيًا. والوكيل المخصص هو الهوية التي تربطها — ملف Markdown واحد يمنح العمل المتكرر اسمًا وصندوق أدوات وذاكرة.
جدول مقارنة بين Rules وWorkflows وSkills: معايير الكود تنطبق تلقائيًا، وأتمتة المهام بأوامر الشرطة المائلة، والمعرفة الخبيرة تُكتشف عند الحاجة.شاهد عند 10:20