Antigravity CLI 的 GEMINI.md 指令文件與記憶怎麼寫:全局與項目級加載順序、/memory 命令用法

在 Antigravity CLI(原 Gemini CLI)裏怎麼讓終端智能體記住編碼規範與構建命令?本文按官方文檔整理全局與項目級 GEMINI.md 的加載順序、@ 導入寫法以及 /memory 命令檢查與重載步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

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

GEMINI.md 各層級位置與加載順序

圖:本站根據 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/*.mdAntigravity 工作區常駐或按需觸發只有改動特定模組才需要看的專題規範(支持 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 的模組文件才支持配置觸發條件)。編寫時抓住三條官方邊界:

  1. 指令要具體到可執行的命令:不要只寫「注意代碼質素」,改成明確的核驗指令,例如改完 TypeScript 文件後必須運行對應的類型檢查命令。
  2. 用 @ 語法做模組化導入:如果倉庫裏有現成的接口說明或數據庫規範,可以在 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
  1. 嚴控文件體積防截斷:在 Antigravity 定製系統裏,單個規則文件把 @ 引用展開後最多保留 24,000 字節(24 KB),超出部分會按行直接截斷;所有常駐規則合計共享 20,000 Token 預算,超額規則會退化為文件路徑指針。因此把最核心的禁令放在前幾十行,長篇操作手冊改做成按需加載的技能,具體做法見 CLI Skills 技能目錄與創建方法。

GEMINI.md 編寫與 /memory 調試四步

圖:本站根據 Gemini CLI 命令參考頁 整理的示意圖

三、交互終端裏的 /memory 命令怎麼用

很多時候剛建好或修改了 GEMINI.md,不確定終端到底讀沒讀進去,或者路徑寫錯了沒發現。可以在交互式會話裏直接用內置的 /memory 斜槓命令族排查:

  1. 查看已加載文件清單:輸入 /memory list,終端會列出當前會話實際識別到的全局與項目級 GEMINI.md 路徑。如果某份子目錄或根目錄文件沒出現在列表裏,先檢查文件名大小寫(必須全大寫 GEMINI.md)以及啟動終端時的工作目錄。
  2. 核對實際注入的提示詞全文:輸入 /memory show,終端會打印當前拼接完畢、正在餵給模型的完整上下文指令內容,方便檢查 @ 導入有沒有展開成功、全局與項目規則有沒有自相矛盾。
  3. 不重啟會話熱重載規則:在編輯器裏改完並儲存 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 等主流服務,實時價格與質保細則以各商品頁說明為準。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 單獨備份導出 NotebookLM 筆記本與 Gemini 記錄:只勾選指定服務不下載整個雲端硬碟的步驟

    想把 NotebookLM 裏的幾十個研究筆記本、來源副本與音頻概覽,連同 Gemini 聊天記錄一起備份到本地,又怕 Google Takeout 把整個雲端硬碟和相冊全打包?本文講清先取消全選、精準勾選兩項服務、解壓目錄查看與跨號遷移的做法。

    Gemini0
  2. 02

    Google Workspace 企業/教育版管理員怎麼在後台給成員開啟 Gemini 應用、NotebookLM 與設定年齡訪問權限

    團隊成員或學校師生登入 Google Workspace 帳號時提示無權使用 Gemini 或打不開 NotebookLM?本文按 Google 管理控制檯官方文檔整理服務開關路徑、組織部門(OU)與群組放行、18 歲年齡訪問權限設定及對話保留合規配置。

    Gemini0
  3. 03

    安卓手機預設助手換成 Gemini 後設鬧鐘、發短訊或控制智能家居失靈怎麼辦:Workspace 與實用程序擴展開啟步驟

    安卓手機把預設語音助手從 Google Assistant 換成 Gemini 後,喊它定鬧鐘、開手電筒、發短訊或開關智能燈全都沒反應?本文按官方幫助中心整理實用程序(Utilities)、Google Home 與 Workspace 關聯應用開啟步驟及鎖屏放行設定。

    Gemini0
  4. 04

    Gemini 寫長代碼或長文檔到一半突然停住、格式截斷怎麼無縫續寫:錨點接續指令與 Canvas 分塊修改技巧

    讓 Gemini 寫幾百行代碼或萬字長文時經常寫到一半突然停住、Markdown 代碼塊沒閉合,直接回「繼續」又重頭抄一遍?本文整理字面錨點續寫指令、代碼塊防亂碼補齊法與 Canvas 局部圈選修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音頻播客(Audio Overview)高階玩法:用自定義引導詞控制對談深度、受眾水平與重點章節(附模板)

    NotebookLM 生成的中文音頻播客總是泛泛而談、漏掉核心章節或夾雜生僻英文縮寫?本文按官方幫助中心整理來源勾選過濾、四種播客格式搭配與三維自定義引導詞寫法,附 4 套可直接複製的中文控場模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 影片、網頁或掃描版 PDF 提示「無法導入來源」怎麼辦:無字幕、反爬與純圖 PDF 逐項解決

    往 NotebookLM(Gemini Notebook)塞 YouTube 連結、外文網頁或掃描教材時總是亮紅歎號提示無法導入來源?本文按官方幫助中心逐項排查無字幕影片、反爬動態頁與加密純圖 PDF 的替代導入步驟。

    Gemini0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~