GEMINI.md
Gemini CLI使用的上下文配置文件,支持全局、项目、子文件夹三个层级,用于向AI持久注入项目信息、编码规范和个人偏好,内容自动叠加生效
核心事实
时间轴 (近 90 天)
Claude Code 使用 CLAUDE.md、Cursor 使用规则文件,与 GEMINI.md 同属代理指令文件类别。
Gemini CLI 默认读 GEMINI.md,但通过 context file name 设置可将 AGENTS.md 加入列表。
Claude Code 对 AGENTS.md 同一概念使用自己的命名 CLAUDE.md,Gemini CLI 则使用 GEMINI.md。
Copilot CLI 启动时全部合并加载 `AGENTS.md`、`.github/copilot-instructions.md`、`~/.copilot/copilot-instructions.md`、`CLAUDE.md` 和 `GEMINI.md`。
作者主张负责指令的文件(AGENTS.md、CLAUDE.md、GEMINI.md、.cursorrules)会不断改变,但底层事实不变,应定义一次事实并让所有指令文件指回同一来源。
AGENTS.md 由 OpenAI 等团队推动,定位是跨工具的通用 agent 指令文件;GEMINI.md 是 Gemini CLI 读取的项目上下文文件;它们与 CLAUDE.md 的格式要求基本一致:Markdown 编写、放在仓库根目录、启动时自动加载。
如果仓库同时使用多个 AI 编码工具,可以维护一份主指令文件,再用符号链接或简短转发文件指向它,避免多份文件之间出现规则不一致。
GitHub Copilot CLI会合并读取仓库中的AGENTS.md、CLAUDE.md和GEMINI.md,且文档未定义它们之间的优先级。
三层 GEMINI.md 的内容按照全局→项目→子文件夹的顺序依次注入上下文,内容累加叠加而不互相覆盖
GEMINI.md 应记录项目特有信息(如非显而易见的构建命令、命名规范、常见坑),而非模型已掌握的通用知识
还有 3 条时间轴事件
全部知识事实 (17)
Gemini CLI 采用 TOML 作为自定义命令的配置格式,命令文件存放在项目的 .gemini/commands/ 目录下
70%已验证Gemini CLI通过GEMINI.md配置文件定义项目级别的规则和偏好
65%待验证当多个层级的GEMINI.md同时存在时,它们的内容会被合并注入上下文
90%待验证GEMINI.md是一个Markdown格式的指令文件,其内容会在每次Gemini CLI会话中自动作为上下文注入给模型
90%待验证Claude Code 使用 CLAUDE.md、Cursor 使用规则文件,与 GEMINI.md 同属代理指令文件类别。
50%待验证Gemini CLI 默认读 GEMINI.md,但通过 context file name 设置可将 AGENTS.md 加入列表。
50%待验证Claude Code 对 AGENTS.md 同一概念使用自己的命名 CLAUDE.md,Gemini CLI 则使用 GEMINI.md。
50%待验证Copilot CLI 启动时全部合并加载 `AGENTS.md`、`.github/copilot-instructions.md`、`~/.copilot/copilot-instructions.md`、`CLAUDE.md` 和 `GEMINI.md`。
50%待验证作者主张负责指令的文件(AGENTS.md、CLAUDE.md、GEMINI.md、.cursorrules)会不断改变,但底层事实不变,应定义一次事实并让所有指令文件指回同一来源。
50%待验证如果仓库同时使用多个 AI 编码工具,可以维护一份主指令文件,再用符号链接或简短转发文件指向它,避免多份文件之间出现规则不一致。
50%待验证AGENTS.md 由 OpenAI 等团队推动,定位是跨工具的通用 agent 指令文件;GEMINI.md 是 Gemini CLI 读取的项目上下文文件;它们与 CLAUDE.md 的格式要求基本一致:Markdown 编写、放在仓库根目录、启动时自动加载。
50%待验证GitHub Copilot CLI会合并读取仓库中的AGENTS.md、CLAUDE.md和GEMINI.md,且文档未定义它们之间的优先级。
50%待验证Gemini CLI 会自动加载三个层级的 GEMINI.md 文件——全局、项目和文件夹级,无需额外配置
50%待验证全局 GEMINI.md 文件通常位于用户主目录 ~/.gemini/GEMINI.md,项目文件位于 Git 仓库根目录,子文件夹文件位于任意子目录下
50%待验证/init 命令会读取项目结构并几秒内生成一份 GEMINI.md 初稿
50%待验证GEMINI.md 应记录项目特有信息(如非显而易见的构建命令、命名规范、常见坑),而非模型已掌握的通用知识
50%待验证三层 GEMINI.md 的内容按照全局→项目→子文件夹的顺序依次注入上下文,内容累加叠加而不互相覆盖
50%