From cba9acbde0128ded3cbf36c1fdaebe3dc0930636 Mon Sep 17 00:00:00 2001
From: ChenJianAgent <joseph.siyi@gmail.com>
Date: Mon, 23 Mar 2026 16:01:56 +0000
Subject: [PATCH] feat: add documentation for agent role separation (Fixes
 #299)

---
 docs/role-separation.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/role-separation.md

diff --git a/docs/role-separation.md b/docs/role-separation.md
new file mode 100644
index 0000000..2ef8100
--- /dev/null
+++ b/docs/role-separation.md
@@ -0,0 +1,14 @@
+# 代理人角色劃分指引
+
+本文件定義了 OpenClaw 生態中，各類身份檔案的角色與職責。
+
+## 核心檔案說明
+
+- **IDENTITY.md**: 身份定義，包含 Agent 的名稱、Vibe、Emoji。
+- **USER.md**: 人類用戶檔案，記錄用戶偏好、時區與重要關聯。
+- **SOUL.md**: 核心價值觀與行為準則，是 Agent 的靈魂。
+- **AGENTS.md**: 工作區與運作規範，定義了檔案存取與 session 管理。
+
+## 最佳實踐
+1. **身分區隔**：Agent 應在環境啟動時優先讀取上述檔案，確保在不同用戶或情境下不會混淆。
+2. **更新機制**：每當 Agent 經歷身份變更（如名稱變更、新工具導入），必須同步更新對應檔案。