UAM — 统一代理清单欢迎来到UAMUnified Agent Manifest统一代理清单什么是 UAM本意UAM即「统一代理清单」是一份用于定义 AI 编程 Agent 完整行为边界的配置文件。技术定义在 AI 辅助开发中Agent 的行为受多种因素影响项目规则、技术约束、历史决策、流程规范……这些信息分散在AGENTS.md、.qoder/rules/、.claude/、openspec/等多个目录和文件中。每切换一个工具或项目开发者都不得不重新配置一套体系。UAM 将这些分散的能力整合为一个统一的配置文件入口——AGENTS.md。其核心原则是将「身份定义 规则约束 项目记忆 可复用技能 上下文构建 流程规范 工具声明」打包为一个标准化的清单文件供 Agent 在启动时一次性加载并全程遵守。一个 UAM 最少只需一个AGENTS.md文件# UAM — Unified Agent Manifest # 版本: 1.0 ## 1. 核心身份 - 技术栈: Java 17, Spring Boot 3, MyBatis-Plus ## 2. 红线规则 - 数据库操作必须使用 MyBatis-Plus禁止手写 JDBC - 所有 Controller 返回 ResultT禁止返回原始对象 ## 3. 项目记忆 - 主键策略: Snowflake ID类型 BIGINT ## 4. 可复用技能 ### 代码审查清单 1. 空指针风险 2. 事务边界 ## 5. 上下文构建 - 当前任务: [由 Agent 动态填充] ## 6. 工作流规范 所有新功能必须走: 提案 → 任务拆解 → 实施 → 归档 ## 7. 外部工具声明 - 数据库 MCP: npx mcp-mysql-server✅可选扩展scripts/执行脚本rules/规则文件skills/技能包specs/规范文档UAM 统一入口 分层配置 全生命周期管理是从「多个配置文件各自为政」到「一个清单统领全局」的关键升级。为什么需要 UAM当前 AI 编程工具生态中存在大量概念Rule、Memory、Skill、Context、OpenSpec、Subagent、MCP……它们本质都是「上下文注入」却分散在不同目录、不同文件中由不同工具各自解析。UAM 解决了三个核心痛点痛点UAM 的解法配置分散一个AGENTS.md统一管理所有配置工具锁定不依赖特定 IDE 或 CLI任何支持AGENTS.md的工具均可使用学习成本高只需理解一个文件结构而非多个概念体系如何创建 UAM方式一从零创建推荐在项目根目录创建AGENTS.md文件按以下结构填写# UAM — Unified Agent Manifest # 版本: 1.0 ## 1. 核心身份 - Agent 名称: [你的项目名] 开发助手 - 技术栈: [语言、框架、数据库] - 主要目标: [协助完成什么] ## 2. 红线规则 - [规则1] - [规则2] ## 3. 项目记忆 - [背景知识1] - [背景知识2] ## 4. 可复用技能 ### 技能名 [技能描述和操作步骤] ## 5. 上下文构建 - 当前任务: [由 Agent 动态填充] ## 6. 工作流规范 [开发流程定义] ## 7. 外部工具声明 [MCP 工具配置]方式二从现有配置迁移如果项目已有分散的配置文件如.qoder/、.claude/、openspec/可通过以下步骤整合到 UAM# 1. 创建 UAM 入口touchAGENTS.md# 2. 从各配置文件中提取关键信息# - 从 .qoder/rules/ 提取规则 → 填入「红线规则」# - 从 openspec/specs/ 提取规范 → 填入「工作流规范」# - 从 .claude/settings.json 提取工具 → 填入「外部工具声明」# 3. 保留原有目录作为执行层AGENTS.md 作为统一入口如何搜索和发现 UAM 实践进入项目后你可以通过以下方式找到适合的 UAM 模板关键词搜索在社区搜索「UAM」「AGENTS.md 模板」「AI Agent 配置」匹配项目类型和技术栈。按场景筛选Java/Spring Boot 项目包含 MyBatis-Plus、事务管理、统一响应格式等规则微服务项目包含服务间调用规范、分布式事务约束前端项目包含组件规范、API 调用约定查看 UAM 示例每个 UAM 示例展示名称、适用场景、核心规则和技能定义。点击进入详情页查看完整配置。如何下载和使用 UAM下载 UAM方式一直接创建推荐在项目根目录创建AGENTS.md文件参考模板手动填写。方式二克隆示例# 从模板仓库复制gitclone https://github.com/your-org/uam-templates.gitcpuam-templates/spring-boot/AGENTS.md ./使用 UAM在各类软件中使用 UAMUAM 遵循通用的AGENTS.md协议本质上是一套「结构化 Agent 配置清单」。只要软件支持加载AGENTS.md就可以集成使用。核心思路把AGENTS.md当作 Agent 的「启动配置文件」它包含身份定义、规则约束、技能模板和流程规范软件只需在启动时读取并解析即可让 Agent 遵循既定行为边界。通用集成步骤获取 UAM 文件在项目根目录创建AGENTS.md或从模板仓库复制现成的配置文件确保 Agent 工具读取该文件Qoder自动读取项目根目录的AGENTS.mdCodeBuddy自动识别并加载Claude Code默认读取AGENTS.md或CLAUDE.md验证配置生效启动 Agent 后询问「当前项目的技术栈是什么」检查 Agent 是否遵守规则如生成代码时是否使用 MyBatis-Plus在对话或工作流中调用通过自然语言触发如帮我做一次代码审查Agent 自动加载对应的 Skill或通过命令显式调用如/review常见软件类型的集成方式软件类型典型集成方式示例Qoder自动读取项目根目录AGENTS.mdQoder CLI / IDECodeBuddy自动识别AGENTS.md并加载CodeBuddy IDE / CLIClaude Code读取AGENTS.md或CLAUDE.mdClaude Code CLICursor通过AGENTS.md定义项目规则Cursor IDE其他 AI 编程助手配置读取AGENTS.md路径支持通用AGENTS.md协议的工具关键检查点✅ 文件是否命名为AGENTS.md并放在项目根目录✅ 是否定义了「红线规则」硬约束✅ 是否定义了「核心身份」技术栈、目标✅ 技能模板是否包含清晰的输入输出说明✅ 工作流规范是否完整提案→实施→归档在代码中使用 UAM# 以 Python 示例展示 Agent 读取 UAM 配置fromuam_agentimportUAMAgent agentUAMAgent(manifest_path./AGENTS.md,# UAM 配置文件路径modelQwen/Qwen3-235B-A22B-Instruct-2507)# 自动加载规则、记忆、技能和流程resultagent.run(实现一个用户积分查询接口)print(result)# 验证配置是否生效rulesagent.list_rules()skillsagent.list_skills()print(f已加载{len(rules)}条规则{len(skills)}个技能)注意事项首次使用建议在隔离环境中测试 UAM 配置避免误修改部分技能依赖外部 API 或数据库需自行配置连接信息使用前请阅读 UAM 模板中的技能描述确保参数格式正确如遇问题可在社区「UAM 交流」区反馈或查看示例项目与传统配置的对比维度传统方式分散配置UAM统一清单入口文件.qoder/、.claude/、openspec/多个目录一个AGENTS.md规则管理分散在各工具配置中统一在「红线规则」章节技能复用不同工具各自定义统一的技能模板格式工具切换需重新配置切换工具只需迁移一个文件学习成本需理解多个概念体系只需理解一个文件结构UAM 不是新概念而是对现有概念的重新组织——用一份文件、一个入口、一套结构让 AI Agent 从「碎片化配置」走向「统一行为边界」。2026年一个普通Coder面对AI Coding领域概念爆炸、工具林立、规则割据的局面写下的“独立宣言”。