الحلقة 1: الدليل المعماري الشامل لمنصة Google Antigravity — من التثبيت إلى بناء المهارات وتنسيق الوكلاء

ما هي منصة Google Antigravity ولماذا غيّرت هندسة البرمجيات؟

لم تعد بيئات التطوير الحديثة مجرد محررات نصوص تقترح إكمال السطر البرمجي؛ بل انتقلنا مع Google Antigravity (AGY) إلى مفهوم بيئة التطوير الوكيلة (Agentic IDE & CLI). بدلاً من الاكتفاء بالإجابة في نافذة محادثة معزولة، يمتلك الوكيل في Antigravity دورة تنفيذ متكاملة تشمل قراءة الكود، تشغيل الأوامر في الطرفية، إدارة المهام الخلفية، استدعاء خوادم Model Context Protocol (MCP)، وتفويض المهام لوكلاء فرعيين (Subagents) معزولين.

المعمارية الداخلية لمنظومة Antigravity

تتكون بيئة Google Antigravity من أربع طبقات رئيسية تعمل بتناغم:

إعداد أداة السطر البرمجي agy وبدء مشروعك الأول

للتحقق من تثبيت Antigravity CLI وفحص حالة الجلسة والموديلات المتاحة، ابدأ بتشغيل الأوامر التالية في الطرفية:

# التحقق من إصدار Google Antigravity CLI
agy --version

# فتح مشروع داخل بيئة Antigravity مع تفعيل سياق المستودع
cd ~/Desktop/projects/my-system
agy .

كيف تبني مهارة مخصصة (SKILL.md) باحترافية؟

تعتمد Antigravity على مبدأ الإفصاح التدريجي (Progressive Disclosure): لا يقرأ الوكيل كل ملفات التوثيق دفعة واحدة، بل يطّلع أولاً على name وdescription في مقدمة الملف (YAML Frontmatter)، وعندما تتطابق مهمة المستخدم مع الوصف يقوم بقراءة ملف SKILL.md بالكامل.

مثال عملي لإنشاء مهارة فحص أمني

---
name: security-gate-check
description: Run deterministic security, dependency, and prompt-injection checks before any git commit or deployment.
---

# Security Gate Check Skill

1. Inspect modified files using `git status --short`.
2. Verify no `.env` or secret tokens appear in staged diffs.
3. Run `pytest` and `npm run build` and confirm exit code `0`.

ربط خوادم MCP وتأمين استدعاء الأدوات

عند ربط Antigravity بخوادم خارجية مثل Cloudflare MCP أو PostgreSQL Guard MCP، يجب التمييز بين الأدوات المحمّلة مسبقاً (Eager Tools) والأدوات المحمّلة عند الطلب (Lazy Tools). هذا التصميم يوفر أكثر من 70% من نافذة السياق (Context Window) ويمنع بطء الاستجابة.

• استخدم الأدوات القرائية فقط (Read-Only) عند تشخيص قواعد البيانات الحية.
• افصل دائماً بين مرحلة التخطيط المعماري (`/plan`) ومرحلة التنفيذ الفعلي في المهام المعقدة.
• تجنب تشغيل حلقات فحص متكررة (Cron Polling)؛ اعتمد على نظام الإيقاظ التفاعلي المدمج في Antigravity عند انتهاء المهام الخلفية.

ماذا سنتعلم في الحلقة القادمة؟

في الحلقة الثانية من سلسلة Google Antigravity، سنقوم ببناء خادم MCP مخصص بلغة Python وربطه مباشرة ببيئة Antigravity مع فرض طبقة حماية LightGuard-Agent لفحص جميع المدخلات في أقل من 0.1 ms.