上下文压缩、/compact 与关键信息保留

上下文窗口是代理最宝贵的工作资源：窗口内同时存放指令、记忆、读取到的代码与多轮对话。合理压缩（compaction）能在不丢失关键结论的前提下释放空间，本节讲清压缩命令、检查点机制与"什么必须保留"。

一、主动压缩：/compact

/compact
/compact 保留接口约定、已排除的方案与测试失败现象

• /compact 把当前对话历史归纳为摘要后继续；可附带说明 [instructions]，指定压缩时重点保留哪些事实（如决策、约束、未解决问题、失败现象）。
• 压缩不是清空：关键背景、已做决定与当前任务目标应被摘要保留；纯过程性来回与大段中间输出可被精简。
• 压缩完成后，项目根 CLAUDE.md 会从磁盘重新读取并重新注入；子目录规则在再次接触相关文件时按需重载，因此持久规则应落在文件里，而不是只靠对话历史。

二、检查点与回退：/rewind

• 运行中会生成检查点；使用 /rewind 可在检查点之间选择恢复点，按摘要（从某处汇总、汇总到某处）定位状态。
• 检查点可用于恢复对话、文件改动或两者组合，适合在走偏后回到干净节点重新决策。
• 需要中断当前动作时按 Esc；结合局部摘要手段，可以在长任务中边推进边收敛上下文。

三、压缩时必须保留的关键信息清单

类别	应保留	可被精简
目标与约束	任务目标、非功能要求、禁止事项、验收标准	反复确认的寒暄与过程性问答
技术事实	关键文件路径、接口约定、已排除方案与原因、报错根因线索	大段被否定的草稿、重复读取的超长文件原文
决策状态	已采纳方案、未决分歧、下一步动作	中途被推翻的假设叙述
质量信号	测试/构建结果、已知失败用例与复现条件	冗长的命令原始输出

四、降低压缩损失的习惯

1. 重要约定、固定环境与领域术语尽早写入项目记忆文件，压缩后仍由文件提供基线。
2. 让阶段性结论显式落盘：决策、清单、设计要点写入文件，对话只保留推进过程。
3. 大规模探索交给只读子代理，由它返回精炼结论，避免把大量原始代码塞进主会话窗口。
4. 在里程碑节点主动压缩并指定保留重点，而不是等到系统自动触发、质量下降后再处理。