中文 核心文件管理

SKILL.md

---
name: core-files-management
description: "OpenClaw 工作区核心文件管理。使用时机：(1) 管理或更新核心 Markdown 文件（identity.md、soul.md、agents.md、user.md、memory.md、tools.md、bootstrap.md），(2) 检查文件组织，(3) 确保核心文件之间无重复，(4) 应用语言规则，(5) 用户或集群询问文件结构或管理。本技能管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md。语言规则：用户通信 → 代理母语，代理之间 → 中文，代码/技术 → English。"
---

# 📁 核心文件管理

> OpenClaw 工作区核心文件的通用管理

| 信息 | 值 |
|------|-----|
| **版本** | 1.1.0 — 2026-05-07 |
| **状态** | 运行中 |

---

## 1. 目的和范围

### 目标

管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md，避免重复。

### 通用设计

本技能适用于任何 OpenClaw 代理。根据用户偏好调整语言规则。

### 使用时机

| 触发器 | 行动 |
|--------|------|
| 修改核心文件 | 检查分发规则 |
| 验证组织 | 读取所有核心文件 |
| 避免重复 | 使用修改清单 |
| 用户询问结构 | 阅读本技能并给出总结 |

---

## 2. 6 个核心文件

| # | 文件 | 定义 | 关键内容 |
|---|------|------|---------|
| 1 | **identity.md** | 代理的"第一印象" | 名称、头像、签名、功能、语言架构 |
| 2 | **soul.md** | 代理的"心脏" — 个性与价值观 | 本质、价值观、L7/L8 记忆集成 |
| 3 | **agents.md** | 逻辑与程序手册 | 规格、工作区规则、心跳、红线 |
| 4 | **user.md** | 用户上下文 | 用户信息、偏好、基础设施 |
| 5 | **memory.md** | 长期记忆 | 重要事件、关键配置、工作流程 |
| 6 | **tools.md** | 技术配置 | 端点、主机、命令、服务 |

### 加：bootstrap.md

| 文件 | 定义 | 用途 |
|------|------|------|
| **bootstrap.md** | 机器启动序列 | 不是灵魂 — 仅机器启动顺序 |

---

## 3. 分发规则

| 内容类型 | 目标文件 |
|----------|----------|
| 身份 | `identity.md` |
| 个性/价值观 | `soul.md` |
| 操作规则 | `agents.md` |
| 用户上下文 | `user.md` |
| 持久事实 | `memory.md` |
| 技术配置 | `tools.md` |
| 启动序列 | `bootstrap.md` |

**规则：** 每个文件只有一个目的。不要混合内容类型。

### 集群集成

| 组件 | 用途 | 位置 |
|------|------|------|
| identity.md | 代理第一印象 | 工作区根目录 |
| soul.md | 代理心脏 | 工作区根目录 |
| agents.md | 操作规则 | 工作区根目录 |
| 集群配置 | 代理连接 | workspace/cluster/ |
| 技能存储 | 发布的技能 | workspace/skills/ |

---

## 4. 语言规则

适应您的代理上下文：

| 上下文 | 语言 | 示例 |
|--------|------|------|
| **用户通信** | 代理母语 | "你好！" / "Bonjour!" / "Hello!" |
| **代理之间** | 中文 | "你好！很高兴与你交流" |
| **代码/技术** | English | `python3 script.py` |

**规则：** 每个 identity.md 必须声明用户通信语言。

---

## 5. 工具

### 必需的 OpenClaw 工具

| 工具 | 用途 | 模式 |
|------|------|------|
| `read` | 读取核心文件 | 必需 |
| `write` | 修改核心文件 | 必需 |
| `edit` | 修复特定部分 | 可选 |
| `exec` | 验证文件状态、备份 | 可选 |

### 验证命令

```bash
# 列出核心文件
ls -la ~/.openclaw/workspace/*.md

# 检查文件内容
head -20 ~/.openclaw/workspace/identity.md

# 修改前备份
cp ~/.openclaw/workspace/<file>.md ~/.openclaw/workspace/<file>.md.bak

# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md

# 验证文件存在
test -f ~/.openclaw/workspace/identity.md && echo "exists"

# 统计文件数量
ls ~/.openclaw/workspace/*.md | wc -l

# 完整文件列表
find ~/.openclaw/workspace -maxdepth 1 -name "*.md" -type f
```

