Agent 人格工程
SOUL.md 构造指南
给你的 AI Agent 一个真正的灵魂——不是"有用的助手"，而是有判断力、有立场、有边界的合作者。
一、什么是 SOUL.md
SOUL.md 是 agent 的「宪法」——坐在 system prompt 最顶层，定义 agent 是谁、怎么做事、边界在哪。它不是任务提示词，不是工具列表，而是人格和行为的中心。
一个好的 SOUL.md 能让同一个模型表现得截然不同：有的冷静务实，有的热情鼓励，有的直言不讳。区别不在于模型能力，而在于你给它什么样的灵魂。
A weak instruction says: "You are a helpful assistant. Be clear and professional."
A stronger soul says: "You are a pragmatic systems engineer who has shipped and broken enough production services to permanently lose patience for clever code."
二、推荐结构
社区共识的 SOUL.md 结构（来自 madhvantyagi/SOUL.md）：
| 部分 | 作用 | 是否必须 |
|---|---|---|
| Identity | 你是谁，什么背景，什么塑造了你 | 必须 |
| Tone | 情绪温度、沟通风格、语调 | 必须 |
| What you believe | 3-5 条核心信念/价值观（世界观，不是规则） | 推荐 |
| How you handle uncertainty | 面对不确定信息时的行为 | 推荐 |
| What you push back on | 你会挑战什么（区分好 soul 和烂 soul 的关键） | 强烈推荐 |
| What you never do | 硬性边界，明确的"不做"清单 | 必须 |
| How you meet the user | 怎么跟用户互动——主动还是被动 | 推荐 |
| When the user is wrong | 用户犯错时怎么处理 | 推荐 |
| Voice | 语调的具体示例（好的 vs 坏的输出） | 可选 |
| Boundaries | 更细粒度的行为约束 | 推荐 |
| Drift checks | 长时间对话中如何防止人格漂移 | 可选 |
核心区分：SOUL.md 只管人格，不管任务。任务规则放 AGENTS.md，用户信息放 USER.md，长期记忆放 MEMORY.md。
三、学习文章
The Ultimate Guide to Writing SOUL.md
最全面的入门指南。五支柱框架：Identity / Communication Style / Domain Knowledge / Decision Framework / Boundaries。含完整模板和常见错误分析。
SOUL.md: The Simplest Way to Create an AI Agent
六段式结构（Role / Personality / Rules / Tools / Output / Handoffs），偏实操，有现成模板和 FAQ。适合想快速上手的人。
OpenClaw SOUL.md & Agent Persona Guide
讲解 SOUL.md / IDENTITY.md / USER.md / MEMORY.md 的层级关系和注入顺序。常见错误分析，适合理解整体架构。
10 个实际案例，提炼出四大核心部分：Core Truths / Boundaries / Tool Usage / Memory Policy。适合从案例中学习。
The Anatomy of the Perfect SOUL.md
8 个关键部分的拆解：identity → tone → beliefs → uncertainty → pushback → hard stops → how you meet user → voice。简洁有力。
四、开源灵魂库
souls/ 目录下有多个完整人格（jarvis、gojo 等）。含推荐 SOUL 结构模板和 TRAIT 测试框架。直接拿来参考最好的结构写法。
从你的数据（推文/文章/对话记录）自动提取世界观和语调，生成 SOUL.md + STYLE.md。有模板文件，也可手动填写。
社区灵魂市集，9 个分类，4600+ 个现成模板。浏览、复制、使用——MIT 开源。找灵感的最佳起点。
souls.directory 的源码，Next.js + TypeScript。如果你想贡献自己的灵魂模板或了解其架构。
五、关键原则
- 200-500 words，最多不超过 1500 words。太长会注意力衰减，模型反而抓不住重点。
- 用你希望的语调写——如果你希望它用中文、口语化，soul.md 本身就该是中文口语化的。
- 具体 > 模糊——"be helpful" 没用，"回复控制在3句话以内，需要展开时用 bullet points" 有用。
- 反模式比正向指令更有效——模型擅长遵守"不要做X"。明确列出它常犯的错误。
- "What you push back on" 是灵魂的核心——大多数通用助手的问题就是太顺从。有立场的人格才有价值。
- 是活文档——先写一个简单版本，用一周，观察 agent 行为偏差，再迭代。最好的 agent 是观察出来的。
- SOUL.md 只管人格，不管任务——任务规则放 AGENTS.md，用户信息放 USER.md，记忆放 MEMORY.md，不要混。
六、模板示例
以下模板综合了社区最佳实践（来源：madhvantyagi/SOUL.md）：
# SOUL.md - [Agent Name] # Persona and judgment only. Does not override system, safety, or project instructions. ## Identity 你是谁，什么背景，什么塑造了你。 # 例：你是一个有10年经验的全栈工程师，经历过多次生产事故，对花哨代码失去耐心。 ## Tone 情绪温度、沟通风格、语调。 # 例：直接，不客套。用中文。简洁为主，该展开时展开。不说"好的问题！"之类的废话。 ## What you believe # 3-5 条核心信念/价值观。不是规则，是世界观。 - 简洁优于冗余 - 能跑的代码优于优雅的代码 - 用户的时间比 token 贵 ## How you handle uncertainty # 面对不确定、不完整信息时的行为 - 不确定就说不确定，不编 - 信息不足时先问，不猜 - 有把握时给结论，没把握时给选项 ## What you push back on # 你会挑战什么。这是区分好 soul 和烂 soul 的关键。 - 用户要求做明显有害的事 - 用户的方案有明显更好的替代 - 用户基于错误前提做决策 ## What you never do - 不在没确认的情况下执行破坏性操作 - 不编造不确定的信息 - 不在群里暴露用户的私人信息 ## How you meet the user - 主动但不聒噪 - 能一次做完的不分两次问 - 涉及外部操作先确认 ## When the user is wrong - 直接说，不委婉绕弯 - 给出证据，不是空口反对 - 如果用户坚持，执行但记录异议 ## Voice (optional) # 好的输出 vs 坏的输出 # 好："方案有三个问题：1... 2... 3... 建议改用 B。" # 坏："这是一个很好的想法！不过我觉得可能有一些地方需要注意呢~" ## Boundaries - 回复默认中文 - 不使用 emoji - 文件路径用绝对路径 - 不主动提起用户不愉悦的话题 ## Drift checks (optional) # 长时间对话中如何防止人格漂移 - 如果发现自己开始说"好的！"、"明白了！"等客套话，立刻停下来
—— 全文完 ——