Agent 指令文件
每款编程 Agent 在开始工作前，都会加载一个项目文件，读取其中长期有效的指令。以下介绍各工具会查找哪些文件、支持哪些 frontmatter，以及全局、项目级和嵌套文件如何合并。内容已根据厂商文档于 2026-10-01 核实。
各工具读取哪些文件
| 工具 | 读取文件 | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | 原生支持 |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | 原生支持 |
| Cursor | .cursor/rules/*.mdcAGENTS.md | 原生支持 |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | 原生支持 |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | 通过配置 |
| Devin Desktop（原 Windsurf） | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | 原生支持 |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | 原生支持 |
| Aider | .aider.conf.yml | 通过配置 |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | 原生支持 |
将唯一的 AGENTS.md 作为事实来源，并让其他工具引用它。上述九种工具中有七种无需额外配置即可读取它；Gemini CLI 和 Aider 需要添加一行配置，而仅包含 @AGENTS.md 的 CLAUDE.md 可让旧版 Claude Code 保持同步。只有在需要按路径限定规则、而 AGENTS.md 无法表达时，才使用各工具自己的规则格式。
所有指令文件
AGENTS.mdAGENTS.md
AGENTS.md 是一个纯 Markdown 格式的项目指令文件，大多数编程 agent 无需额外配置即可读取。OpenAI 已将其贡献给 Linux Foundation 旗下的 Agentic AI Foundation，超过 60k 个开源项目正在使用它。
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md 是 Claude Code 在启动时从主目录、项目目录和所有父目录加载的记忆文件。.claude/rules/ 中按路径限定的规则会提供额外指引，仅在读取匹配的文件时加载。
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md 是 Gemini CLI 随每个 prompt 一同发送的上下文文件。它也可以读取 AGENTS.md，或通过 context.fileName 设置的其他文件名。
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Cursor Project Rules 是存放在 .cursor/rules/ 中的 .mdc 文件，其 frontmatter 决定每条规则何时生效。Cursor 也会读取 AGENTS.md，以及在仓库外设置的 User Rules 和 Team Rules。
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot 会读取一个仓库级文件 .github/copilot-instructions.md，以及按路径生效的 .instructions.md 文件。它也会遵循 AGENTS.md，或根目录下单独的 CLAUDE.md 或 GEMINI.md。
.devin/rules/*.mdDevin Desktop (Windsurf) rules
自 2026-06-02 起，Windsurf 更名为 Devin Desktop。它会从 .devin/rules/ 读取规则文件，同时仍支持 .windsurf/rules/ 和旧版 .windsurfrules。每条规则是否生效取决于其触发方式：始终生效、按 glob 匹配、由模型选择或手动调用。
.clinerules/Cline Rules (.clinerules/)
Cline Rules 是 .clinerules/ 中的 Markdown 文件，Cline 会将其与全局规则和 AGENTS.md 合并。可选的 paths frontmatter 可将规则限制为匹配的文件。
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw 根据工作区中的 Markdown 引导文件为每个 agent 构建上下文，其中必需的 AGENTS.md 是核心文件。每个新会话的第一轮中，这些文件都会注入 system prompt。