Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
建议在工作流的战略点手动执行 /compact,而不是依赖随机的自动压缩。
自动压缩会在任意点触发:
在逻辑边界进行策略性压缩:
suggest-compact.js 脚本在工具预调用(PreToolUse,包括 Edit/Write)时运行,并执行:
将以下内容添加到你的 ~/.claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit",
"hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
},
{
"matcher": "Write",
"hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
}
]
}
}
环境变量:
COMPACT_THRESHOLD — 首次建议前的工具调用次数(默认:50)参考下表决定何时进行压缩:
| 阶段转换 | 是否压缩? | 原因 |
|---|---|---|
| 研究 → 规划 | 是 | 研究上下文很臃肿;计划是精炼后的输出 |
| 规划 → 实现 | 是 | 计划已记录在 TodoWrite 或文件中;为代码腾出上下文空间 |
| 实现 → 测试 | 视情况而定 | 如果测试引用了最近的代码则保留;如果切换关注点则压缩 |
| 调试 → 下一个特性 | 是 | 调试追踪信息会污染不相关工作的上下文 |
| 实现过程中 | 否 | 丢失变量名、文件路径和部分状态的代价很高 |
| 尝试方案失败后 | 是 | 在尝试新方案前清理掉死胡同的推理过程 |
了解哪些内容会持久化,可以让你放心地进行压缩:
| 存留项 | 丢失项 |
|---|---|
CLAUDE.md 指令 | 中间推理与分析过程 |
TodoWrite 任务列表 | 之前读取的文件内容 |
记忆文件 (~/.claude/memory/) | 多轮对话上下文 |
| Git 状态(提交、分支) | 工具调用历史与计数 |
| 磁盘上的文件 | 口头陈述的细微用户偏好 |
TodoWrite 中确定了计划,进行压缩以重新开始/compact — 添加自定义消息:/compact Focus on implementing auth middleware nextcontinuous-learning 技能 — 在会话结束前提取模式