/compact-context

/compact-context - 上下文压缩

智能压缩当前对话上下文，保留关键信息，释放 token 空间。

⚠️ 重要提示：官方 auto-compact 有已知 bug，建议在上下文 70% 时主动执行压缩。 详见：#18211、#21853

使用场景

• 对话过长，响应变慢
• 完成一个大功能后，准备开始新功能
• 上下文中有大量已完成任务的冗余讨论
• 上下文使用率接近 70%（避免触发官方 bug）

执行流程

1. 状态保存（必须）

在压缩前，确保以下信息已持久化到文件：

□ 当前任务状态 → progress.md
□ 重要决策 → progress.md 决策记录表
□ 待确认假设 → progress.md 待确认列表
□ 未完成的代码变更 → 已保存到文件

2. 生成压缩摘要

创建 memory-bank/_compact_summary.md（临时文件）：

# 上下文压缩摘要

## 会话概述

- 开始时间: [时间]
- 主要目标: [目标]
- 完成状态: [X/Y 任务完成]

## 关键决策

1. [决策1]: [原因]
2. [决策2]: [原因]

## 当前状态

- 正在进行: [任务]
- 阻塞项: [如有]

## 重要发现

- [发现1]
- [发现2]

## 下一步

- [待办1]
- [待办2]

3. 压缩策略

保留	移除
当前任务上下文	已完成任务的详细讨论
关键决策和原因	冗余的代码展示
待办事项	探索性的失败尝试
错误和解决方案	重复的文件读取
架构约束	已解决的问题讨论

4. 执行压缩

1. 更新 progress.md 的 last_checkpoint 字段
2. 输出压缩摘要
3. 提示用户执行 /clear

与官方命令的区别

命令	来源	行为	适用场景
/clear	官方	完全清除上下文	任务完成，开始新任务
官方 /compact	官方	自动压缩（有 bug）	不推荐使用
本插件 compact-context	本插件	保存状态 + 生成摘要	压缩前的准备工作
本插件 catchup	本插件	恢复上下文	/clear 后恢复

命令格式说明：根据安装方式不同，命令格式也不同：

• 通过 /plugin install 安装：使用 /cc-best:compact-context、/cc-best:catchup
• 直接 clone 到 .claude/：使用 /cc-best:compact-context、/cc-best:catchup

输出格式

## 上下文压缩完成

### 已保存
- ✓ 进度状态 → progress.md
- ✓ 决策记录 → progress.md
- ✓ 压缩摘要 → _compact_summary.md

### 压缩摘要
[摘要内容]

### 下一步
执行官方 `/clear` 清除对话，然后执行 `/cc-best:catchup` 恢复上下文。

注意事项

• 压缩前确保所有重要信息已保存
• _compact_summary.md 是临时文件，恢复后可删除
• 如果正在进行关键操作，先完成再压缩

记住: 压缩时机很重要——70% 是最佳压缩点，超过 85% 可能失败。宁可早压缩也不要等到来不及。