资讯 · 改写稿

多个写码 Agent 的配置怎么统一：AGENTS.md 与 MCP 一键同步

RefHub 编辑 · 发布 2026-10-08 · 更新于 2026-10-08 · 约 5 分钟

来源页是 V2EX 上的一个分享帖：作者做了一个命令行工具，支持把 ClaudeCode、Codex、Cursor、Pi、OpenCode 等工具的 Skills、MCP、AGENTS.md 一键同步、统一管理，目前覆盖 20 多个 Agent 工具。

它具体做什么

把各个 Agent 的 AGENTS.md 自动合并。
把所有 AGENTS.md 与 Skill 文件夹统一软链接到一个公共配置目录。
MCP 配置用一个全局 JSON 文件统一管理，并支持后台自动同步。

安装方式按来源页给的是 Homebrew：brew install --cask x0c/tap/agentsync，项目在 GitHub 的 x0c/agentsync。

为什么值得统一

多 Agent 并存时，最烦的是「同一份规则要在三个地方各写一遍」，改一处忘一处就会出现行为不一致。合并 AGENTS.md 加软链接 Skill，等于让多个工具读同一份真源；MCP 用一个全局 JSON 管，省掉逐工具维护。

落地步骤

第一步，选定一个公共配置目录，把各工具的 Skill 与 AGENTS.md 收敛进去；第二步，让工具去软链接，而不是各自复制一份；第三步，把 MCP 配置写进那个全局 JSON，并按项目区分启用清单；第四步，换机器时只同步这个公共目录。这样做的好处是改一处、处处生效，也能在多人协作时把「Agent 行为规范」当成一份可评审的文件来维护。

要留意软链接的跨平台差异：在 Windows 上创建软链接需要相应权限，跨盘符时也可能失败。如果团队里系统混杂，最好在文档里写清各平台的初始化命令，别让新人卡在第一步。

本站对照与本站计算

统一 MCP 配置时，最容易忽略的是上下文成本。站内 MCP 怎么工作里提过：接进来的 MCP 服务器会占上下文，五个服务器可能带来 100 多个工具定义、50000 多 Tokens。本站计算——用站内额度计算器（默认 1 个 Token 约合 1.5 汉字）折算，50000 Tokens ≈ 7.5 万汉字常驻在每次请求里。所以「统一管理」不等于「全都挂上」：越是集中配置，越要按当前项目只启用需要的服务器。

容易踩的坑

统一配置后把所有 MCP 都挂上：工具定义会常驻上下文，成本随之上升。

只软链接 Skill 不合并 AGENTS.md：规则仍会分叉。

换机器时忘记同步公共配置目录：软链接会指空。

自检清单

确认自己的 Agent 是否在支持的 20+ 工具之列
用合并后的 AGENTS.md 作为唯一真源
Skill 目录统一软链接到公共目录
MCP 用全局 JSON 管理，并按项目只启用需要的

同时用几个写码 Agent 的人，最先崩的是配置：每个工具各有一份 AGENTS.md、Skill 目录和 MCP 配置。一个命令行工具把它们收拢到一处。

正文约 639 字（不含 FAQ 与自检清单）

常见问题

这个工具支持哪些 Agent？

来源页说覆盖 20 多个 Agent 工具，明确点名的有 ClaudeCode、Codex、Cursor、Pi、OpenCode。

它怎么处理 AGENTS.md 和 Skill？

自动合并各 Agent 的 AGENTS.md，并把 AGENTS.md 与 Skill 文件夹统一软链接到一个公共配置目录。

MCP 配置怎么管？

用一个全局 JSON 文件统一管理，并支持后台自动同步。

统一管理后要注意什么？

别把所有 MCP 都挂上。工具定义会常驻上下文，按当前项目只启用需要的服务器更省。

来源参考

一个命令行工具，支持各种 Agent 的 Skills, MCP, AGENTS.md 一键同步、统一管理（V2EX，2026-10-08）

以上为外部来源；本文为 RefHub 用自己的结构重写，事实以来源页为准，价格与政策会变，请回源核对当日。

下一步：想理解 MCP 为什么会占上下文，读 MCP 到底怎么工作；要估算常驻成本，用额度计算器。