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 条评论

登录 后参与评论

还没有评论,来抢沙发~