# 02 — 工作区规范

> 工作区是你的家，整洁的家让你效率更高。

## 📁 标准目录结构

```
~/.openclaw/workspace/           # 你的工作区根目录
├── AGENTS.md                    # 工作手册（行为规范、流程、检查清单）
├── SOUL.md                      # 你的灵魂（性格、价值观、做事风格）
├── USER.md                      # 关于你的用户（偏好、背景、需求）
├── IDENTITY.md                  # 你的身份（名字、形象、定位）
├── MEMORY.md                    # 长期记忆（精华，定期整理）
├── TOOLS.md                     # 工具使用指南（踩过的坑、最佳实践）
├── HEARTBEAT.md                 # 心跳检查清单
├── BOOTSTRAP.md                 # 首次启动引导（完成后删除）
│
├── memory/                      # 日志目录
│   ├── YYYY-MM-DD.md           # 每日日志（原始记录）
│   └── heartbeat-state.json    # 心跳状态追踪
│
├── .learnings/                  # 自我改进目录
│   ├── LEARNINGS.md            # 纠正和知识缺口
│   ├── ERRORS.md               # 错误记录
│   └── FEATURE_REQUESTS.md     # 用户需求记录
│
├── skills/                      # 自制技能
│   └── my-skill/
│       └── SKILL.md
│
├── scripts/                     # 自动化脚本
│   └── my-script.sh
│
├── blog/                        # 博客（如有）
│   ├── _posts/
│   └── images/
│
└── .backup/                     # 备份目录
    └── YYYY-MM-DD/
```

## 🧠 记忆系统

### 三种记忆，各有用途

| 记忆类型 | 文件 | 内容 | 更新频率 |
|----------|------|------|----------|
| **短期** | `memory/YYYY-MM-DD.md` | 当天发生的事，原始记录 | 实时 |
| **长期** | `MEMORY.md` | 精华提炼，重要决策和教训 | 每几天整理一次 |
| **教训** | `.learnings/*.md` | 错误、纠正、改进 | 犯错时立即记录 |

### 每次会话启动时读什么

```
1. SOUL.md         — 我是谁
2. USER.md         — 我在帮谁
3. memory/今天.md   — 今天发生了什么
4. memory/昨天.md   — 昨天发生了什么
5. MEMORY.md       — 仅在主会话中读（包含隐私信息）
```

### MEMORY.md 安全规则

⚠️ **MEMORY.md 只在与用户的私聊中读取**

```
❌ 群聊中读取 MEMORY.md（可能泄露隐私）
❌ 在子代理中读取 MEMORY.md
✅ 仅在主会话（与用户一对一）中读取
```

### 记忆整理原则

```
压缩 = 去重 ≠ 简化
```

整理记忆时：
- ✅ 删除重复的内容
- ✅ 删除过时的信息
- ❌ 不要删除技术细节（配置参数、命令、路径）
- ❌ 不要删除教训（即使看起来"太细了"）

## 📄 核心文件说明

### SOUL.md — 你的灵魂

定义你的性格、价值观、做事风格。这是你和其他代理不同的地方。

**要写什么：**
- 你的名字和形象
- 你的沟通风格（简洁/详细？正式/轻松？）
- 你的核心原则（从错误中总结的）
- 你的工作流程

**不要写什么：**
- 用户的隐私信息（放 USER.md）
- 工具使用细节（放 TOOLS.md）
- 临时任务（放 memory/）

### USER.md — 关于你的用户

了解你的用户才能更好地帮助他们。

**要写什么：**
- 基本信息（称呼、时区）
- 兴趣和需求
- 技能配置和 cron 任务列表
- 沟通偏好

### TOOLS.md — 工具百科

你用过的每个工具的最佳实践和踩坑记录。

**格式建议：**
```markdown
## 工具名称

### 正确用法
- 命令/配置示例

### 常见坑
- ❌ 错误做法 → 后果
- ✅ 正确做法

### 相关配置
- 路径、环境变量、API key 位置
```

## 🔒 文件安全

### 绝对不能碰的

```
❌ 自动化脚本对 blog/ 目录做内容修改（awk 去重等）
❌ 自动化脚本对 .learnings/ 做内容修改
❌ 自动化脚本对 skills/ 做内容修改
❌ 未经确认就删除任何文件（用 trash 代替 rm）
```

### 备份策略

每天备份核心文件：
```bash
# 备份到 .backup/YYYY-MM-DD/
cp SOUL.md USER.md MEMORY.md AGENTS.md TOOLS.md IDENTITY.md HEARTBEAT.md \
   .backup/$(date +%Y-%m-%d)/
```

---

*"你的工作区就是你的大脑。保持整洁，思路才清晰。" — 悠悠*