用途
strategic-compact 用于解决长会话中自动压缩(auto-compaction)时机不可控的问题。自动压缩常在任务进行到一半时触发,打断复杂多步操作并丢失重要上下文。该技能在逻辑边界处建议手动执行 /compact,以保留任务各阶段所需的信息。
主要能力
- 上下文大小信号(主要):脚本读取会话记录中最新用量记录,累加 input_tokens + cache_read_input_tokens + cache_creation_input_tokens,得到该轮真实上下文大小。达到按窗口缩放的阈值(200k 窗口为 160k tokens,1M 窗口为 250k tokens)时建议 /compact,之后每再增长 60k tokens 重新提醒。
- 工具调用次数信号(次要):统计会话中的工具调用次数,达到可配置阈值(默认 50 次)后建议压缩,之后每 25 次再提醒。
- 通过 PreToolUse 钩子在 Edit/Write 时运行 suggest-compact.js。
使用方式
在 ~/.claude/settings.json 中添加钩子配置:PreToolUse 匹配 Edit 和 Write,命令为 node ~/.claude/skills/strategic-compact/suggest-compact.js。
支持的环境变量:
- COMPACT_THRESHOLD:首次建议前的工具调用次数,默认 50。
- COMPACT_CONTEXT_THRESHOLD:上下文 token 建议阈值,默认 200k 窗口 160000、1M 窗口 250000;设为 0 禁用上下文信号。
- COMPACT_CONTEXT_INTERVAL:建议重复前的额外上下文 token,默认 60000。
- ECC_CONTEXT_WINDOW_TOKENS:显式指定上下文窗口大小,覆盖自动检测。
- CLAUDE_CODE_AUTO_COMPACT_WINDOW:Claude Code 原生窗口大小覆盖,在 ECC_CONTEXT_WINDOW_TOKENS 未设置时作为回退。
上下文窗口默认通过 [1m] 模型标记自动检测,或在已观测 token 超过 200k 时推断。大窗口模型若两者皆无信号,需设置上述覆盖项。
适用场景
- 接近上下文上限(200K+ tokens)的长会话。
- 多阶段任务:研究 → 规划 → 实现 → 测试。
- 同一会话内切换不相关任务。
- 完成重要里程碑后开始新工作。
- 响应变慢或连贯性下降(上下文压力)时。
压缩决策与限制
技能提供决策表建议:研究转规划、规划转实现、调试转下一功能、失败方案后建议压缩;实现中途不建议压缩;实现转测试视情况。
压缩后保留:CLAUDE.md 指令、磁盘文件、记忆文件、Git 状态。会丢失:中间推理、已读文件内容、多步对话上下文、工具调用历史。任务列表仅在存在 todo 工具时保留——Claude Code 2.1.233 在 Opus 4.8、Sonnet 5 等新模型上默认移除了 todo/task 工具,CLAUDE_CODE_ENABLE_TODO_TOOLS=1 可恢复但属于本机环境设置。因此建议压缩前将计划写入文件。
最佳实践:规划后压缩、调试后压缩、不在实现中途压缩、阅读建议自行决定、压缩前写文件、使用带摘要的 /compact。