Yoda
参考Agent 设计指南标准与协议

标准全景

AAIF 治理下的 agent 标准栈——MCP/AGENTS.md/Skills/ACP/A2A/AG-UI 各管一层,CC 与 Codex 的采纳面差异显著

标准全景

结论

Agent 标准已经按"接口面"分层收敛:工具/数据接入归 MCP,项目指令归 AGENTS.md,过程性知识归 Agent Skills,编辑器↔agent 归 ACP,agent↔agent 归 A2A,agent↔前端归 AG-UI/A2UI。其中 MCP、AGENTS.md、goose、agentgateway 已进入 Linux Foundation 旗下的 Agentic AI Foundation(AAIF,2025-12-09 成立)中立治理 [一手文档];ACP 由 Zed 主导(Apache 协议);A2A 由 Google 捐给 Linux Foundation(独立于 AAIF)。采纳面上 Codex 是"标准优等生"(原生 AGENTS.md + Skills + MCP),Claude Code 则坚持私有面(CLAUDE.md、自有 IDE 协议),两者都不原生实现 ACP——均靠 Zed 维护的适配器接入。对 agent-workspace 产品(Yoda)而言,运行时对接押 ACP,指令层押 AGENTS.md,扩展层押 MCP + Agent Skills,这四个面覆盖了 90% 的集成需求。

研究问题

  • 六个标准各自解决什么问题、边界在哪里、有无重叠?
  • AAIF 治理结构、成员、管辖项目到底是哪些(验证"Agent Skills 归 AAIF"的说法)?
  • CC 与 Codex 各自采纳/拒绝了哪些标准?证据是什么?
  • 对 agent-workspace 产品,哪些标准是必选项、哪些是观望项?

标准栈分层

标准接口面发起者治理方关键日期
MCPagent ↔ 工具/数据AnthropicAAIF(Linux Foundation)2024-11 发布;2025-12-09 捐入 AAIF
AGENTS.md项目 → agent 指令OpenAIAAIF2025 年发布;2025-12-09 捐入 AAIF;60k+ 项目采用
Agent Skills过程性知识打包(SKILL.md)AnthropicAnthropic 开放标准(agentskills.io);AAIF 治理未确认2025-12-18 开放
ACP (Agent Client Protocol)编辑器/客户端 ↔ agentZed(与 Google Gemini CLI 团队合作)Zed,Apache License2025-08 发布
A2A v1.0agent ↔ agent 互操作GoogleLinux Foundation(A2A Project,独立于 AAIF)2025-06-23 捐赠;v1.0 于 2026-03 发布
AG-UIagent → 前端事件流(transport)CopilotKitCopilotKit 开源2025 年发布
A2UIagent → 声明式 UI(payload 格式)GoogleGoogle 开源项目2025-12 发布

注意 AG-UI 与 A2UI 是互补而非竞争:AG-UI 定义事件传输(消息块、工具调用、状态 patch、生命周期信号如何流到前端),A2UI 定义 agent 返回的声明式组件树格式(客户端用原生控件渲染,避免跨信任边界传可执行代码)[一手文档:copilotkit.ai/ag-ui-and-a2ui]。

AAIF:治理结构与管辖范围

[一手文档] aaif.io 与 Linux Foundation 新闻稿(2025-12-09):

  • 性质:Linux Foundation 旗下 directed fund,由 Anthropic、Block、OpenAI 共同发起。
  • 管辖项目(aaif.io 截至 2026-06-11 列出 4 个):MCP(Anthropic 捐)、goose(Block 捐)、AGENTS.md(OpenAI 捐)、agentgateway(agentic AI / MCP 统一网关)。
  • 创始白金成员:AWS、Anthropic、Block、Bloomberg、Cloudflare、Google、Microsoft、OpenAI。
  • 规模:2026 年中已达 180 家成员组织;理事会主席 David Nalley。
  • MCP 体量(LF 新闻稿):月均 SDK 下载 9700 万次、活跃 server 超 1 万个。

勘误(重要):流传说法"Agent Skills 由 AAIF 治理"在 aaif.io 与 LF 新闻稿中均未得到确认——agentskills.io 是 Anthropic 自营的开放标准站点,规范由 Anthropic 维护(GitHub: agentskills/agentskills)。Agent Skills 被 Microsoft、OpenAI、Atlassian、Figma、Cursor、GitHub 等采纳是事实 [一手文档:VentureBeat/the-decoder 报道],但治理归属应表述为"Anthropic 发起的开放标准",进入 AAIF 与否标记 UNCONFIRMED。

各 Agent 设计与实现

Claude Code

CC 的策略是"标准的输出者,而非输入者"——Anthropic 定义了 MCP 和 Agent Skills,CC 自然原生支持;但对别家定义的标准(AGENTS.md、ACP)一律不原生实现:

  • MCP:原生,一等公民(docs/mcp.mdmanaged-mcp.md)[一手文档]。
  • Agent Skills:原生(docs/skills.md),SKILL.md 规范即源于 CC 的实现 [一手文档]。
  • AGENTS.md不读。官方文档明确"Claude Code reads CLAUDE.md, not AGENTS.md",推荐用 @AGENTS.md import 或符号链接桥接(claude-code-docs/docs/memory.md:125-141)[一手文档]。changelog 中无任何 AGENTS.md 原生支持的记录 [一手源码]。
  • ACP:CC 本体不实现。Zed 维护开源适配器 zed-industries/claude-code-acp(npm 包,Apache License),包装 Claude Agent SDK 并翻译为 ACP JSON-RPC [一手文档:zed.dev/blog/claude-code-via-acp]。
  • IDE 面:自有 VS Code/JetBrains 扩展 + Agent SDK,私有协议。

