‏Antigravity ایجنت‌های سفارشی رو معرفی کرد

تیم Antigravity تو یه پست رسمی از Custom Agents رونمایی کرده — ایجنت‌های تخصصی که تو Antigravity 2.0 و Antigravity CLI پشتیبانی کامل دارن و به گفتهٔ تیم، به‌زودی به IDE هم می‌رسن. استدلالشون اینه که دستیارهای کدنویسی عمومی دو تا ضعف دارن: قواعد خاص پروژهٔ تو — کانوِنشن تست، قواعد مدیریت وابستگی‌ها — رو نمی‌دونن مگه هر بار براشون توضیح بدی، و ریختن همهٔ اون قواعد تو یه پرامپت غول‌پیکر، بودجهٔ توکن رو می‌سوزونه.

هر custom agent فقط یه فایل Markdown با فرانت‌متر YAML ـه — یعنی همون هدر تنظیمات بالای فایل — که اسم، مدل و ابزارهای مجاز رو مشخص می‌کنه، و بدنهٔ Markdown مستقیم به system prompt خود ایجنت تبدیل می‌شه. فایل‌ها یا تو .agents/agents/ داخل خود پروژه می‌شینن یا کاربری تو ~/.gemini/config/agents/. نکتهٔ عملیش اینه که با commit کردن پوشهٔ پروژه تو ریپو، هر هم‌تیمی بعد از checkout همون ایجنت‌ها رو بدون هیچ نصب دستی داره.

name: dependency-modernizer
description: Helps upgrade local packages and verify that project tests pass.
model: flash
tools:
  - view_file
  - run_command

تیم می‌گه فرمت فایل رو عمداً شبیه بقیهٔ ابزارها نگه داشتن تا انتقال ایجنت‌های موجود راحت باشه، ولی تفاوت اصلی جای دیگه‌ست: چیزی که بهش execution symmetry می‌گن. تو ابزارهای مشابه، یه ایجنت سفارشی فقط می‌تونه زیرایجنت باشه و ایجنت اصلی پشت صحنه صداش می‌زنه؛ اینجا با دو تا فلگ ساده همون ایجنت رو مستقیم به‌عنوان ایجنت اصلی هم انتخاب می‌کنی — از منوی Antigravity 2.0 یا با agy --agent dependency-modernizer تو CLI.

mainAgent: true
subagent: true
permissionMode: acceptEdits
commandExecutionPolicy: auto

دو تا اهرم کنترلی دیگه هم اضافه شده. commandExecutionPolicy: auto اجازه می‌ده ایجنت دستورهای استاندارد تست و build رو خودش تو پس‌زمینه اجرا کنه، ولی دستورهای پرخطر مثل حذف فایل همچنان پشت تأیید دستی می‌مونن — یعنی چرخهٔ آزمون‌وخطا سریع پیش می‌ره بدون اینکه مدام ازت اجازه بگیره. کنارش هوک‌های چرخهٔ عمر به‌شکل تو در تو تعریف می‌شن: PreInvocation قبل از اینکه ایجنت شروع به کار کنه یه اسکریپت setup اجرا می‌کنه، و PreToolUse با matcher می‌تونه قبل از هر اجرای دستور، سلامت محیط محلی رو چک کنه.

نکات کلیدی:

• Custom Agents الان تو Antigravity 2.0 و Antigravity CLI فعاله؛ به گفتهٔ تیم، IDE بعداً اضافه می‌شه.
• هر ایجنت یه فایل Markdown با فرانت‌متر YAML ـه؛ مسیر پروژه‌ای .agents/agents/ و مسیر کاربری ~/.gemini/config/agents/.
• فلگ‌های mainAgent و subagent باعث می‌شن یه ایجنت هم مستقیم اجرا بشه هم به‌عنوان زیرایجنت صدا زده بشه.
• commandExecutionPolicy: auto دستورهای تست و build رو خودکار می‌کنه ولی دستورهای پرخطر رو پشت تأیید دستی نگه می‌داره.
• هوک‌ها تو در تو تعریف می‌شن؛ PreToolUse با matcher روی یه ابزار خاص مثل run_command عمل می‌کنه.