dotsagent.io
语言:简体中文
GEMINI.md

GEMINI.md (Gemini CLI):存放位置及工具读取方式

GEMINI.md 是 Gemini CLI 随每个 prompt 一同发送的上下文文件。它也可以读取 AGENTS.md,或通过 context.fileName 设置的其他文件名。

存放位置

  • 全局:~/.gemini/GEMINI.md。
  • 工作区目录及其父目录中的 GEMINI.md。
  • 工具访问目录中按需发现的 GEMINI.md,以及这些目录向上直到可信根目录的祖先目录中的文件。

格式

使用 Markdown,不支持 frontmatter。通过 Memory Import Processor 使用 @file.md 引入其他文件,路径可以是相对路径或绝对路径。可通过 context.fileName 配置文件名,值可以是字符串或列表。

GEMINI.md
# Project context

@./docs/architecture.md

## Commands

- Install: `uv sync`
- Test: `uv run pytest`
- Lint: `uv run ruff check .`

## Rules

- Target Python 3.13 with type hints on public functions.
- Keep database code in app/db/.
- Never run migrations against production.

优先级与合并

文件按以下顺序加载:全局文件、工作区及祖先目录中的文件,然后是按需发现的文件。所有文件都会串联起来,并随每个 prompt 一同发送,因此不会相互覆盖。

可读取该文件的工具

工具支持情况
Gemini CLI原生支持。通过 context.fileName 重命名文件或添加 AGENTS.md;使用 /memory show 和 /memory reload 检查文件。
GitHub Copilot将根目录中的 GEMINI.md 作为 Agent 指令读取,可替代 AGENTS.md。

提示

  • 在 .gemini/settings.json 中将 context.fileName 设为 ["AGENTS.md", "GEMINI.md"],即可与其他 Agent 共用一个文件。
  • 每个已加载文件都会随每个 prompt 一同发送,因此请删减模型无需每次读取的内容。
  • 使用 /memory show 查看 Gemini CLI 实际加载的内容,编辑后使用 /memory reload 重新加载。

通过一个表单,为五种工具生成 AGENTS.md 和对应的规则文件。 打开 AGENTS.md 生成器 →

其他指令文件

来源

  1. geminicli.com/docs/cli/gemini-md/

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期:2026年10月1日