結論先說
- Antigravity 同時原生識別
GEMINI.md和AGENTS.md:兩者放在任意目錄都會按「從當前目錄一路向上查找到倉庫根」的順序自動合併並去重;多工具混用團隊直接寫AGENTS.md最省心。 - 記住兩條硬紅線:單文件上限
24 KB,常駐總預算20,000 Token:單個規則文件(展開@說明引用後)超過 24,000 字節會按行直接截斷;所有常駐規則加起來超出 2 萬 Token 的部分,會被降級成「文件路徑指針」,不再全文塞進提示詞。 - 獨立的
GEMINI.md/AGENTS.md不支持頂部 YAML 元數據:它們在所在目錄及子目錄永遠常駐生效;只有放進.agents/rules/*.md的模組化規則,才能配trigger: model_decision實現按需懶加載。 - 個人全局習慣放
~/.gemini/config/,團隊共享規範放倉庫內:按工作區項目 > 工作區聲明配置 > 本機全局配置的優先級覆蓋。 - 谷歌帳號準備與主力編程訂閱入口:使用 Antigravity 全系列客戶端需登入符合開放地區與年齡條件的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 自動發卡的 谷歌電郵成品號);多工具主力開發訂閱總覽見 AI 會員充值中心。

圖:本站根據 Antigravity Rules 官方文檔 整理的示意圖
本文根據 Google Antigravity 官方定製系統文檔(antigravity.google/docs/rules-workflows)整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是軟件介面截圖。本站(bigolab.com)不是 Google 官方網站。
適用於誰
- 想給 Antigravity 配置團隊代碼風格、禁止修改目錄或固定測試命令的開發者;
- 把幾萬字架構手冊全塞進
GEMINI.md,結果發現智能體經常漏看後半截要求的人; - 團隊裏有人用 Antigravity、有人用 Codex 或 Cursor,想共用一份規則文件不維護多套的人。
一、三層規則目錄與加載優先級
當你打開一個代碼倉庫並編輯某個子目錄下的文件時,Antigravity 會按固定路徑自動搜集規則,並按解析後的真實文件路徑做自動去重(同一份文件在一輪對話裏絕不會重複注入兩次):
| 規則層級 | 存放路徑 | 作用域與格式要求 | 典型放置內容 |
|---|---|---|---|
| 目錄層級規則 | 任意層級的 GEMINI.md 或 AGENTS.md | 從當前工作目錄向上遍歷至倉庫根(.git 所在層);純 Markdown,不支持 frontmatter | 倉庫級構建命令、前後端子目錄各自的框架約束 |
| 工作區模組規則 | 倉庫根 .agents/rules/*.md(兼容 .agent/) | 隨 Git 提交給全組共享;支持 always_on 常駐或 model_decision 按需觸發 | 數據庫遷移安全守則、接口錯誤碼字典等專題規範 |
| 本機全局規則 | 用戶目錄 ~/.gemini/config/ | 對當前電腦上打開的所有項目生效 | 個人偏好的回覆語言(如始終用中文解釋)、提交資訊格式 |
當不同位置出現同名定製項時,官方定義的生效優先級從高到低依次為:工作區項目層級發現 > 工作區 JSON 聲明配置 > 本機 ~/.gemini/config/ 全局發現 > 內置預設配置。如果你同時在團隊裏搭配 Codex 或 Claude Code 協同開發,跨工具共享寫法的細節見 AGENTS.md 跨工具編寫指南;需要準備谷歌開發帳號或對比各家編程會員充值方案,可分別查看 谷歌帳號購買說明 與本站 AI 會員充值總覽頁。
二、為什麼規則寫太長會「失靈」:24KB 與 2 萬 Token 預算
很多開發者習慣把接口文檔、歷史踩坑記錄全往根部 GEMINI.md 裏堆,堆到三四萬字後覺得 AI「變笨了、不聽話了」。官方文檔明確給出了底層裁剪邏輯:
- 單文件硬上限(
24 KB/24,000字節):系統先把規則裏的@標籤內聯引用展開,隨後檢查總字節數。一旦超過 24,000 字節,超出部分會在行邊界被直接截斷丟棄。所以最重要、絕對不能違反的禁令必須寫在文件最前面。 - 常駐規則獨立總預算(
20,000Token):所有always_on規則和本機全局規則共用一個獨立的defaultRulesBudget(20,000 Token,與 Skills、MCP 工具的預算分開計算)。當常駐規則總和撐爆 2 萬 Token 時,排在後面的超額規則不會報錯崩潰,但會從「全文內聯注入」自動降級為僅保留一行文件路徑指針——只有模型自己判斷需要去讀該文件時才會調用讀取工具,約束力自然不如全文常駐那麼強。
三、四步搭出既省配額又聽話的規則結構

圖:本站根據 Antigravity 官方定製指南 整理的示意圖
對照上面的預算機制,推薦把倉庫規則按這四步拆乾淨:
1. 倉庫根目錄只留一份 100 行以內的 AGENTS.md
只寫每次對話都必用的核心事實:包管理器是 pnpm 還是 npm、跑單測的準確命令、絕對禁止觸碰的目錄:
markdown
# 項目全局開發規範
## 構建與校驗命令
- 安裝依賴統一使用 `pnpm install`,禁止混用 `npm` 或 `yarn`
- 修改 TypeScript 代碼後運行 `pnpm typecheck` 確認零類型報錯
## 代碼與安全紅線
- 嚴禁直接修改 `prisma/migrations/` 下已生成的歷史遷移文件
- 嚴禁硬編碼任何密鑰或改寫 `.env.production`
2. 前後端專屬細則下沉到子目錄
把 React 組件樣式規範放到 apps/web/GEMINI.md,把 Python 接口規範放到 services/api/GEMINI.md。這樣你在改後端接口時,前端那幾千字樣式規則根本不會被向上掃描加載,既省上下文又不串味。
3. 低頻長篇規範放進 .agents/rules/ 按需激活
比如「支付回調簽名驗籤規範」平時改 UI 根本用不上,把它單獨存為 .agents/rules/payment-security.md 並設為按模型判斷觸發(model_decision)。平時只注入簡短描述,涉及支付代碼時再展開全文。
4. 關鍵操作手動敲 @ 點名加固
在做高風險重構時,直接在聊天輸入框敲 @ 呼出引用選單,選中對應的規則文件附在當前消息裏,確保這一回合百分百全文讀取。想進一步減少長會話對額度的消耗,可配合閱讀 Antigravity 額度限制與省配額技巧。
常見問題
問:同一個目錄裏既有 GEMINI.md 又有 AGENTS.md,哪個生效?
答:兩個都會被自動發現並加載進上下文,不會互相覆蓋屏蔽。為避免重複佔用 2 萬 Token 預算,建議同一個目錄裏只保留其中一個文件名,把內容合在一處。
問:把操作流程寫成 Rule 好,還是寫成 Skill(技能)好?
答:只有「絕不能違背的護欄和代碼風格」適合寫成常駐 Rule;如果是「怎麼一步步發版、怎麼按模板生成新模組」這類多步驟標準作業程序(SOP),應該寫成 .agents/skills/ 下的 Skill,按漸進式披露機制用時再讀。
問:改完 GEMINI.md 儲存後需要重啟 Antigravity IDE 才生效嗎?
答:不需要重啟軟件。儲存文件後直接發起新一輪對話(或在舊版命令行使用刷新指令),系統就會按最新文件內容重新計算並注入。
問:國內沒有可用的個人谷歌帳號,或者重度寫代碼想搭配其他編程訂閱怎麼辦?
答:可在本站即時選購帶獨立 2FA 的 谷歌電郵成品號(首登順序與 3 天首登質保細則見 谷歌帳號購買頁),支持支付寶、微信支付與 AlipayHK;若日常還需要高配額終端智能體互補,也可自助兌換 Claude Code 訂閱 或 ChatGPT Plus。
0 條評論
還沒有評論,來搶沙發~