شرح Antigravity Rules: إعداد القواعد وسير العمل (2026)
القواعد (Rules) هي تعليمات دائمة يلتزم بها وكيل Antigravity في كل محادثة، بينما سير العمل (Workflows) هو روتين متعدد الخطوات تعيد تشغيله بأمر الشرطة المائلة. يتبع هذا الدليل تسجيل شاشة نظيفًا خطوة بخطوة، مع التحقق اليدوي من كل لقطة وربط كل خطوة بالثانية الدقيقة في الفيديو الأصلي.
الإجابة السريعة — ما هي قواعد Antigravity؟
- القواعد تعليمات دائمة يحقنها Antigravity في سياق الوكيل في كل دورة: معايير الكود والقيود والأسلوب. أما سير العمل فهو قوائم محفوظة ينفذها الوكيل عند كتابة أمر شرطة مائلة.
- يُنشأ كلاهما من لوحة Agent: افتح قائمة Customization ثم تبويب Rules واضغط + Global لجميع المشاريع أو + Workspace للمشروع الحالي فقط.
- القاعدة العامة (+ Global) تُكتب في ~/.gemini/GEMINI.md (ويصلح AGENTS.md أيضًا)؛ وقواعد مساحة العمل تُوضع في .agents/rules/*.md داخل المستودع. ومشغّلات frontmatter تحدد وقت تحميل كل قاعدة: always_on أو model_decision أو glob أو manual.
- انتبه للحدود: ملف القاعدة الواحد محدود بـ 24 كيلوبايت، وميزانية نحو 20,000 توكن للقواعد العامة وalways_on المضمنة تخفض الملفات الأكبر إلى مؤشرات مسار بدل اقتطاعها عشوائيًا.
How To Use Google Antigravity Rules & Workflows [2026 GUIDE]
الفيديو:Nexustech4:04
Rules — Google Antigravity documentation
الوثائق الرسمية:Google
حيثما يتجاوز هذا الدليل محتوى الفيديو، تكون وثائق Rules الرسمية من Google هي المرجع: حد 24 كيلوبايت لكل ملف، وميزانية 20,000 توكن للمضمّن، ومشغّلات frontmatter الأربعة.
اللقطات هي إطارات من تسجيل YouTube المُشار إليه وتُستخدم مع نسب المصدر؛ كل صورة ترتبط بالثانية الدقيقة التي أُخذت منها. خطوات الشرح من تأليفنا.
إعداد قواعد وسير العمل في Antigravity خطوة بخطوة
1 · افتح لوحة Customizations
- 1
افتح Antigravity وتأكد من المشروع المفتوح
شغّل Antigravity وانظر أولًا إلى اسم مساحة العمل في Explorer. النطاق مهم: القواعد العامة وحدها تتبعك بين المشاريع، وقواعد مساحة العمل تنطبق على المشروع المفتوح وحده — فقرر النطاق قبل أن تكتب أي شيء.
بيئة Antigravity IDE قبل أي تخصيص — انتبه لاسم مساحة العمل قبل اختيار النطاق.شاهد عند 0:20 - 2
افتح قائمة Customization من رأس لوحة Agent
في اللوحة الجانبية Agent، مرّر المؤشر فوق الأيقونات في الأعلى يمينًا حتى تظهر تلميح Customization وMCP Servers ثم انقر. سيفتح لوحة Customizations، المكان الوحيد للقواعد وسير العمل في Antigravity 2.x.
أيقونة Customization في رأس لوحة Agent بجوار MCP Servers.شاهد عند 1:30 - 3
افتح تبويب Rules
تُفتح لوحة Customizations على تبويب Rules بزرين: + Global و+ Workspace، وتحتهما يوضح Antigravity أن القواعد تساعد في توجيه سلوك الوكيل. اختر + Global لتعليمات تسري في كل مشروع، و+ Workspace لحصرها في المستودع الحالي.
قائمة قواعد فارغة مع زرّي + Global و+ Workspace.شاهد عند 1:38
2 · أنشئ أول قاعدة
- 4
اضغط + Global — وسيفتح Antigravity ملف GEMINI.md تلقائيًا
بالضغط على + Global يُفتح ملف القواعد العامة في المحرر مع سطر مؤقت. وعند التمرير فوقه تظهر بطاقة Global Antigravity IDE Rules File: القواعد العامة تُحمَّل في وضع Agent عبر جميع مساحات عملك كإرشادات محددة. وتعرض البطاقة أربع قواعد نموذجية يمكنك الاستعانة بها.
بطاقة ملف القواعد العامة توضح النطاق وتعرض قواعد نموذجية.شاهد عند 1:53 - 5
اكتب قواعدك — أسطر قصيرة، تعليمة واحدة في كل سطر
استبدل السطر المؤقت بتعليمات نصية بسيطة، واحدة في كل سطر: My testing framework is php8 وDon't use these APIs: ... وBefore making changes, create these plans first. اجعل كل قاعدة جملة واضحة واحدة — الفقرات المبهمة يتم تجاهلها.
القواعد نص مجرد، تعليمة واحدة في كل سطر، دون أي لغة تنسيق.شاهد عند 2:12 - 6
احفظ الملف — القواعد أصبحت فعّالة
احفظ GEMINI.md (النقطة في التبويب تعني تغييرات غير محفوظة). بعد الحفظ تُحقن هذه الأسطر في سياق الوكيل في كل دورة وكل مساحة عمل، فلا تعيد نفس التعليمات في المحادثة. وأيقونة المعلومات بجوار المحرر تعيد فتح شرح النطاق متى شئت.
ثلاث قواعد محفوظة في GEMINI.md — فعّالة في كل مساحات العمل من الآن.شاهد عند 2:27
3 · احفظ سير عمل قابلًا لإعادة الاستخدام
- 7
انتقل إلى تبويب Workflows
بجوار Rules يقع تبويب Workflows. يصفه Antigravity بأنه أوامر محفوظة يمكن للوكيل اتباعها — وتشغّل بكتابة / في صندوق Agent. مناسب للروتينات المتكررة: مراجعة مشروع، تحليل ملفات، تجهيز إصدار.
تبويب Workflows يشرح كيف يشغّل أمر الشرطة المائلة روتينًا محفوظًا.شاهد عند 2:58 - 8
أنشئ سير العمل وسمّه
اضغط + Global أو + Workspace تحت Workflows فيظهر مربع تسمية بمثال debug-memory-leak. اضغط Enter للتأكيد أو Escape للإلغاء. هذا الاسم سيصبح أمر الشرطة المائلة، فاجعله قصيرًا ووصفيًا — review-project أفضل من workflow1.
تسمية سير العمل — هذا الاسم يتحول إلى أمر الشرطة المائلة الخاص به.شاهد عند 3:20 - 9
ظهر خطأ الاسم غير الصالح؟ أحرف صغيرة وشرطات فقط
الاسم الذي يحوي مسافات أو أحرفًا كبيرة يُرفض: Invalid workflow name. Only lowercase letters, numbers, and hyphens are allowed. استبدل المسافات بشرطات — read-the-main-files — فيقبل المربع الاسم.
خطأ التحقق الذي يظهر عند احتواء اسم سير العمل على مسافات.شاهد عند 3:25 - 10
صِف سير العمل في frontmatter
يفتح Antigravity سير العمل كملف Markdown (باسم untitled.md حتى يتم تسميته) مع حقل description في frontmatter. اكتب سطرًا واحدًا عن وقت استخدامه — يقرأه الوكيل ليقرر ما إذا كان سير العمل مناسبًا للطلب الحالي.
كل سير عمل هو ملف Markdown مع وصف description في frontmatter.شاهد عند 3:36
4 · اكتب الخطوات وشغّل سير العمل
- 11
اسرد الخطوات بالترتيب الذي سينفذها الوكيل
تحت frontmatter، اكتب خطوات مرقمة بنص بسيط: read the main files ثم find anything that looks wrong ثم explain the problem in simple terms ثم suggest a fix ثم wait for approval before changing anything. القائمة المرتبة تجعل الوكيل منظّمًا بدل التخمين.
الخطوة الأولى read the main files مكتوبة تحت frontmatter.شاهد عند 3:48 - 12
احفظ ثم شغّل سير العمل بأمر الشرطة المائلة
احفظ ملف سير العمل، ثم ارجع إلى صندوق Agent واكتب / لعرض قائمة سير العمل لديك — اختر ما تريد وسيجري الوكيل الخطوات المحفوظة. القواعد تحافظ على اتساق سلوك الوكيل، وسير العمل يجعل روتينك المتكرر على بُعد ضغطة واحدة.
سير العمل المكتمل، جاهز للتشغيل بأمر الشرطة المائلة الخاص به.شاهد عند 3:57
قواعد Antigravity لا تعمل؟ تحقق من هذه أولًا
القواعد مكتوبة لكن بلا أثر
تحقق أولًا من موقع الملف: القواعد العامة يجب أن تكون تحت ~/.gemini/ (ملف GEMINI.md أو AGENTS.md، والملفات الوحدوية في ~/.gemini/config/rules/)، وقواعد مساحة العمل في .agents/rules/ بالمستوى الصحيح من المجلدات — لا تُفحص إلا ملفات .md المباشرة في مجلد rules، والملفات الأعمق تحتاج تسجيلًا في .agents/rules.json. وتحقق من frontmatter أيضًا: المشغّلات بصيغة camelCase مثل alwaysOn تُرفض، اكتب always_on بصيغة snake_case — والقاعدة من نوع manual لا تُحمّل إلا بذكرها بعلامة @ في المحادثة.
ملف القاعدة يُقتطع
ملف القاعدة الذي يتجاوز 24 كيلوبايت يُقتطع بعد توسيع التضمينات، فما بعد الحد لا يصل إلى النموذج إطلاقًا. قسّم القواعد الضخمة إلى ملفات وحدوية أصغر داخل مجلد rules/، موضوع واحد لكل ملف.
القواعد تختفي بهدوء من السياق
جميع القواعد العامة وalways_on المضمنة تتقاسم ميزانية نحو 20,000 توكن. عند تجاوزها يخفض Antigravity أكبر ملفات القواعد إلى مؤشرات من سطر واحد يقرأها الوكيل عند الحاجة — القاعدة ما زالت موجودة لكنها لم تعد مضمّنة بالكامل. قلّص أو قسّم مجموعك الدائم، أو حوّل القواعد الأقل استخدامًا إلى مشغّلَي model_decision أو manual.