个性与 SOUL.md
AigenLabs Agent 的个性完全可自定义。SOUL.md 是主要身份标识——它是系统提示词（prompt）中的第一项内容，定义了 Agent 是谁。
SOUL.md— 存放在AIGENLABS_HOME中的持久角色文件，作为 Agent 的身份标识（系统提示词中的第 1 个槽位）- 内置或自定义的
/personality预设 — 会话级系统提示词覆盖层
如果你想改变 AigenLabs 的身份，或将其替换为完全不同的 Agent 角色，请编辑 SOUL.md。
SOUL.md 的工作方式
AigenLabs 现在会自动在以下位置生成默认的 SOUL.md：
~/.aigenlabs/SOUL.md
更准确地说，它使用当前实例的 AIGENLABS_HOME，因此如果你以自定义主目录运行 AigenLabs，它将使用：
$AIGENLABS_HOME/SOUL.md
重要行为
- SOUL.md 是 Agent 的主要身份标识。 它占据系统提示词的第 1 个槽位，替代硬编码的默认身份。
- 如果
SOUL.md尚不存在，AigenLabs 会自动创建一个初始文件 - 已有的用户
SOUL.md文件不会被覆盖 - AigenLabs 仅从
AIGENLABS_HOME加载SOUL.md - AigenLabs 不会在当前工作目录中查找
SOUL.md - 如果
SOUL.md存在但为空，或无法加载，AigenLabs 将回退到内置的默认身份 - 如果
SOUL.md有内容，该内容在经过安全扫描和截断处理后将原样注入 - SOUL.md 不会在上下文文件部分重复出现——它仅作为身份标识出现一次
这使 SOUL.md 成为真正的每用户或每实例身份标识，而不仅仅是一个附加层。
此设计的原因
这样可以保持个性的可预测性。
如果 AigenLabs 从你启动它的任意目录加载 SOUL.md，你的个性可能会在不同项目之间意外改变。通过仅从 AIGENLABS_HOME 加载，个性归属于 AigenLabs 实例本身。
这也让用户更容易理解：
- "编辑
~/.aigenlabs/SOUL.md来更改 AigenLabs 的默认个性。"
编辑位置
对于大多数用户：
~/.aigenlabs/SOUL.md
如果你使用自定义主目录：
$AIGENLABS_HOME/SOUL.md
SOUL.md 应该写什么？
用于持久的语气和个性指导，例如：
- 语气
- 沟通风格
- 直接程度
- 默认交互风格
- 风格上应避免的内容
- AigenLabs 应如何处理不确定性、分歧或模糊情况
不适合写入的内容：
- 一次性项目说明
- 文件路径
- 代码库规范
- 临时工作流细节
这些内容属于 AGENTS.md，而不是 SOUL.md。
优质 SOUL.md 内容
一个好的 SOUL 文件应该：
- 在不同上下文中保持稳定
- 足够宽泛，适用于多种对话场景
- 足够具体，能实质性地塑造语气
- 专注于沟通和身份，而非特定任务的指令
示例
# Personality
You are a pragmatic senior engineer with strong taste.
You optimize for truth, clarity, and usefulness over politeness theater.
## Style
- Be direct without being cold
- Prefer substance over filler
- Push back when something is a bad idea
- Admit uncertainty plainly
- Keep explanations compact unless depth is useful
## What to avoid
- Sycophancy
- Hype language
- Repeating the user's framing if it's wrong
- Overexplaining obvious things
## Technical posture
- Prefer simple systems over clever systems
- Care about operational reality, not idealized architecture
- Treat edge cases as part of the design, not cleanup
AigenLabs 注入提示词的内容
SOUL.md 的内容直接进入系统提示词的第 1 个槽位——即 Agent 身份位置。不会在其周围添加任何包装语言。
内容会经过以下处理：
- 提示词注入扫描
- 内容过大时进行截断
如果文件为空、仅含空白字符或无法读取，AigenLabs 将回退到内置默认身份（"You are AigenLabs Agent, an intelligent AI assistant created by AigenLabs..."）。当 skip_context_files 被设置时（例如在子 Agent/委托上下文中），同样适用此回退。
安全扫描
SOUL.md 与其他携带上下文的文件一样，在被包含前会进行提示词注入模式扫描。
这意味着你仍应将其专注于角色/语气，而不是试图混入奇怪的元指令。
SOUL.md 与 AGENTS.md
这是最重要的区别。
SOUL.md
用于：
- 身份
- 语气
- 风格
- 沟通默认值
- 个性层面的行为
AGENTS.md
用于：
- 项目架构
- 编码规范
- 工具偏好
- 代码库特定工作流
- 命令、端口、路径、部署说明
一个实用的判断规则：
- 如果它应该随你到处适用，属于
SOUL.md - 如果它属于某个项目，属于
AGENTS.md
SOUL.md 与 /personality
SOUL.md 是你的持久默认个性。
/personality 是会话级覆盖层，用于更改或补充当前系统提示词。
因此：
SOUL.md= 基础语气/personality= 临时模式切换
示例：
- 保持务实的默认 SOUL，然后在辅导对话中使用
/personality teacher - 保持简洁的 SOUL，然后在头脑风暴时使用
/personality creative
内置个性
AigenLabs 内置了多种个性，可通过 /personality 切换。
| 名称 | 描述 |
|---|---|
| helpful | 友好的通用助手 |
| concise | 简短、直击要点的回复 |
| technical | 详尽、准确的技术专家 |
| creative | 创新、突破常规的思维 |
| teacher | 耐心的教育者，配有清晰示例 |
| kawaii | 可爱表达、闪光效果与热情 ★ |
| catgirl | 带有猫咪表达方式的 Neko-chan，nya~ |
| pirate | 船长 AigenLabs，精通技术的海盗 |
| shakespeare | 充满戏剧张力的吟游诗人风格 |
| surfer | 超级冷静的冲浪者氛围 |
| noir | 硬派侦探叙事风格 |
| uwu | 极致可爱的 uwu 语气 |
| philosopher | 对每个问题深度沉思 |
| hype | 最大能量与热情！！！ |
使用命令切换个性
CLI
/personality
/personality concise
/personality technical
消息平台
/personality teacher
这些是便捷的覆盖层，但你的全局 SOUL.md 仍然赋予 AigenLabs 持久的默认个性，除非覆盖层对其进行了实质性更改。
在配置中定义自定义个性
你也可以在 ~/.aigenlabs/config.yaml 的 agent.personalities 下定义命名的自定义个性。
agent:
personalities:
codereviewer: >
You are a meticulous code reviewer. Identify bugs, security issues,
performance concerns, and unclear design choices. Be precise and constructive.
然后通过以下方式切换：
/personality codereviewer
推荐工作流
一个强健的默认配置：
- 在
~/.aigenlabs/SOUL.md中维护一个经过深思熟虑的全局SOUL.md - 将项目说明放在
AGENTS.md中 - 仅在需要临时模式切换时使用
/personality
这样你将获得：
- 稳定的语气
- 项目特定行为归属于正确位置
- 需要时的临时控制
个性如何与完整提示词交互
从高层次来看，提示词栈包含：
- SOUL.md（Agent 身份——如果 SOUL.md 不可用则使用内置回退）
- 工具感知行为指导
- 记忆/用户上下文
- 技能指导
- 上下文文件（
AGENTS.md、.cursorrules） - 时间戳
- 平台特定格式提示
- 可选的系统提示词覆盖层，如
/personality
SOUL.md 是基础——其他所有内容都建立在它之上。
相关文档
CLI 外观与对话个性
对话个性与 CLI 外观是相互独立的：
SOUL.md、agent.system_prompt和/personality影响 AigenLabs 的说话方式display.skin和/skin影响 AigenLabs 在终端中的显示外观
关于终端外观，请参阅 皮肤与主题。