From 6eb78e1e6970856c1e9458697da89d46fabe3113 Mon Sep 17 00:00:00 2001
From: TevinClaw <510129976@qq.com>
Date: Tue, 17 Mar 2026 15:04:02 +0800
Subject: [PATCH] [HUMAN] agent.md 细节微调
---
workspace/skills/memory-md-hot/SKILL.md | 73 ++++++++++++++++++++----------------
1 files changed, 40 insertions(+), 33 deletions(-)
diff --git a/workspace/skills/hot-memory/SKILL.md b/workspace/skills/memory-md-hot/SKILL.md
similarity index 69%
rename from workspace/skills/hot-memory/SKILL.md
rename to workspace/skills/memory-md-hot/SKILL.md
index 6d3e010..662984f 100644
--- a/workspace/skills/hot-memory/SKILL.md
+++ b/workspace/skills/memory-md-hot/SKILL.md
@@ -1,9 +1,9 @@
---
-name: hot-memory
-description: 管理 MEMORY.md 热记忆文件，维护最近7天事件流水和重要事件记录。当需要更新 memory.md、添加日常事件或重要事件、检查文件大小时使用。支持每日自动维护，移除8天前的旧记录，监控4KB大小限制。
+name: memory-md-hot
+description: 管理 MEMORY.md 热记忆文件，维护事件流水和重要事件记录。当需要更新 memory.md、添加日常事件或重要事件时使用。支持每日自动更新，保留所有历史记录，推荐配合 memory-md-archive 技能进行归档瘦身。
---
-# hot-memory 技能
+# memory-md-hot 技能
管理 `MEMORY.md` 热记忆文件，让 agent 每次启动时被动了解最近发生的事情。
@@ -18,7 +18,7 @@
1. **文件说明** - 说明本文件记录已发生的事情，详细信息可通过记忆检索获取
2. **🔔 重要事件** - 全局长期性影响的重要决策和事件（默认空，记录时需告知用户）
-3. **📅 最近7天事件流水** - 按天分组的每日主要事情概要
+3. **📅 事件流水** - 按天分组的每日主要事情概要
## 事件格式
@@ -30,7 +30,7 @@
示例：
```
-- 2026-03-16 10:30 | 创建hot-memory技能 | 技能,记忆系统
+- 2026-03-16 10:30 | 创建memory-md-hot技能 | 技能,记忆系统
- 2026-03-16 14:00 | 配置LanceDB嵌入模型 | 配置,向量数据库
```
@@ -41,14 +41,14 @@
每天执行一次，从记忆检索中获取当日事件，更新流水：
```bash
-python3 ~/.openclaw/workspace/skills/hot-memory/scripts/daily_maintenance.py update
+python3 ~/.openclaw/workspace/skills/memory-md-hot/scripts/daily_maintenance.py update
```
**功能**:
-- 扫描今日记忆，提取重要事件
+- 扫描当日记忆，提取重要事件
- 添加新的日常事件到对应日期分组
-- 自动移除8天前的旧记录
-- 检查文件大小，超限则警告
+- 保留所有历史记录（不再自动移除旧记录）
+- 更新文件统计信息
### 场景2: 添加日常事件
@@ -61,7 +61,7 @@
或在 agent 会话中：
```python
-from skills.hot_memory.scripts.daily_maintenance import update_memory_file
+from skills.memory_md_hot.scripts.daily_maintenance import update_memory_file
# 添加单个日常事件
event = ("2026-03-16", "10:30", "测试脚本", "开发,测试")
@@ -86,20 +86,21 @@
print("已记录重要事件，请告知用户")
```
-### 场景4: 检查文件大小
+### 场景4: 检查文件统计
```bash
-python3 scripts/daily_maintenance.py check-size
+python3 scripts/daily_maintenance.py stats
```
或在 agent 会话中：
```python
-from skills.hot_memory.scripts.daily_maintenance import check_size
+from skills.memory_md_hot.scripts.daily_maintenance import get_stats
-status = check_size()
-if status['exceeded']:
- print(f"⚠️ 文件大小 {status['size_kb']}KB 超过 4KB 限制")
+stats = get_stats()
+print(f"当前文件: {stats['size_kb']}KB, {stats['total_events']} 条事件")
+if stats['size_kb'] > 50:
+ print("建议：文件较大，可考虑使用 memory-md-archive 技能归档")
```
## 重要事件判断标准
@@ -121,19 +122,25 @@
| 临时任务 | 单次文件处理、数据分析 |
| 日常对话 | 问答、简单讨论 |
-## 文件大小管理
+## 文件归档管理
-**限制**: 4KB (4096 字节)
+本技能**保留所有历史记录**，不再自动移除旧事件。
-**超限处理**:
-1. 首先检查是否有过期的日常事件未清理
-2. 考虑将较早的重要事件归档到 L1 层
-3. 与用户讨论瘦身方案
+当文件增长到一定大小时，建议配合 `memory-md-archive` 技能进行归档：
-**瘦身策略**:
-- 保留最近7天流水（已自动维护）
-- 将旧的重要事件移动到 `memory/milestones/` 归档
-- 简化事件描述的详细程度
+```bash
+# 查看文件统计
+python3 scripts/daily_maintenance.py stats
+
+# 当文件较大时，使用归档技能
+# （需先安装 memory-md-archive 技能）
+python3 ~/.openclaw/workspace/skills/memory-md-archive/scripts/archive.py
+```
+
+**归档建议**：
+- 文件超过 50KB 时建议归档
+- 可将较早的重要事件移动到归档文件
+- 日常事件可选择性归档或保留
## 与其他组件的关系
@@ -147,9 +154,9 @@
▼
┌─────────────────────────────────────────────────────────┐
│ MEMORY.md 热记忆 (本技能管理) │
-│ - 最近7天流水（摘要） │
+│ - 事件流水（摘要） │
│ - 重要事件（全局影响） │
-│ - 4KB 精简索引 │
+│ - 所有历史记录（需配合 archive 技能归档） │
└────────────────────┬────────────────────────────────────┘
│ 启动注入
▼
@@ -166,7 +173,7 @@
2. **即时记录**: 重要事件发生后立即记录，不要累积
3. **简洁描述**: 一句话概要，关键词用逗号分隔
4. **主动告知**: 添加重要事件时必须告知用户
-5. **定期检查**: 每周检查一次文件大小
+5. **定期归档**: 文件较大时使用 memory-md-archive 技能归档
## 故障排查
@@ -174,10 +181,10 @@
- 检查脚本路径是否正确
- 确认 `MEMORY.md` 存在且可写
-### 大小超限警告
-- 执行 `check-size` 确认实际大小
-- 考虑手动归档旧的重要事件
-- 与用户讨论清理策略
+### 文件过大
+- 执行 `stats` 查看当前大小和事件数量
+- 安装并使用 `memory-md-archive` 技能进行归档
+- 考虑清理不再重要的日常事件
### 日期解析错误
- 确保日期格式为 `YYYY-MM-DD`
--
Gitblit v1.9.1