在 AI 辅助编程环境中，rules 和 AGENTS.md 都是用于向 AI 工具（如 Cursor、Claude Code、Codex 等）传递项目规范或行为指令的文件，但它们在作用范围、颗粒度、触发机制和适用场景上有显著区别。

核心区别

  • AGENTS.md：定义 AI 的角色与全局行为准则，强调“谁来做、怎么做事”，适用于多智能体协作或需要统一身份的场景。AGENTS.md 是跨工具的开放标准，用于为 AI 代理提供项目级上下文指导，如架构原则、开发流程、团队规范等。
  • rules（如 .cursorrules 或 .mdc）：定义具体的代码规范或条件性约束，强调“在什么情况下怎么做”，更侧重技术细节和按需触发。rules 通常是工具专属的配置（如 Cursor 的 .cursorrules）

详细对比

维度 AGENTS.md Rules（如 .cursorrules / .mdc）
主要用途 定义 AI 的“身份”与“岗位职责”（如“你是测试员 Agent”） 定义“代码怎么写”或“何时生效”的具体规则
作用范围 项目全局（可被所有 AI 工具读取） 可全局，也可按文件路径、语言、目录等条件触发
颗粒度 中等（角色、分工、安全基线） 细（如“禁止使用 any”、“使用 v2 认证中间件”）
触发方式 始终加载（默认适用整个项目） 条件触发（如仅在修改 src/api/ 下文件时激活）
典型内容示例 - “架构师 Agent：审核代码规范”
- “所有接口必须返回统一错误格式”		 - “所有 React 组件必须使用函数式写法”
- “@/utils/*.ts 文件必须使用 pnpm”
文件位置 项目根目录 通常位于 .cursor/rules/ 或项目根目录（视工具而定）
是否可复用 项目限定（子目录可覆盖） 可设计为跨项目复用（尤其 .mdc 格式）
工具依赖性 工具无关，通用性强 部分工具专属（如 .cursorrules 为 Cursor 专用）

注：不同工具对“rules”的命名和格式不同。例如：

  • Cursor 使用 .cursorrules 或 .mdc（位于 .cursor/rules/）
  • Claude Code 使用 CLAUDE.md
  • Codex 使用 AGENTS.md

演进趋势

  • .cursorrules 正逐步被 .mdc（模块化上下文文件）取代，后者支持条件触发、更低上下文消耗，是 2026 年主流标准 。
  • AGENTS.md 更适合团队协作与多 Agent 架构，而 rules（尤其是 .mdc）更适合细粒度、按需的编码规范 。

实践建议

若使用 Cursor，优先采用 .mdc 文件放在 .cursor/rules/ 目录下，并配合精简的 .cursorrules 作为 fallback 。

  • 若团队使用 多个 AI 工具（如 Cursor + Claude + Copilot），推荐以 AGENTS.md 作为统一规范入口，因其工具无关 。
  • 可同时使用两者：AGENTS.md 定义“角色与原则”，.mdc 定义“具体规则”，形成分层指令体系 。

例如：
AGENTS.md 声明：“你是一个后端工程师 Agent”；
auth/SERVICE.md（属于 rules 体系）规定：“所有 auth 接口必须使用 JWT v2”。

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

沙箱里的自由——Claude Code 六层纵深防御体系全解

avatar DeepSeek技术社区
cover

ChatGPT被降智怎么办？自查方法+恢复指南

avatar DeepSeek技术社区

用 ChatModel 构建 LLM 驱动的 Java 应用

ChatModel是 Solon AI 生态中的统一 LLM 客户端。同步调用— 一次请求，完整返回流式调用— 基于 Project Reactor 的响应式流（工具/函数调用— 让 LLM 调用你的 Java 方法聊天会话— 自动维护对话记忆多模态消息— 文本、图片、音频方言适配— 支持 OpenAI、Ollama、Anthropic、Gemini、DashScope 等多种服务商最核心的是它使

avatar DeepSeek技术社区