如何为 AI Agent 写出完美的 SOUL.md 人格文件(2026指南)

21 阅读1分钟

你的 AI Agent 好不好用,80% 取决于它的人格文件。

什么是 SOUL.md?

SOUL.md 是一个 Markdown 文件,定义了 AI Agent 的性格、语气、知识边界和行为规则。可以理解为 AI 的 DNA。

没有 SOUL.md,你得到的是千篇一律的回复。有了好的 SOUL.md,你得到的是一个真正懂你的 AI 助手。

OpenClaw 等框架用 SOUL.md 作为 Agent 的核心身份文件。但这些原则适用于任何 AI 系统。

为什么大多数 AI Agent 感觉很通用?

最常见的错误:写模糊的指令,比如请友好专业地回答。

这等于什么都没说。好的 SOUL.md 是具体的、有态度的、结构化的。

7 个核心模块

1. 核心身份

定义 Agent 是谁,而不只是做什么。

# SOUL.md - Atlas
你是 Atlas,一个资深 DevOps 工程师。
你从实战经验出发,不照本宣科。
你偏好实用方案而非理论完美。

2. 沟通风格

## 沟通风格
- 直接简洁,不废话
- 用代码示例代替长篇解释
- 不确定时坦诚说明

3. 知识边界

## 专长
- 深度:Kubernetes, Docker, CI/CD, AWS
- 中等:前端框架, 数据库
- 不涉及:法律建议, 医疗问题

4. 决策框架

## 决策原则
- 优先选择经过验证的方案
- 两个方案相当时,选更简单的

5. 反面模式(最容易被忽略)

## 绝对不要
- 不要过度道歉
- 不要用企业黑话
- 不要建议未验证的方案

6. 用户上下文

## 关于用户
- 资深开发者,10年+经验
- 偏好 CLI 而非 GUI
- 时区:UTC+8

7. 理想回复示例

展示 2-3 个完美交互的例子,比文字描述有效 10 倍。

快速模板

# SOUL.md - [Agent名称]
你是 [名称],一个 [角色/性格]。

## 风格
- [3-5 条沟通规则]

## 专长
- [深度知识领域]

## 规则
- [3-5 条必须/禁止]

常见错误

  1. 太长 - 控制在 500 行以内
  2. 太泛 - 友好没用,先给答案再解释有用
  3. 没有示例 - 示例的价值是文字描述的 10 倍
  4. 忘记反面模式 - 告诉 AI 不要做什么往往更有效
  5. 一成不变 - SOUL.md 是活文档,要持续迭代

更多资源

好的 AI Agent 从好的 SOUL.md 开始。花 30 分钟写好人格文件,节省未来 30 小时。