結論先說
- 新舊兩代終端都直接認
GEMINI.md:2026-06-18 起個人帳號由 Gemini CLI 遷移到 Antigravity CLI(啟動命令agy),官方遷移說明確認本機全局~/.gemini/GEMINI.md、項目內GEMINI.md和AGENTS.md均照常生效。 - 全局與項目文件是拼接疊加,不是二選一:終端從本機全局文件讀起,再到倉庫根目錄,最後讀到你當前所在的子目錄,越靠近工作目錄的指令位置越靠後、針對性越具體。
- 單個規則文件不要寫太肥:Antigravity 官方規則引擎對單個
GEMINI.md(展開@導入後)設了24 KB硬上限,超長文檔建議按模組拆分並用@路徑引入。 - 會話中途改了文件不用關掉重開:在交互終端輸入
/memory show或/memory list能核對已掛載的文件,輸入/memory refresh(部分版本寫作/memory reload)即可當場重新讀取。 - 谷歌帳號準備與多工具訂閱入口:使用 Gemini、Google AI Studio 與 Antigravity 需具備符合地區與年齡要求的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 的 谷歌電郵成品號),跨平台付費訂閱總覽見 AI 會員充值中心。

圖:本站根據 Antigravity 官方遷移與規則文檔 整理的示意圖
本文根據 Google Antigravity 官方文檔與 Gemini CLI 命令速查頁整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 官方網站。
適用於誰
- 在終端使用 Antigravity CLI(
agy)或企業/API 版 Gemini CLI(gemini),不想每次開會話都重複交代技術棧和代碼風格的開發者; - 分不清本機全局
~/.gemini/GEMINI.md、倉庫根GEMINI.md、子目錄文件誰先加載、怎麼配合的人; - 改完
GEMINI.md發現當前終端會話沒反應,想用/memory命令查看與刷新上下文的人。
一、全局、項目與子目錄 GEMINI.md 怎麼分工
在終端啟動 agy 或 gemini 時,智能體會自動沿目錄層級搜集上下文指令文件,並按解析後的真實文件路徑做去重處理,確保同一份文件在同一輪對話中不會重複注入:
| 規則層級 | 存放路徑 | 生效範圍 | 適合寫什麼 |
|---|---|---|---|
| 本機全局級 | ~/.gemini/GEMINI.md 或 ~/.gemini/config/ | 當前電腦打開的所有倉庫 | 固定中文回覆、提交資訊格式、偏好的包管理器、禁止執行的危險動作 |
| 倉庫根目錄 | <項目根>/GEMINI.md 或 AGENTS.md | 整個代碼庫(隨 Git 共享給團隊) | 項目架構簡述、單測與構建命令、分支約定、核心環境變量說明 |
| 子目錄局部級 | <子目錄>/GEMINI.md(如 apps/web/GEMINI.md) | 該子目錄及其下屬子目錄 | 前端組件命名規範、後端數據庫遷移要求、特定微服務接口約定 |
| 模組化規則 | <項目根>/.agents/rules/*.md | Antigravity 工作區常駐或按需觸發 | 只有改動特定模組才需要看的專題規範(支持 trigger: model_decision) |
如果你還沒完成從舊版 gemini 到新版 agy 的切換,安裝與帳號支持範圍見 Gemini CLI 與 Antigravity CLI 使用對比;如果團隊裏同時有人用 Cursor、Codex 和 Antigravity CLI,建議把共享規範統一寫進根目錄 AGENTS.md,跨工具兼容細節可看 AGENTS.md 編寫規範與模板。
二、GEMINI.md 怎麼寫才不容易失效
獨立的 GEMINI.md 採用純 Markdown 編寫,不支持頂部 YAML 元數據(只有放進 .agents/rules/*.md 的模組文件才支持配置觸發條件)。編寫時抓住三條官方邊界:
- 指令要具體到可執行的命令:不要只寫「注意代碼質素」,改成明確的核驗指令,例如改完 TypeScript 文件後必須運行對應的類型檢查命令。
- 用
@語法做模組化導入:如果倉庫裏有現成的接口說明或數據庫規範,可以在GEMINI.md裏用@路徑(Antigravity 規則也支持@說明)把外部 Markdown 引進來:
markdown
# 項目開發指令
## 常用構建與驗證命令
- 安裝依賴:`pnpm install`
- 運行單測:`pnpm --filter api test`
- 類型檢查:`pnpm typecheck`
## 編碼與安全邊界
- 所有接口入參必須經過 schema 校驗,禁止使用 `any`。
- 數據庫表結構變更必須生成遷移文件,嚴禁手動改歷史遷移腳本。
## 關聯子規範
- @./docs/api-error-codes.md
- @./docs/db-migration-checklist.md
- 嚴控文件體積防截斷:在 Antigravity 定製系統裏,單個規則文件把
@引用展開後最多保留24,000字節(24 KB),超出部分會按行直接截斷;所有常駐規則合計共享20,000Token 預算,超額規則會退化為文件路徑指針。因此把最核心的禁令放在前幾十行,長篇操作手冊改做成按需加載的技能,具體做法見 CLI Skills 技能目錄與創建方法。

圖:本站根據 Gemini CLI 命令參考頁 整理的示意圖
三、交互終端裏的 /memory 命令怎麼用
很多時候剛建好或修改了 GEMINI.md,不確定終端到底讀沒讀進去,或者路徑寫錯了沒發現。可以在交互式會話裏直接用內置的 /memory 斜槓命令族排查:
- 查看已加載文件清單:輸入
/memory list,終端會列出當前會話實際識別到的全局與項目級GEMINI.md路徑。如果某份子目錄或根目錄文件沒出現在列表裏,先檢查文件名大小寫(必須全大寫GEMINI.md)以及啟動終端時的工作目錄。 - 核對實際注入的提示詞全文:輸入
/memory show,終端會打印當前拼接完畢、正在餵給模型的完整上下文指令內容,方便檢查@導入有沒有展開成功、全局與項目規則有沒有自相矛盾。 - 不重啟會話熱重載規則:在編輯器裏改完並儲存
GEMINI.md後,回到終端輸入/memory refresh(舊版 Gemini CLI 文檔中也記作/memory reload),即可重新掃描並載入最新內容。
在 Antigravity CLI(agy)中,各子命令參數會隨版本演進更新,首次打開終端可先輸入 /help 查看當前客戶端內置的斜槓命令全表。若你在使用終端智能體時還沒準備好符合地區條件的個人 Google 帳號,或想對比其他終端編程訂閱,可參考 谷歌帳號開通說明 與 四款 AI 編程工具訂閱對比,需要搭配 Claude Code 等工具也可在 AI 充值服務總覽 查閱。
常見問題
問:全局 ~/.gemini/GEMINI.md 和項目根目錄 GEMINI.md 寫反了會怎樣?
答:兩邊都會被拼進上下文。如果全局寫「一律用 npm」、項目根寫「本項目用 pnpm」,模型同時看到兩條衝突要求可能會選錯。全局文件只放與具體技術棧無關的個人溝通偏好,包管理器和構建腳本一律留給項目級文件。
問:Windows 電腦上的 ~/.gemini/GEMINI.md 具體在哪個文件夾?
答:~ 對應當前登入用戶的個人主目錄,在 Windows 資源管理器或 PowerShell 裏就是 C:\Users\<你的用戶名>\.gemini\GEMINI.md。如果 .gemini 文件夾還不存在,手動新建後再放入文件即可。
問:GEMINI.md 和 settings.json 有什麼區別?
答:GEMINI.md 是寫給大模型讀的自然語言提示詞與項目背景;settings.json(Antigravity CLI 位於 ~/.gemini/antigravity-cli/settings.json)是給客戶端程序讀的 JSON 配置項,用來管主題、沙箱開關和預設審批模式,兩者不能混寫。
問:沒有可用的個人谷歌帳號,或者同時想開其他主流 AI 會員怎麼辦?
答:本站提供即買即發的 谷歌電郵成品號(登入方法見 谷歌帳號購買頁),同時支持支付寶、微信支付與 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服務,實時價格與質保細則以各商品頁說明為準。
相關教學
- Gemini CLI 與 Antigravity CLI 安裝登入及遷移說明
- Gemini CLI Skills 技能目錄與自定義創建教學
- AGENTS.md 怎麼寫:多款 AI 編程工具通用規範與模板
- Codex、Claude Code、Cursor 與 Antigravity CLI 對比選型
參考資料
- Antigravity 官方文檔:Migrating from Gemini CLI — https://antigravity.google/docs/gcli-migration
- Antigravity 官方文檔:Rules & Workflows — https://antigravity.google/docs/rules-workflows
- Antigravity 官方文檔:CLI Reference — https://antigravity.google/docs/cli/reference
- Gemini CLI 官方文檔:CLI Reference — https://geminicli.com/docs/cli/cli-reference
0 條評論
還沒有評論,來搶沙發~