name: check-context description: 分析当前上下文窗口使用情况并提供优化建议 allowed-tools: Read, Bash
检查上下文
分析当前上下文窗口状态并提供优化建议。这有助于识别上下文何时变得臃肿,需要采取行动。
用法
/check-context
分析内容
- 当前上下文大小 - 估计的令牌使用量
- 上下文组成 - 消耗令牌的内容
- 健康评估 - 是否需要行动
- 优化选项 - 可用的补救措施
上下文健康阈值
| 使用率 | 状态 | 行动 |
|---|---|---|
| < 50% | 健康 | 无需行动 |
| 50-75% | 监控 | 考虑尽快运行 /compact |
| 75-85% | 警告 | 运行 /compact 或 /clear |
| > 85% | 严重 | 需要立即行动 |
上下文组成(典型)
Claude Code 的上下文通常包括:
| 组件 | 典型大小 | 备注 |
|---|---|---|
| 系统提示 | 15-25k 令牌 | 基础指令 |
| CLAUDE.md 文件 | 5-15k 令牌 | 记忆文件 |
| 已加载技能 | 1-5k 令牌 | 活动技能 |
| 对话历史 | 变量 | 随对话轮次增长 |
| 工具结果 | 变量 | 可能较大 |
| 文件内容 | 变量 | 来自读取操作 |
工作流程
步骤 1:估计上下文使用量
注意:精确的上下文使用量是 Claude Code 内部数据。此命令基于可观察因素提供估计:
需要考虑的因素:
- 对话长度(轮次)
- 最近文件读取
- 工具输出量
- 已加载技能/记忆
步骤 2:评估健康状态
基于可观察信号:
健康指标:
- 快速响应时间
- 无截断警告
- 准确回忆早期上下文
警告指标:
- 响应变慢
- 偶尔记忆缺失
- 自动压缩消息出现
严重指标:
- 响应非常慢
- 频繁上下文失效
- 截断警告
- 操作失败
步骤 3:提供建议
上下文窗口分析
=======================
估计状态:{健康 | 监控 | 警告 | 严重}
可观察指标:
对话轮次:{数量}
最近文件读取:{数量} 文件
工具调用:{数量}
已加载技能:{列表}
评估:
{描述当前状态}
建议:
{优先级行动}
可用命令:
/clear - 完全重置上下文(极端选项)
/compact - 智能总结(保留关键信息)
/cost - 查看令牌使用量和成本
上下文管理提示:
- 在主要任务切换之间使用 /clear
- 优先使用聚焦、具体的查询而非广泛探索
- 让 Claude 使用子代理进行大型操作
- 将大型任务分解为较小会话
示例输出
健康上下文
上下文窗口分析
=======================
估计状态:健康
可观察指标:
对话轮次:8
最近文件读取:3 文件
工具调用:12
已加载技能:2(文档管理、技能开发)
评估:
上下文似乎健康。响应快速且准确。无退化迹象。
建议:
无需行动。正常继续。
提示:
- 当前会话高效
- 开始新主要任务前考虑 /clear
警告状态
上下文窗口分析
=======================
估计状态:警告
可观察指标:
对话轮次:47
最近文件读取:23 文件
工具调用:156
已加载技能:5
评估:
上下文正在变满。您可能会注意到:
- 响应略微变慢
- 偶尔回忆早期上下文有缺失
- 自动压缩可能很快触发
建议:
1. 运行 /compact 以总结并释放空间
2. 或者运行 /clear 如果开始新任务
3. 首先将重要上下文保存到临时文件
需要关注的警告迹象:
- 如果响应进一步变慢,立即行动
- 注意截断或“我不记得”的响应
严重状态
上下文窗口分析
=======================
估计状态:严重
可观察指标:
对话轮次:89
最近文件读取:45 文件
工具调用:312
已加载技能:7
自动压缩触发:3 次
评估:
上下文接近容量。可能出现显著退化:
- 预期响应非常慢
- 回忆早期上下文差
- 操作失败风险
需要立即行动:
选项 1(保留进度):
1. 将当前任务状态记录到文件
2. 运行 /compact
3. 恢复聚焦上下文
选项 2(全新开始):
1. 运行 /clear
2. 重新加载仅必要上下文
3. 继续使用新鲜上下文
选项 3(新会话):
1. 如果需要,记录会话 ID 以供 /resume
2. 开始新的 Claude Code 会话
3. 新鲜 200k 令牌上下文
备注
- 此命令提供估计 - 精确令牌计数是内部数据
- 可观察信号是上下文健康的好代理
- 如有疑问,/compact 比继续更安全
- 子代理通过隔离上下文繁重操作来帮助