AGENTS.md 标准

概述

AGENTS.md 开放标准由一个行业工作组协作创建，参与方包括 Google、OpenAI、Sourcegraph、Factory 和 Cursor 等企业。2025 年 12 月 9 日，OpenAI 与 Anthropic 联合将 AGENTS.md 捐赠给 Linux 基金会，共同发起成立智能体 AI 基金会（Agentic AI Foundation，AAIF），以推动安全、可互操作的 AI 智能体开放标准的发展。

来源：Weights & Biases AGENTS.md 介绍

基金会捐赠

历史沿革

创建方：行业工作组协作
核心贡献者：Google、OpenAI、Sourcegraph、Factory、Cursor
捐赠日期：2025 年 12 月 9 日
捐赠方：OpenAI 与 Anthropic 联合
受赠方：Linux 基金会旗下智能体 AI 基金会（AAIF）

战略意义

将 AGENTS.md 捐赠给 AAIF，体现了业界对 AI 智能体指令与行为规范开放标准的承诺。这一举措确保该标准在社区治理下持续演进，而非受单一厂商掌控。

标准目的与范围

主要目标

智能体指令标准化：为 AI 智能体指令提供统一格式
行为规范：定义智能体解读和执行指令的方式
互操作性：使不同厂商的智能体能够理解通用指令格式
安全与合规：建立安全指南与合规框架

目标受众

智能体开发者：构建 AI 智能体系统的开发人员
平台提供商：提供智能体开发平台的企业
企业级用户：在生产环境中部署智能体的组织
工具构建者：为智能体生态系统开发工具和集成方案的开发人员

技术规范

文件格式与结构

标准文件名：AGENTS.md
格式：带结构化章节的 Markdown
位置：智能体项目或代码仓库的根目录

核心章节： 1. 智能体身份：名称、版本及基本标识信息 2. 能力说明：智能体能力与局限的详细描述 3. 指令：智能体行为的结构化指令 4. 安全指南：安全约束与操作边界 5. 集成：集成节点与 API 规范 6. 合规：合规要求与认证

指令格式

结构化指令：

# Agent Instructions

## Core Behavior
- Primary objectives and goals
- Decision-making frameworks
- Response patterns and styles

## Capabilities
- Available tools and functions
- Data access permissions
- Integration capabilities

## Constraints
- Safety boundaries and limitations
- Ethical guidelines and restrictions
- Performance and resource constraints

## Error Handling
- Error detection and reporting
- Recovery procedures
- Escalation protocols

元数据模式

智能体元数据：

agent:
  name: "Agent Name"
  version: "1.0.0"
  description: "Agent description"
  capabilities:
    - "capability1"
    - "capability2"
  safety_level: "enterprise"
  compliance:
    - "SOC2"
    - "GDPR"

实施指南

面向智能体开发者

创建 AGENTS.md 文件： 1. 使用模板：采用标准模板以保持一致性 2. 能力文档化：全面记录智能体的所有能力 3. 安全规范：明确指定安全约束与边界 4. 版本控制：对 AGENTS.md 文件实施版本管理 5. 验证：依据标准模式对文件进行验证

最佳实践： - 语言清晰：指令用语清晰、无歧义 - 覆盖全面：涵盖智能体行为的所有方面 - 定期更新：随智能体变更及时更新 AGENTS.md 文件 - 测试：依据已记录的指令测试智能体行为 - 社区审查：邀请社区参与审查并提供反馈

面向平台提供商

标准支持： 1. 解析器实现：在平台中实现 AGENTS.md 解析器 2. 验证工具：提供标准合规验证工具 3. 模板库：为常见场景提供模板库 4. 集成 API：提供以编程方式访问 AGENTS.md 数据的 API 5. 合规检查：实现针对标准的合规检查

平台集成： - 自动发现：自动发现并解析 AGENTS.md 文件 - 能力匹配：将智能体能力与任务需求进行匹配 - 安全执行：强制执行 AGENTS.md 中规定的安全约束 - 合规监控：监控对规定要求的合规情况 - 版本管理：处理版本控制与兼容性检查

应用场景

智能体市场

智能体发现：帮助用户发现并了解智能体能力
能力匹配：将智能体与特定任务需求进行匹配
安全评估：在部署前评估智能体的安全性与合规性
质量保证：确保智能体达到市场质量标准

企业级部署

治理：为企业级智能体部署提供治理框架
合规：确保智能体满足企业合规要求
风险管理：评估并管理智能体部署相关风险
审计追踪：维护智能体行为与决策的审计追踪记录

开发工作流

