Skip to content
简体中文

切换主题

// 怎么做 · 让多个 agent 共用规则和技能

在 Claude Code、Codex、Cursor、Gemini CLI 之间共用一套规则

各家 agent 读取的规则文件名不同。做法是保留一份主文件(推荐 AGENTS.md),其他工具通过引用、软链接或配置指向它。

核实于 2026-10-103 个官方来源

场景:让多个 agent 共用规则和技能 →

现象

  • 同样的规则要在 CLAUDE.md、.cursor/rules、GEMINI.md 里各维护一份,经常不同步

常见原因

  • 各工具默认读取的文件名和位置不同

解决步骤

  1. 把规则写进仓库根目录的 AGENTS.md,作为唯一来源
  2. Claude Code:在 CLAUDE.md 里引用 AGENTS.md,或建立软链接 ln -s AGENTS.md CLAUDE.md
  3. Gemini CLI:可在其设置里修改上下文文件名,让它读取 AGENTS.md(以官方文档当前说明为准)
  4. Cursor:在项目规则里引用同一份内容;新版本是否直接读取 AGENTS.md 以官方文档为准
  5. 每次改规则后,在各工具里各跑一次简单任务确认已生效

注意

  • 软链接在 Windows 上需要额外权限,可改用引用方式

官方参考

2026-10-10 根据官方文档和公开讨论整理,尚未在本站环境复现;与官方文档不一致时以官方为准。

数据更新于:常见问题 / 报错