- 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 之前插入一个"预处理"阶段：
- 扫描：识别对话中的大块工具输出和关键信息
- 提取：把值得保留的信息写入记忆文件
- 检查：生成压缩前检查清单，标记风险项
- 压缩：用户确认安全后才执行压缩
核心原则：先救再压，宁可多存也不能漏存。
执行流程
Phase 1 — 扫描工具输出
- 回顾当前对话中所有的工具调用结果
- 识别大块输出（超过 50 行或 2000 字符的工具结果）
- 对每个大块输出评估：
- 是否包含关键信息（决策、配置、错误信息、地址等） - 是否已经被后续对话引用或总结过 - 是否是重复或冗余的（如多次 ls、git status）
Phase 2 — 提取记忆
- 从工具输出和对话中提取值得持久化的信息：
- 新发现的事实：地址、配置值、端点、文件路径 - 决策和原因：为什么选了方案 A 而不是 B - 错误和解决方案：踩坑记录 - 用户偏好：明确表达的喜好或要求 - 任务进度：哪些做完了，哪些还没做
- 将提取的信息追加写入
memory/YYYY-MM-DD.md
- 使用 edit（追加模式），绝不覆盖已有内容 - 每条记忆附带简短的来源说明
Phase 3 — 生成压缩前检查清单
输出一份结构化的检查清单：
📋 Smart Compact 检查清单
━━━━━━━━━━━━━━━━━━━━━━
📊 扫描统计：
- 工具调用总数：N 次
- 大块输出（>50行）：N 个
- 已引用/总结过的：N 个
- 可安全压缩的：N 个
💾 已提取到记忆：
- [+] 新事实：简要描述...
- [+] 决策记录：简要描述...
- [+] 错误解决：简要描述...
（共 N 条写入 memory/YYYY-MM-DD.md）
⚠️ 需要注意：
- [!] 某某工具输出包含重要数据但尚未被引用
- [!] 某某配置值只出现在工具输出中
✅ 建议：可以安全执行 /compactPhase 4 — 执行压缩（可选）
- 如果检查清单显示"✅ 可以安全压缩"，提示用户确认
- 用户确认后，执行 /compact
- 如果有 ⚠️ 警告项，先处理完再压缩
规则
必须遵守
- 绝不丢弃未被记录的关键信息：宁可多存也不能漏存
- 追加写入：只用 edit 追加到 memory 文件，绝不覆盖
- 不自动压缩：除非用户明确确认，否则只生成检查清单
- 透明：每一步操作都告知用户
信息分类标准
- 必须保存：重要配置、地址端点、文件路径、错误解决方案
- 建议保存：决策原因、用户偏好、任务进度
- 可以丢弃：重复的 ls 输出、已被总结的搜索结果、中间调试过程
与 Dream Skill 的配合
Smart Compact 和 Dream 是互补的：
- Smart Compact：实时的，在压缩前抢救信息 → 写入日记
- Dream：定期的，把日记整合到长期记忆 → 更新 MEMORY.md
推荐工作流：
- 对话中随时触发 Smart Compact 保护信息
- 每天凌晨 Dream 整合日记到长期记忆
- 形成完整的记忆保护链条