各 AI 编程 agent 的规则与指令文件：.cursor/rules、CLAUDE.md、AGENTS.md、GEMINI.md、Copilot instructions 等（2026）

• Cursor：项目规则是 .cursor/rules 中的 .mdc 文件（放在那里的普通 .md 文件会被忽略）。User Rules 位于 Customize 下的 Rules。Team Rules 来自 Team 和 Enterprise 套餐的控制台。AGENTS.md 在根目录和子文件夹中均可使用。
• Claude Code：团队用 ./CLAUDE.md 或 ./.claude/CLAUDE.md，个人用 ~/.claude/CLAUDE.md，私有项目笔记用 ./CLAUDE.local.md。运行 /init 可生成一个。
• OpenAI Codex：~/.codex 中的 AGENTS.md 用于全局习惯，然后从仓库根目录到当前工作目录，每个目录一个 AGENTS.md（或 AGENTS.override.md）。
• Gemini CLI：全局使用 ~/.gemini/GEMINI.md，项目中使用 GEMINI.md。/memory show 会打印已加载的内容。
• GitHub Copilot：.github/copilot-instructions.md 作用于整个仓库，带 applyTo glob 的 .github/instructions/NAME.instructions.md 作用于部分文件，AGENTS.md 可放在仓库任意位置。
• Cline：项目中 .clinerules/ 或 .cline/rules/ 下的 markdown 文件，全局规则放在 ~/Documents/Cline/Rules。
• Kiro：.kiro/steering/（工作区）或 ~/.kiro/steering/（全局）中的 markdown steering 文件，另加 AGENTS.md。
• Junie：先读 .junie/AGENTS.md，再读根目录 AGENTS.md，然后是旧版 .junie/guidelines.md。全局指南放在 ~/.junie/AGENTS.md。
• Amp：工作目录及其上级目录中的 AGENTS.md，另加 ~/.config/amp/AGENTS.md。
• goose：AGENTS.md 和 .goosehints，全局位于 ~/.config/goose/.goosehints，也可按项目放置。
• Zed：个人用 ~/.config/zed/AGENTS.md，然后读取在一个列表中找到的第一个项目文件，该列表以 .rules、.cursorrules 和 .windsurfrules 开头，也包含 AGENTS.md 和 CLAUDE.md。
• Aider：没有专用文件。编写 CONVENTIONS.md，并通过 aider --read CONVENTIONS.md 或 .aider.conf.yml 中的 read: 加载。

基本通用。以下 agent 无需额外配置即可读取 AGENTS.md：Cursor、Codex、GitHub Copilot、Cline、Kiro、Junie、Amp、goose 和 Zed。Claude Code 仅在仓库没有 CLAUDE.md 时读取 AGENTS.md。如果两者都保留，在 CLAUDE.md 中加入 @AGENTS.md，让 Claude Code 导入它。Gemini CLI 需要在 settings.json 中设置 context.fileName。

@AGENTS.md

## Claude Code only
- Use plan mode for changes that touch more than three files.

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Cursor 当前的规则文档介绍了 .cursor/rules 中的 .mdc 文件、User Rules、Team Rules 和 AGENTS.md，没有记载根目录的 .cursorrules 文件。其他工具仍会读取这个文件名：Cline 会自动识别 .cursorrules，Zed 在项目指令文件列表中第二个检查 .cursorrules。新项目请把共享指令放在 AGENTS.md，把 Cursor 专用的范围设置放在 .cursor/rules。

• Cursor：在 .mdc frontmatter 中使用 globs，并设置 alwaysApply: false。
• Claude Code：在 .claude/rules/ 下的 markdown 文件中使用 paths 字段。
• GitHub Copilot：在 .instructions.md 文件的 frontmatter 中使用 applyTo。
• Cline：在 YAML frontmatter 中使用 paths 列表。
• Kiro：inclusion: fileMatch 搭配 fileMatchPattern。
• Amp：在从 AGENTS.md 中 @ 提及的文件的 front matter 里使用 globs。
• Codex：在需要不同规则的子文件夹中放一个 AGENTS.md 或 AGENTS.override.md。

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports

---
applyTo: "**/*.py"
---

Use type hints on every public function.

• Cursor 规则设置：.mdc frontmatter、Team Rules 和 AGENTS.md
• Claude Code CLAUDE.md：位置、导入和 AGENTS.md
• Codex AGENTS.md：全局、项目和 override 文件
• Gemini CLI GEMINI.md：位置、导入和 /memory
• GitHub Copilot 自定义指令
• Cline Rules：工作区、全局和条件规则
• Kiro steering 文件和 inclusion 模式
• Junie 指南和 AGENTS.md
• Amp AGENTS.md 和按 glob 限定的指引
• goose .goosehints 和 AGENTS.md
• Zed 指令文件、MCP 和工具权限
• Aider CONVENTIONS.md 和 .aider.conf.yml
• 可直接复制的 Cursor 规则模板
• AGENTS.md 参考与生成器