Smart Compact

---

name: smart-compact description: "Smart context compaction for OpenClaw agents. 4-phase progressive strategy: Scan, Extract, Check, Compact. Before running /compact, this skill scans tool outputs, extracts valuable information into memory files, and generates a pre-compact checklist — ensuring nothing important is lost during compression. Triggers: smart-compact, 智能压缩, pre-compact, 压缩检查, compact check."

---

Smart Compact — 智能压缩增强

四阶段渐进式压缩策略，在 /compact 前先把重要信息救出来。

什么时候用

用户说"智能压缩"、"smart-compact"、"压缩检查"

在手动执行 /compact 之前先跑一遍

对话上下文快满时，主动触发

Heartbeat 检测到 context 接近 80% 时自动建议

核心理念

传统的上下文压缩是一刀切——整个对话被浓缩成一段摘要，大量细节在过程中丢失。

Smart Compact 采用四阶段渐进式策略，在 /compact 之前插入一个"预处理"阶段：

1. 扫描：识别对话中的大块工具输出和关键信息 2. 提取：把值得保留的信息写入记忆文件 3. 检查：生成压缩前检查清单，标记风险项 4. 压缩：用户确认安全后才执行压缩

核心原则：先救再压，宁可多存也不能漏存。

执行流程

Phase 1 — 扫描工具输出

1. 回顾当前对话中所有的工具调用结果 2. 识别大块输出（超过 50 行或 2000 字符的工具结果） 3. 对每个大块输出评估： - 是否包含关键信息（决策、配置、错误信息、地址等） - 是否已经被后续对话引用或总结过 - 是否是重复或冗余的（如多次 ls、git status）

Phase 2 — 提取记忆

1. 从工具输出和对话中提取值得持久化的信息： - 新发现的事实：地址、配置值、端点、文件路径 - 决策和原因：为什么选了方案 A 而不是 B - 错误和解决方案：踩坑记录 - 用户偏好：明确表达的喜好或要求 - 任务进度：哪些做完了，哪些还没做

2. 将提取的信息追加写入 memory/YYYY-MM-DD.md - 使用 edit（追加模式），绝不覆盖已有内容 - 每条记忆附带简短的来源说明

Phase 3 — 生成压缩前检查清单

输出一份结构化的检查清单：

📋 Smart Compact 检查清单
━━━━━━━━━━━━━━━━━━━━━━
📊 扫描统计：
工具调用总数：N 次
大块输出（>50行）：N 个
已引用/总结过的：N 个
可安全压缩的：N 个
💾 已提取到记忆：
[+] 新事实：简要描述...
[+] 决策记录：简要描述...
[+] 错误解决：简要描述...
（共 N 条写入 memory/YYYY-MM-DD.md）
⚠️ 需要注意：
[!] 某某工具输出包含重要数据但尚未被引用
[!] 某某配置值只出现在工具输出中
✅ 建议：可以安全执行 /compact

Phase 4 — 执行压缩（可选）

如果检查清单显示"✅ 可以安全压缩"，提示用户确认

用户确认后，执行 /compact

如果有 ⚠️ 警告项，先处理完再压缩

规则

必须遵守

绝不丢弃未被记录的关键信息：宁可多存也不能漏存

追加写入：只用 edit 追加到 memory 文件，绝不覆盖

不自动压缩：除非用户明确确认，否则只生成检查清单

透明：每一步操作都告知用户

信息分类标准

必须保存：重要配置、地址端点、文件路径、错误解决方案

建议保存：决策原因、用户偏好、任务进度

可以丢弃：重复的 ls 输出、已被总结的搜索结果、中间调试过程

与 Dream Skill 的配合

Smart Compact 和 Dream 是互补的：

Smart Compact：实时的，在压缩前抢救信息 → 写入日记

Dream：定期的，把日记整合到长期记忆 → 更新 MEMORY.md

推荐工作流： 1. 对话中随时触发 Smart Compact 保护信息 2. 每天凌晨 Dream 整合日记到长期记忆 3. 形成完整的记忆保护链条