一份 AGENTS.md,同时调教好 Cursor、Copilot 和 Claude Code

一份 AGENTS.md,同时调教好 Cursor、Copilot 和 Claude Code

同时用多个 AI 编程工具的人常踩一个坑:每个工具都要重新写一遍规则,改一处要同步三处。其实 2026 年这几家的规则文件已经高度趋同,完全可以用一份主文件覆盖大部分需求。

它们各自读什么

  • AGENTS.md:事实上的通用标准。Copilot 和 Cursor 都原生读取仓库根目录的这份文件,嵌套文件遵循"最近的优先"。
  • CLAUDE.md:Claude Code 的专属规则文件。Cursor 也会读它,GitHub 甚至接受它作为 AGENTS.md 的替代。
  • 路径专属规则:Copilot 用 .github/instructions/NAME.instructions.md 配 applyTo glob;Cursor 用 .cursor/rules 下的 .mdc 文件。两者 glob 语法不完全一致,别直接复制粘贴。

推荐的迁移路径

  1. 先统一成一份主文件:在仓库根目录写 AGENTS.md,把构建命令、测试命令、目录约定写清楚。Copilot 和 Cursor 立刻都能用。
  2. 再补专属文件:加一份 CLAUDE.md 只放 Claude 特有的注意事项(比如 /compact 的使用约定)。因为 Cursor 也读它,所以内容要通用。
  3. 按需拆分路径规则:只有在某个模块确实需要特殊规则时,才拆成路径专属文件,并分别验证语法。

一个容易忽略的红利:Hooks

Cursor 可以直接加载并运行 Claude Code 的 Hook 脚本,这一对几乎不用改写。Copilot 的 Hook 文件则用不同的 schema,虽然部分事件名(sessionStart、preToolUse 等)概念相通,但要单独适配。

好的说明文件是复利投资:写一次,之后每次 AI 介入都受益。把这件事优先于"再换一个更强的工具",回报通常更高。

本文属于专题Agent 与自动化15 篇AI 编程8 篇全部专题 →
文中提到的术语AGENTS.md术语速查 →
未经允许不得转载:小7分享网 » 一份 AGENTS.md,同时调教好 Cursor、Copilot 和 Claude Code

评论 抢沙发

小7分享网 · 聚焦 AI 的实用博客

每天一篇,跟进 AI 行业动态、实测新工具、拆解实战教程。不堆术语,不炒概念,只写真正用得上的内容。

浏览全部文章关于本站

欢迎回来

登录 小7分享网,继续你的精彩

还没有账号?立即注册

忘记密码 ?

创建账号

注册后即可体验完整功能

已有账号?直接登录

我们将发送一封验证邮件至你的邮箱, 请正确填写以完成账号注册和激活