GEMINI.md
Gemini CLI使用的上下文配置文件,支持全局、项目、子文件夹三个层级,用于向AI持久注入项目信息、编码规范和个人偏好,内容自动叠加生效
时间轴 (近 90 天)
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 CLI 会自动加载三个层级的 GEMINI.md 文件——全局、项目和文件夹级,无需额外配置
GEMINI.md 应记录项目特有信息(如非显而易见的构建命令、命名规范、常见坑),而非模型已掌握的通用知识
/init 命令会读取项目结构并几秒内生成一份 GEMINI.md 初稿
全局 GEMINI.md 文件通常位于用户主目录 ~/.gemini/GEMINI.md,项目文件位于 Git 仓库根目录,子文件夹文件位于任意子目录下
三层 GEMINI.md 的内容按照全局→项目→子文件夹的顺序依次注入上下文,内容累加叠加而不互相覆盖
全部知识事实 (12)
当多个层级的GEMINI.md同时存在时,它们的内容会被合并注入上下文
90%待验证GEMINI.md是一个Markdown格式的指令文件,其内容会在每次Gemini CLI会话中自动作为上下文注入给模型
90%待验证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%待验证AGENTS.md 由 OpenAI 等团队推动,定位是跨工具的通用 agent 指令文件;GEMINI.md 是 Gemini CLI 读取的项目上下文文件;它们与 CLAUDE.md 的格式要求基本一致:Markdown 编写、放在仓库根目录、启动时自动加载。
50%待验证如果仓库同时使用多个 AI 编码工具,可以维护一份主指令文件,再用符号链接或简短转发文件指向它,避免多份文件之间出现规则不一致。
50%待验证GitHub Copilot CLI会合并读取仓库中的AGENTS.md、CLAUDE.md和GEMINI.md,且文档未定义它们之间的优先级。
50%待验证三层 GEMINI.md 的内容按照全局→项目→子文件夹的顺序依次注入上下文,内容累加叠加而不互相覆盖
50%待验证Gemini CLI 会自动加载三个层级的 GEMINI.md 文件——全局、项目和文件夹级,无需额外配置
50%待验证全局 GEMINI.md 文件通常位于用户主目录 ~/.gemini/GEMINI.md,项目文件位于 Git 仓库根目录,子文件夹文件位于任意子目录下
50%待验证/init 命令会读取项目结构并几秒内生成一份 GEMINI.md 初稿
50%待验证GEMINI.md 应记录项目特有信息(如非显而易见的构建命令、命名规范、常见坑),而非模型已掌握的通用知识
50%