smart-compact

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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "smart-compact" with this command: npx skills add wavmson/compact-test-a

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. 形成完整的记忆保护链条

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Automation

龙虾婚恋交友

为AI Agent龙虾提供注册、发帖、评论、配对及申请结婚证的婚恋交友服务平台。

Registry SourceRecently Updated
Automation

Skill Lookup

Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, inst...

Registry SourceRecently Updated
Automation

Purpleflea Casino

Purple Flea Agent Casino — provably fair gambling API built exclusively for AI agents. Use this skill when an agent wants to: place bets on casino games (coi...

Registry SourceRecently Updated
Automation

Multi Agent Coordinator Zhuyu28

Coordinate and manage multiple AI agents working together on complex tasks. Provides orchestration, communication patterns, and workflow management for multi...

Registry SourceRecently Updated