文档化：为智能体开发提供标准化文档
测试：依据已记录的规范测试智能体行为
集成：促进不同智能体系统之间的集成
维护：简化智能体系统的维护与更新

安全与保障

安全边界：明确定义安全边界与约束
安全策略：规定安全策略与要求
事件响应：定义事件响应流程与规程
合规验证：验证对监管要求的合规情况

行业协作

工作组结构

核心贡献者： - Google：技术领导与平台集成 - OpenAI：智能体指令框架与安全指南 - Sourcegraph：代码智能与开发者工具集成 - Factory：企业级部署与治理框架 - Cursor：开发者体验与工具集成

协作流程： - 定期会议：定期召开工作组会议与讨论 - 开放开发：接受社区参与的开放开发流程 - 共识构建：通过共识构建流程做出决策 - 公开评审：针对重大规范变更设置公开评审期

社区参与

反馈机制： - GitHub 讨论：在 GitHub 仓库上开展公开讨论 - 社区论坛：专设社区讨论论坛 - 工作组会议：开放社区参与的工作组会议 - 调研与反馈：定期开展调研并收集反馈

贡献流程： - 规范贡献：参与规范开发的贡献流程 - 实施反馈：对实施经验的反馈 - 应用场景分享：分享应用场景与实施模式 - 最佳实践开发：协作开发最佳实践

合规与认证

合规框架

合规层级： - 基础合规：AGENTS.md 实施的最低要求 - 标准合规：完全满足所有规范要求 - 增强合规：附加安全与保障要求 - 企业级合规：企业级合规与治理

认证流程： - 自我评估：自我评估工具与清单 - 第三方验证：第三方验证与认证服务 - 持续监控：持续的合规监控与报告 - 审计支持：为合规审计与评估提供支持

安全与保障标准

安全要求： - 边界规范：明确规定智能体操作边界 - 风险评估：全面的风险评估与缓解策略 - 事件报告：标准化的事件报告与响应流程 - 安全监控：持续的安全监控与告警

保障要求： - 访问控制：精细的访问控制与权限管理 - 数据保护：数据保护与隐私要求 - 审计日志：全面的审计日志与监控 - 漏洞管理：漏洞评估与管理流程

工具与生态系统

开发工具

验证工具： - 模式验证器：依据标准模式验证 AGENTS.md 文件的工具 - Lint 工具：检查 AGENTS.md 文件质量与一致性的 Lint 工具 - 测试框架：用于智能体行为验证的测试框架 - 文档生成器：从 AGENTS.md 文件生成文档的工具

集成工具： - 解析器库：支持多种语言解析 AGENTS.md 文件的库 - API 生成器：从 AGENTS.md 规范生成 API 的工具 - 部署工具：基于 AGENTS.md 规范部署智能体的工具 - 监控工具：监控智能体对 AGENTS.md 规范合规性的工具

平台支持

已支持平台： - 智能体开发框架：与主流智能体开发框架集成 - 云平台：在主流云平台与服务中提供支持 - 企业级平台：与企业级智能体管理平台集成 - 开发者工具：在主流开发者工具与 IDE 中提供支持

社区资源： - 模板库：面向常见场景的 AGENTS.md 模板库 - 最佳实践指南：实施 AGENTS.md 的综合指南 - 示例实现：示例实现与案例研究 - 社区论坛：活跃的社区支持与讨论论坛

未来发展

路线图与演进

近期目标： - 规范定稿：完成正式规范文档 - 工具开发：构建完善的工具生态系统 - 平台集成：与主流智能体开发平台集成 - 社区建设：建立活跃的开发者与用户社区

长期愿景： - 行业标准：成为智能体指令事实上的行业标准 - 高级特性：添加智能体学习与自适应等高级特性 - 国际标准化：推动国际标准化进程 - 生态成熟：打造具备完善工具与支持体系的成熟生态

研究与开发

当前研究方向： - 指令优化：研究最优指令格式与结构 - 安全增强：先进的安全机制与验证技术 - 互操作性：与其他智能体标准的增强互操作性 - 自动化：AGENTS.md 文件的自动化生成与验证

学术合作： - 研究合作伙伴：与高校科研机构建立合作关系 - 学术发表：发表 AGENTS.md 研究与开发方面的学术论文 - 会议演讲：在主流 AI 与软件会议上进行演讲 - 学生项目：支持学生项目与科研计划

参见

智能体技能 / SKILLS.md
Model Context Protocol
Agent2Agent 协议
智能体 AI 基金会
智能体运行框架工程
开放知识格式（OKF） — 面向智能体可读知识/元数据的互补约定，与 AGENTS.md 的行为指令相辅相成