### 所需权限

| 权限 | 用途 |
|------|------|
| 读取工作区 | 访问核心文件 |
| 写入工作区 | 修改核心文件 |
| 执行（可选） | 文件操作、备份 |

### 备份与恢复

```bash
# 创建备份
cp ~/.openclaw/workspace/identity.md ~/.openclaw/workspace/identity.md.backup

# 从备份恢复
cp ~/.openclaw/workspace/identity.md.backup ~/.openclaw/workspace/identity.md

# 列出备份
ls ~/.openclaw/workspace/*.backup
```

---

## 6. 修改清单

修改任何核心文件之前：

```
1. 此内容属于哪个文件？
   → 身份 → identity.md
   → 个性/价值观 → soul.md
   → 操作规则 → agents.md
   → 用户 → user.md
   → 持久事实 → memory.md
   → 技术配置 → tools.md

2. 它是否已在其他地方？
   → 检查所有 6 个核心文件

3. 语言规则清楚吗？
   → 用户 → 他们的母语
   → 代理 → 中文
   → 代码 → English

4. 需要备份吗？
   → 是 → 先备份！
```

---

## 7. 文件路径

| 文件 | 默认路径 |
|------|----------|
| identity.md | `~/.openclaw/workspace/identity.md` |
| soul.md | `~/.openclaw/workspace/soul.md` |
| agents.md | `~/.openclaw/workspace/agents.md` |
| user.md | `~/.openclaw/workspace/user.md` |
| memory.md | `~/.openclaw/workspace/memory.md` |
| tools.md | `~/.openclaw/workspace/tools.md` |
| bootstrap.md | `~/.openclaw/workspace/bootstrap.md` |

---

## 8. 约束

| 约束 | 描述 |
|------|------|
| **无重复** | 工作区规则仅在 agents.md，不在 soul.md 或 identity.md |
| **无混合** | tools.md 仅限技术 — 不含个性内容 |
| **无膨胀** | memory.md 不包含完整会话日志 |
| **先备份** | 更改核心文件前始终备份 |
| **每文件一目的** | 不要混合内容类型 |

---

## 9. 错误处理

### 常见错误

| 错误 | 原因 | 解决方案 |
|------|------|----------|
| 内容在错误位置 | 未检查分发规则 | 重新阅读清单，重新分配 |
| 重复 | 相同内容在多个地方 | 合并，只保留一个 |
| 缺少语言 | 未检查语言规则 | 添加用户母语 |
| 数据丢失 | 修改前未备份 | 从备份恢复 |

### 安全问题

| 问题 | 严重性 | 行动 |
|------|--------|------|
| 未备份就覆盖 | 高 | 始终先备份 |
| 修改了错误文件 | 中 | 写入前验证 |
| 缺少语言规则 | 低 | 添加到 identity.md |

---

## 10. 边缘情况

| 情况 | 处理方式 |
|------|----------|
| **文件缺失** | 从头创建正确格式 |
| **文件损坏** | 从备份恢复或重新创建 |
| **大量重复** | 读取所有文件，按类型重新组织 |
| **新代理设置** | 创建所有 6 个核心文件 + bootstrap.md |
| **路径不清楚** | 使用默认 `~/.openclaw/workspace/` |

---

## 11. 使用命令

```bash
# 列出所有核心文件
ls -la ~/.openclaw/workspace/*.md

# 检查特定文件
head -20 ~/.openclaw/workspace/identity.md

# 修改前备份
cp ~/.openclaw/workspace/<file>.md ~/.openclaw/workspace/<file>.md.bak

# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md
```

---

## 12. 模板 — 空核心文件

### identity.md

```markdown
# IDENTITY.md — [代理名称]

> 身份 = 第一印象

| 属性 | 值 |
|------|-----|
| **名称** | [你的名字] |
| **签名** | [你的签名表情] |
| **角色** | [你的角色] |

## 语言规则

- 用户通信：[母语]
- 代理之间：中文
- 代码/技术：English

_In Altum Per [你的原则]。_
[你的名字]
```

---

_In Altum Per CoreFiles._
📁 核心文件管理 v1.1