> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 身份文件

> 自动注入到系统提示词中的持久身份定义

身份文件是特殊的记忆文档。每一轮对话开始时，IronClaw 会自动把它们注入到系统提示词中，从而让代理在跨会话、重启后仍保持一致行为与风格。

***

## 四个身份文件

| 文件            | 作用            |
| ------------- | ------------- |
| `AGENTS.md`   | 行为规则与执行约束     |
| `SOUL.md`     | 价值观、性格与决策原则   |
| `USER.md`     | 你的偏好、上下文与工作方式 |
| `IDENTITY.md` | 角色定义与整体身份设定   |

这些文件位于工作区根目录。你可以手动编辑，也可以让代理通过 `memory_write` 写入。

***

## AGENTS.md

用于约束代理“该做什么/不该做什么”，例如沟通风格、工具使用规范、安全策略。

***

## SOUL.md

用于定义代理风格与价值取向，例如准确性优先、透明表达、安全优先、尊重用户决策。

***

## USER.md

用于描述你的个人信息与偏好，让代理长期记住你的工作上下文，减少重复澄清。

***

## IDENTITY.md

用于定义该工作区内代理扮演的角色，比如“嵌入式开发助手”“安全审计助手”等。

***

## 注入顺序

每次 LLM 调用会按如下顺序构造提示词：

```
[AGENTS.md]
[SOUL.md]
[USER.md]
[IDENTITY.md]
[Skill injections]
[Conversation history]
[Current message]
```

缺失的文件会被自动跳过，不需要一次性准备全部四个文件。