第三十课：跨代理兼容性

学习目标

• 了解 AGENTS.md 的跨代理兼容性
• 掌握从其他工具迁移的方法
• 了解各代理的特殊支持

一、兼容的代理工具

AGENTS.md 是一个开放格式，被 30+ 个 AI 编码工具支持：

1.1 完全支持

• OpenAI Codex：原生支持
• Claude Code：原生支持
• Cursor：原生支持
• GitHub Copilot Coding Agent：原生支持

1.2 部分支持

• Google Jules / Gemini CLI：支持基本格式
• JetBrains Junie：支持基本格式
• VS Code：通过扩展支持
• Aider：支持基本格式

1.3 兼容格式

• Windsurf：使用类似格式
• Devin：使用类似格式
• Augment Code：使用类似格式

二、迁移指南

2.1 从 Cursor Rules 迁移

Cursor 使用 .cursorrules 文件，格式与 AGENTS.md 类似：

1. 将 .cursorrules 内容复制到 AGENTS.md
2. 调整格式
3. 测试代理行为

2.2 从 Claude Code 配置迁移

Claude Code 使用 CLAUDE.md 文件：

1. 将 CLAUDE.md 内容复制到 AGENTS.md
2. 检查语法差异
3. 测试代理行为

2.3 从 GitHub Copilot 迁移

GitHub Copilot 使用 .github/copilot-instructions.md：

1. 将内容复制到 AGENTS.md
2. 调整格式
3. 测试代理行为

三、各代理的特殊支持

3.1 OpenAI Codex

• 支持 /init 自动生成
• 支持多层级配置
• 支持 ExecPolicy 规则

3.2 Claude Code

• 支持 CLAUDE.md
• 支持项目级和全局配置
• 支持 memory 命令

3.3 Cursor

• 支持 .cursorrules
• 支持项目级和全局配置
• 支持自定义指令

四、兼容性最佳实践

4.1 使用通用语法

避免使用特定代理的专有语法，使用通用的 Markdown 格式。

4.2 测试多代理

如果团队使用不同的代理工具，应该测试 AGENTS.md 在各工具中的表现。

4.3 保持简洁

简洁的 AGENTS.md 兼容性更好。

五、本课小结

要点	说明
兼容性	30+ 代理工具支持
迁移	从 Cursor/Claude Code/Copilot 迁移
特殊支持	各代理有不同的扩展功能
最佳实践	通用语法、测试多代理、保持简洁

下一步

下一课我们将了解 Codex App 桌面应用。