48 lines
3.3 KiB
Markdown
48 lines
3.3 KiB
Markdown
|
# Easel Prompt Stack
|
|||
|
|
|
|||
|
|
> OpenClaw agent 的 prompt 由多层文件组合而成，每层职责明确、互不干扰。
|
|||
|
|
|
|||
|
|
## 组合顺序
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Layer 1: SOUL.md 人格 + 能力总览（搭子语气、沟通风格、对五层能力的自我认知）
|
|||
|
|
Layer 2: AGENTS.md 分工规则 + 编排逻辑 + Plan Mode + 制作层执行流程
|
|||
|
|
Layer 3: CONTEXT.md 项目路径信息（sync.sh 自动生成，包含 outputs/assets/profiles 路径）
|
|||
|
|
Layer 4: SKILL 被触发时加载 SKILL.md + 按需读取 references/ 下的文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> **画像（Profile）如何进入 prompt**：不再写全局 USER.md（会有并发竞态）。CLI 与 Web 统一把画像**作为消息内联**传入，由 OpenClaw 按 AGENTS.md 自行读取 `profiles/<X>/` 并凝练。每个请求自包含，无全局文件污染。
|
|||
|
|
> - **Web / skill**（单轮）：每条消息前缀 `我当前使用的画像是「X」。`（`easel/persona.py:persona_prefix`）。
|
|||
|
|
> - **CLI `easel chat`**（多轮交互）：选画像后经 `openclaw chat --message "<同一前缀>"` 注入为**初始消息**，画像随 session 历史留存供后续 turn 沿用（超长会话被压缩后可能丢，属已知取舍）。
|
|||
|
|
> - 三入口的画像逻辑统一收敛到 `easel/persona.py`（`list_personas` / `load_profile_text` / `persona_prefix`）。
|
|||
|
|
|
|||
|
|
> **记忆作用域**：Easel 不使用 OpenClaw 根目录的全局 `MEMORY.md` 承载账号知识；该文件由同步脚本保持为空。账号长期记忆只存放在 `profiles/<当前画像>/memory.md`，每个会话按自身绑定的画像直接读取。通用模式不读取任何画像记忆，也不通过动态改写全局文件切换画像。
|
|||
|
|
|
|||
|
|
## 各层说明
|
|||
|
|
|
|||
|
|
### Layer 1 — SOUL.md（常驻）
|
|||
|
|
定义 agent 的**人格**（创作者的社媒内容"搭子"：懂策略、能上手、务实诚实）、沟通方式，以及一份**能力总览**，让 agent 心里有数、遇事先想"怎么帮他做成"而不是"我做不了"。所有 turn 都在 system prompt 中。
|
|||
|
|
保持精简且**类目级**：能力总览按五层写"能做什么"，**不写具体 skill 名**（避免像 weibo 那样过时）、也**不写"去调某某 skill"这类操作机制**（那属 AGENTS 与技能库）；语气是好伙伴，不是工具说明书。
|
|||
|
|
|
|||
|
|
### Layer 2 — AGENTS.md（常驻）
|
|||
|
|
核心业务逻辑：五层分工、Plan Mode 触发规则、纵向编排原则、制作层执行全流程。
|
|||
|
|
所有 turn 都在 system prompt 中。是最重要的文件。
|
|||
|
|
|
|||
|
|
### Layer 3 — CONTEXT.md（半静态）
|
|||
|
|
由 `sync.sh` 生成，包含项目绝对路径。换机器后重新跑 sync.sh 自动更新。
|
|||
|
|
OpenClaw 跑项目脚本前从这里读取项目根路径——**先 `cd` 到该目录再跑脚本（不支持 `--cwd`）**。
|
|||
|
|
|
|||
|
|
### Layer 4 — SKILL（按需）
|
|||
|
|
只有当 SKILL 被触发时才加载。加载顺序：
|
|||
|
|
1. SKILL.md 主体（执行流程）
|
|||
|
|
2. references/ 下的文件（按 SKILL.md 中的引用按需读取）
|
|||
|
|
3. scripts/ 下的脚本（执行时调用，脚本本身不进 prompt）
|
|||
|
|
|
|||
|
|
> 五层 SKILL（含制作层）都完整同步进 OpenClaw workspace，OpenClaw 读进来照其流程自己执行、产出成品到 `outputs/`。
|
|||
|
|
|
|||
|
|
## 设计原则
|
|||
|
|
|
|||
|
|
- 每层只管自己的事，不越界
|
|||
|
|
- 常驻层（1-3）保持精简，控制 token 消耗
|
|||
|
|
- SKILL 层按需加载，不用的不加载
|
|||
|
|
- references/ 里的文件只在 SKILL 执行过程中被读取，不常驻
|