AI Agent 通用配置层 — 深度研究报告
整理时间：2026-03-28 | 核心问题：如何让 AI Agent 的”灵魂、记忆、能力”跨平台通用流转
一、问题定义
现在主流的 AI 编码 Agent 平台，每个都搞自己的一套配置体系：
同一件事，7种文件名：
| 概念 | OpenClaw | Claude Code | Codex | Cursor | Windsurf | Copilot | Aider |
|---|---|---|---|---|---|---|---|
| 人设/灵魂 | SOUL.md | CLAUDE.md | AGENTS.md | .cursorrules | .windsurfrules | copilot-instructions.md | .aider.conf.yml |
| 记忆 | MEMORY.md | auto memory | 会话 | Cascade Memory | - | - | |
| 任务定义 | AGENTS.md | CLAUDE.md | AGENTS.md | .cursor/rules/ | .windsurf/rules/ | .github/instructions/ | |
| 工具 | Skills/ | MCP | MCP | MCP | MCP | MCP | MCP |
| 用户偏好 | USER.md | ~/.claude/CLAUDE.md | - | User Rules | Global Rules | Personal |
本质都一样：告诉 AI 你是谁、项目怎么工作、该怎么做。但格式、位置、语法全部不同。
二、各平台配置体系详解
1. OpenClaw
workspace/
├── SOUL.md # 人设/灵魂
├── AGENTS.md # 工作规则
├── USER.md # 用户画像
├── MEMORY.md # 长期记忆
├── TOOLS.md # 工具备注
├── HEARTBEAT.md # 心跳任务
├── memory/ # 每日记忆
│ └── YYYY-MM-DD.md
└── skills/ # 技能定义
└── */SKILL.md
特点： 最完整，有灵魂、记忆、用户、心跳。但格式非标准，只 OpenClaw 能读。
2. Claude Code
project/
├── CLAUDE.md # 项目规则（Git 提交）
├── CLAUDE.local.md # 本地个人规则（不提交）
├── .claude/
│ └── rules/ # 模块化规则
│ └── *.md # paths frontmatter 作用域
~/.claude/
├── CLAUDE.md # 全局用户偏好
├── rules/ # 全局规则
└── projects/<project>/
└── memory/ # Auto Memory（AI 自动写入）
特点：
- 层级最丰富：管理策略 > 项目 > 用户 > 本地
@path导入语法（最多5层嵌套）- Auto Memory：AI 自动记住你的偏好和纠正
pathsfrontmatter 做 glob 作用域
3. OpenAI Codex
project/
└── AGENTS.md # 唯一的配置文件
特点： 最简单，一个 AGENTS.md 搞定。OpenAI 在 Harness Engineering 文章中提到 AGENTS.md 本身也是 Codex 写的。
4. Cursor
project/
├── .cursorrules # 遗留格式（单文件）
└── .cursor/
└── rules/ # 现代格式（多文件）
├── general.mdc # alwaysApply: true
├── react-rules.md # globs: ["**/*.tsx"]
└── api-patterns.md # 手动 @引用
特点：
- 4种激活模式：始终应用 / 智能应用 / 文件匹配 / 手动引用
- YAML frontmatter 控制注入
- 团队规则 > 项目规则 > 用户规则
- 规则上限 500 行
5. Windsurf
project/
├── .windsurfrules # 遗留格式
└── .windsurf/
└── rules/ # 现代格式
└── *.md # 12,000字符/文件上限
特点：
- 全局规则 6,000 字符，工作区规则 12,000 字符
- Cascade Memories：AI 自动生成的会话笔记
- 也支持 AGENTS.md（新版）
6. GitHub Copilot
project/
└── .github/
├── copilot-instructions.md # 全局指令
└── instructions/ # 路径作用域
└── *.md # glob frontmatter
特点： 最广泛的 IDE 覆盖（VS Code、JetBrains、VS、Xcode）
三、通用配置层设计
核心理念
通用原料（定义一次） 适配器（自动转换） 各平台
┌─────────────────┐ ┌───────────────┐ ┌──────────┐
│ soul.yaml │ │ openclaw/ │ │ OpenClaw │
│ memory/ │─────→│ claude-code/ │─────→│ Claude │
│ agents.yaml │ │ cursor/ │ │ Cursor │
│ skills/ │ │ codex/ │ │ Codex │
│ routing.yaml │ │ windsurf/ │ │ Windsurf │
│ user.yaml │ │ copilot/ │ │ Copilot │
└─────────────────┘ └───────────────┘ └──────────┘
通用 Schema 设计
# universal-agent/soul.yaml
identity:
name: 小jason
emoji: 😇
personality:
- 真诚，不表演
- 有观点，不谄媚
- 先试再问
values:
- 独立思考（王小波）
- 长期主义（段永平）
- 价值投资（巴菲特）
- 多元思维（芒格）
# universal-agent/memory/
# └── YYYY-MM-DD.md（每日记忆，Git 同步）
# universal-agent/agents.yaml
rules:
- 不要直接 push 到 main
- 使用中文回复
- 静默时段不推送
workflow:
- 收到任务立即确认
- 复杂任务报告进度
- 完成后通知
# universal-agent/skills/
# └── */SKILL.md（与 OpenClaw 格式兼容）
# universal-agent/user.yaml
user:
name: 吴老大
timezone: Asia/Shanghai
preferences:
- 中英双语分析
- 关注中美科技股
- 爱好运动和科技
# universal-agent/routing.yaml
routing:
coding:
default: claude-code
research: codex
ide: cursor
chat:
default: openclaw
knowledge:
input: obsidian
output: blog四、已有的开源方案
agentinit（最接近的）
- GitHub: github.com/agentinit/agentinit
- 做的事： 统一
agents.md→ 双向同步到各平台 - 命令：
agentinit init / detect / sync - 覆盖： Claude Code、Cursor、Windsurf、Copilot
- 不足：
- 只管规则文件，不管灵魂/记忆/技能
- 没有 memory 系统的概念
- 没有 routing
MCP 协议（工具层已标准化）
- 标准化了工具调用接口
- 但没管人设、记忆、路由
LangChain DeepAgents（Harness 层）
- 通用 Agent Harness
- 但绑了 LangChain 生态
五、吴老大已做的架构
┌──────────────┐
│ GitHub 私有仓 │
│ (obsidian) │
└──┬───────┬───┘
│ Git │ Git
↓ ↓
┌──────────┐ ┌──────────┐ ┌──────────┐
│ OpenClaw │←──→│ 记忆同步 │←──→│ Claude │
│ SOUL.md │ │ MEMORY.md │ │ CLAUDE.md│
│ AGENTS.md │ │ memory/ │ │ → soul │
│ Skills/ │ │ (每日) │ │ → agents │
└──────────┘ └──────────┘ └──────────┘
│
↓
┌──────────┐
│ Obsidian │ ← 外挂大脑
│ 知识收集 │ ← Jina Reader 剪藏
│ 沉淀输出 │ ← 博客/报告
└──────────┘
已实现：
- ✅ CLAUDE.md → 指向 SOUL.md + AGENTS.md（适配器）
- ✅ 每日 memory 通过 Git 同步
- ✅ Obsidian 作为知识收集和沉淀输出层
- ✅ Jina Reader 做内容剪藏
待完善：
- 统一 schema（从各平台 md 提取公共部分）
- routing.yaml（任务路由配置）
- Cursor / Windsurf / Copilot 适配器
- 双向同步脚本（改一边自动同步到另一边）
- 知识输出 → 博客发布管道
六、结论与建议
市场现状
- 没有人做完整的通用配置层（灵魂+记忆+技能+路由）
- agentinit 做了规则同步，但不涉及记忆和灵魂
- MCP 标准化了工具，但不管人设和上下文
- 这是一个有价值的开源项目方向
你的架构优势
你已经在做的比 agentinit 更深入：
- 灵魂层 — SOUL.md 定义身份，不是简单的编码规则
- 记忆层 — 每日 memory + MEMORY.md 长期记忆，Git 同步
- 知识层 — Obsidian 作为外挂大脑，输入剪藏 + 输出博客
- 适配器 — CLAUDE.md 已经指向 OpenClaw 的文件
建议下一步
- 把你已做的抽象成通用 schema
- 写一个
agent-syncCLI：一个命令同步所有平台 - 开源出来 — 这是很多人需要但没人做好的东西