用途：Headroom 是编码智能体的便携式 token 压缩技能，教智能体在上下文中应用压缩技术，不依赖 Headroom 二进制。当工具结果短于约 200 token 时跳过压缩，因为开销不划算。
主要能力：按内容类型选择变换——JSON 对象数组用 SmartCrusher（scripts/smart_crusher.py）；构建/测试日志用 LogCompressor（scripts/log_compressor.py）；grep/ripgrep/ag 输出用 SearchCompressor（scripts/search_compressor.py）；源码用 CodeCompressor（scripts/code_compressor.py）；超上下文预算的对话历史用 RollingWindow（scripts/context_manager.py）；写入内容用 Output Shaper（prompts/verbosity_steering.md）。
核心规则：粘贴前压缩；始终 100% 保留错误、堆栈和 FAILED 行；数组、日志与搜索结果保留前 3、后 2 项；稳定前缀，把动态内容移到提示尾部；超预算时从最旧处丢弃完整的 tool_call 与 tool_result 对，不拆分、不丢系统提示和最近 2 轮用户消息；按 L2 默认控制自身输出详尽度；可逆，压缩前把原文写入 .headroom-cache/<sha256>.txt 并给出 SHA。
安全规则：不丢弃用户或助手文本；不拆散 tool_call/tool_result 对；解析失败则原样透传；始终保留最近若干轮与系统提示；100% 保留错误；幂等。
文件：AGENTS.md、CLAUDE.md、docs/techniques.md、docs/integrations.md、docs/reversible-ccr.md、scripts/、prompts/、examples/。脚本为纯 Python 标准库，无需 pip install。
限制与说明：压缩是选择而非 gzip；本技能是 chopratejas/headroom 的可移植重实现，上游项目更快、更准确且基于 ML，若可安装建议安装。其余平台支持、收费等信息暂未提供。