代理配置之战:为什么你的 AI Agent 文档已经过时 🤯

发布: (2025年12月20日 GMT+8 04:18)
4 min read
原文: Dev.to

Source: Dev.to

TL;DR

AGENTS.md 可能已经失效。代理配置标准的生态极其混乱且不断变化。

The Current Chaos

  • Initial hope: “Finally! A standard for agent configuration!”

    # MyAwesomeAgent
    Does cool stuff!

    简单、清晰、完美。

  • Rapid turnover:

    • 一条推文声称 SKILL.md 是新标准。
    • Anthropic 发布了 Model Context Protocol。
    • Discord 讨论此起彼伏。
  • Competing voices:

    • Big Tech: “使用我们的标准!”(把你锁进他们的生态)
    • 开源社区: “不,使用我们的标准!”(每个冲刺都在改)
    • 框架开发者: “像普通人一样直接用 JSON 吧!”(但到底用哪种 JSON 结构?)
    • Reddit 用户: “YAML 更好……”(没人问过)

这感觉就像在看人们争论如何整理一座正在燃烧的房子。

What a Real Standard Requires

  • ✅ 一个治理机构
  • ✅ 多个实现
  • ✅ 向后兼容的承诺
  • ✅ 存在时间超过三周

What We Have Right Now

  • ❌ 随机的 GitHub 仓库
  • ❌ 单人宠物项目
  • ❌ 每周二都有“破坏性更改”
  • ❌ 文档在写完之前就已经过时

Lessons Learned

  1. 停止追逐神话般的标准。
  2. 选择 任何 能满足以下条件的方案:
    • 你能理解
    • 你的团队能阅读
    • 能配合你的工具使用
    • 以后可以再改

标准会演进;你的配置文件也需要重写。这是前沿技术的特性,而不是 bug。

Hot Takes

  • Hot Take #1: AGENTS.md 并未死,它根本就没有真正活过。
  • Hot Take #2: “胜出”的标准将是 Claude、GPT 或 Gemini 本身能够原生理解的格式。
  • Hot Take #3: 我们仍将在 2026 年继续争论此事。
  • Hot Take #4: 真正的标准是我们一路上交到的朋友……开玩笑的,实际上是 JSON。

Looking Ahead

当社区仍在争论 .md.json.yaml 的优劣时,AI 模型仍在不断提升。等我们“解决”代理配置时,代理可能根本不需要配置文件——它们会直接知道

历史表明,竞争的标准最终会合并:

  • USB vs FireWire vs Thunderbolt → USB‑C
  • 多种视频格式 → H.264/H.265
  • 各种 JS 模块系统 → ES Modules

我们可能会看到类似的代理标准合并:

  1. 底层协议: 代理之间如何通信(例如 MCP、Agent Protocol)
  2. 中层规范: 代理如何定义(基于 JSON‑Schema 的配置)
  3. 高层约定: 人类可读的文档(基于 Markdown)

潜在的主流模式:

  • 一个用于代理间通信的标准
  • 一个用于代理与工具集成的标准
  • 平台特定的配置,最终编译为上述标准

Key Success Factors

  1. 行业背书
  2. 开放治理
  3. 实际采纳

写于沮丧之中,发布以示团结。愿你的配置保持向后兼容,愿你的标准真正成为标准。

Back to Blog

相关文章

阅读更多 »

仓库利用的权威指南

引言 仓库本质上只是一个 3‑D 盒子。利用率只是衡量你实际使用了该盒子多少的指标。虽然物流 c...