📰 龙虾新闻

AGENTS.md规范详解：轻量级AI Agent接口定义标准与YAML能力描述方法

发布时间：2026-08-21 分类： 龙虾新闻
摘要：Hacker News 上爆火的 AGENTS.md 提案，用一行 # Agent Interface 和几个 YAML front matter 字段，定义了 AI Agent 的能力描述标准。它不是框架，不改协议，不推 SDK，只靠结构化 Markdown 让 Agent 可被发现、可被验证、可被组合。什么是 AGENTS.md？轻量到近乎“作弊”的接口规范AGENTS.md 是一份纯文...

AGENTS.md规范详解：轻量级AI

Hacker News 上爆火的 AGENTS.md 提案，用一行 # Agent Interface 和几个 YAML front matter 字段，定义了 AI Agent 的能力描述标准。它不是框架，不改协议，不推 SDK，只靠结构化 Markdown 让 Agent 可被发现、可被验证、可被组合。

什么是 AGENTS.md？轻量到近乎“作弊”的接口规范

AGENTS.md 是一份纯文档层规范：每个 Agent 项目根目录下放一个同名文件，必须包含 name、description、capabilities（字符串数组）、input_schema（JSON Schema）、output_schema（JSON Schema），以及可选的 constraints（比如 rate_limit 或 requires_auth）。

一个天气 Agent 的完整声明长这样：

---
name: weather-lookup
description: Returns current weather and forecast for a location
capabilities:
  - get_weather
  - get_forecast
input_schema:
  type: object
  required: [location]
  properties:
    location: { type: string }
output_schema:
  type: object
  properties:
    temperature_c: { type: number }
    condition: { type: string }
    forecast: { type: array, items: { type: string } }
---
# Agent Interface

12 行 Markdown + 38 字 JSON Schema，就划清了能力边界。它不依赖 OpenClaw、LangChain 或任何运行时；不修改 HTTP 或 IPC 协议；所有字段都能被静态解析器读取——CLI 工具能生成调用预览，IDE 插件能弹出参数校验，甚至能自动生成 Swagger 风格的文档页。

为什么现在需要它？碎片化已是 Agent 开发的最大隐性成本

现在的 Agent 实现五花八门：

  • OpenClaw 用 .agent.yaml 声明函数列表
  • Claude 的 Tool Use 要求硬编码 tools 数组和 tool_choice
  • Manus 依赖私有 manifest.json
  • 大量自研 Agent 只在 README 里写一句 “调用 /v1/run”

结果是：

  • 调试时反复翻源码、抓包、试错
  • 前端集成每个 Agent 都要写一套解析逻辑
  • Agent 商店（比如龙虾 Marketplace）没法自动提取能力标签，也没法做输入合法性预检

AGENTS.md 把“我支持什么”从运行时契约，变成一行可 git diff、可 CI 检查、可 grep 的文本事实。技术债不再堆在调试阶段，而是提前到 git commit 那一刻。

技术价值不在“多强大”，而在“多便宜”

它刻意避开复杂设计：

  • 不指定传输协议（HTTP/gRPC/WebSocket 全都行）
  • 不限定序列化格式（JSON/YAML/Protobuf 自行约定）
  • 不强制注册中心（文件即注册）

核心就一件事：建立最小共识面。只要一个文件存在且符合 schema，工具链就能：
① VS Code 悬停显示输入字段说明
② 用 agents-lint CLI 批量校验全仓库 Agent 接口一致性
③ 龙虾 CLI 运行 yitb agent discover ./ 自动列出本地所有可调用 Agent，并生成交互式菜单

已有开发者用 200 行 Python 脚本，把 AGENTS.md 转成 FastAPI 的 /openapi.json，零代码接入现有 API 网关。

👉 Binance · OKX · Gate.io · HTX · Bitget

社区响应：OpenClaw 与 Claude 生态已开始对齐

虽然还没官方实现，但讨论已经落地。

  • OpenClaw 核心贡献者在 HN 评论中确认：“下周起 .agent.yaml 输出将兼容 AGENTS.md 字段映射，CLI oc list 默认支持 -f md”
  • anthropic-tools 库维护者提交 PR，新增 to_agents_md() 方法导出工具定义
  • Llama.cpp 社区也跟进——因为够轻，边缘设备上用 libmarkdown 解析 AGENTS.md 后，就能动态加载对应 GGUF 模型插件，不用预编译二进制

不是终点，而是协作起点

AGENTS.md 目前是 v0.1.2 草稿，没覆盖认证流转、流式响应标记、错误码标准化等进阶问题。但它撬动了一个关键转变：Agent 互操作性的瓶颈，未必在底层协议，而卡在元数据表达层。

你今天就能行动：

  • 在下一个 Agent 项目里新建 AGENTS.md
  • 用 5 分钟填完 6 个字段
  • 推上 GitHub

当 100 个仓库都这么做，工具链的进化速度会远超预期。

行动建议：

  • 克隆 agents-md/spec，用 yitb agent init --md（龙虾 CLI v2.4+）生成模板
  • OpenClaw 用户升级到 v0.9.3 后，运行 oc export --format=md 获取兼容输出
  • 给至少一个开源 Agent 提交 AGENTS.md PR——共识，始于第一行 # Agent Interface

相关阅读

返回首页