Codex CLI

Codex 是标准的积极采纳者,且在反向兼容 CC 生态:

  • AGENTS.md:原生且实现最完整——codex-rs/core/src/agents_md.rs 实现项目根发现、链式拼接、32KiB 预算、AGENTS.override.md 本地覆盖 [一手源码]。
  • Agent Skills:原生,codex-rs/skills/ crate 解析 SKILL.md(含 skill-creator 等内置样例)[一手源码]。
  • MCP:原生,codex-rs/rmcp-clientcodex-mcp crates [一手源码]。
  • ACPworkspace 中无任何 acp crate(grep agentclientprotocol|acp 零命中)[一手源码]。官方 IDE 面是自有的 app-server / app-server-protocol(JSON-RPC 风格,见 app-server-protocol/src/jsonrpc_lite.rs);Zed 侧由 zed-industries/codex-acp(Rust)做桥接。
  • 迁移 CC 用户codex-rs/external-agent-migration/ 专门导入 Claude 配置——SOURCE_EXTERNAL_AGENT_NAME: "claude",读取 .mcp.json、hooks、把 CC 的 commands 转成 skills [一手源码]。这是"标准竞争"的直接证据:Codex 把 CC 私有格式当作待迁移的遗产。

差异矩阵(采纳面)

标准Claude CodeCodex CLI证据
MCP原生支持(客户端)原生支持(rmcp-client)[一手文档] / [一手源码]
AGENTS.md不读,需 @AGENTS.md import 桥接原生:发现+拼接+预算完整实现memory.md:125 / agents_md.rs
Agent Skills原生支持(规范发源地)原生支持(skills crate)[一手文档] / [一手源码]
ACP经 zed-industries/claude-code-acp 适配经 zed-industries/codex-acp 适配;本体走 app-server[一手文档] / [一手源码]
A2A两边源码/文档均无 [推断]
AG-UI/A2UI同上 [推断]
项目指令私有格式CLAUDE.md(+rules/、imports)无(直接用 AGENTS.md 标准)[一手文档]

最小复现

# 1. 验证 Codex 原生 AGENTS.md、无 ACP
grep -rl "AGENTS.md" codex/codex-rs/core/src/ | head -3
# → core/src/agents_md.rs, core/src/agents_md_tests.rs ...
grep -ril "agentclientprotocol" codex/codex-rs/ --include="*.toml" --include="*.rs"
# → (空,无 ACP 依赖)

# 2. 验证 CC 不读 AGENTS.md
grep -n "AGENTS" claude-code-docs/docs/memory.md
# → 125: "Claude Code reads `CLAUDE.md`, not `AGENTS.md`..."

# 3. 验证 Codex 反向迁移 CC 配置
grep -n "SOURCE_EXTERNAL_AGENT_NAME" codex/codex-rs/external-agent-migration/src/lib.rs
# → const SOURCE_EXTERNAL_AGENT_NAME: &str = "claude";

Harness 接入建议(Yoda 实践)

对 agent-workspace IDE 产品,六个标准的优先级判断:

  1. 必押:ACP(运行时对接面)。Yoda 实现一次 ACP client,即可同时驱动 Gemini CLI(原生)、CC(claude-code-acp)、Codex(codex-acp)及 30+ agent,避免为每个 agent 写私有集成。JetBrains 已原生跟进,说明该协议能承载商业 IDE 的需求。详见 acp.md 章。
  2. 必押:AGENTS.md(指令层)。Yoda 生成/管理项目指令时一律写 AGENTS.md,对 CC 用户自动生成含 @AGENTS.md 的 CLAUDE.md 桥接文件——这是官方认可的兼容路径,零信息损耗。
  3. 必押:MCP(扩展层)。Yoda 的工作区能力(文件索引、任务系统)以 MCP server 形式暴露,则所有 agent 免费获得。
  4. 跟进:Agent Skills。两大 runtime 均已原生支持,Yoda 的"可复用工作流"应直接采用 SKILL.md 格式而非自造。
  5. 观望:A2A。面向企业 agent 网状互操作(signed Agent Cards、多租户),与单机 workspace 场景暂不相交;等 Yoda 出现跨组织 agent 委托需求再评估。
  6. 观望:AG-UI/A2UI。Yoda 自有前端可直接消费 ACP 的 session/update 流,暂不需要再加一层 AG-UI;若未来要嵌入第三方 agent 的生成式 UI,A2UI 的声明式组件树是安全的渲染格式。

迁移路径:若 Yoda 已有对 CC/Codex 的私有 spawn 集成,迁移顺序为"先把 UI 事件模型对齐 ACP 的 session/update 语义 → 替换传输层为 ACP stdio → 删私有适配代码"。

失效条件

  • aaif.io 项目列表变更(如 Agent Skills、ACP 正式捐入 AAIF)——治理归属表述需更新
  • CC 任一版本原生支持 AGENTS.md(关注 changelog 关键词 AGENTS.md)——采纳矩阵翻转
  • codex-rs 出现一等 acp crate 或 app-server 协议对外标准化——ACP 适配层结论失效
  • ACP remote(HTTP/WebSocket)从 WIP 转正——Yoda 远程 agent 架构建议需重估
  • A2A 出现编辑器/workspace 场景的 profile——"观望"判断需复核

参考资料

(访问日期均为 2026-06-11)

On this page