用途
Context Manager 技能用于优化对话上下文,帮助 Claude 在长时间会话中保持有效性。它会追踪上下文窗口的使用情况,判断何时需要总结或裁剪上下文,并帮助结构化对话,使相关信息保持可访问,同时不超出 token 限制。
该技能适用于对话历史不断增长的复杂多日项目。它帮助判断哪些内容需要保留、哪些需要总结、哪些可以丢弃,从而让 Claude 在不触及上下文上限的情况下持续掌握重要决策与项目状态。建议在长时间开发会话中、开始新的大型功能前,或发现因上下文膨胀导致性能下降时主动使用。
主要能力(核心工作流)
工作流 1:监控上下文健康度
- 检查当前上下文使用情况:token 数量、占上限百分比、近期增长速度
- 分析上下文构成:代码占比、对话占比、文档占比
- 识别问题区域:冗余信息、过时引用、无关分支
- 评估风险等级:绿色(<50% 使用,健康)、黄色(50-75% 使用,需监控)、红色(>75% 使用,需采取行动)
- 必要时建议操作,并向用户报告状态
工作流 2:总结长对话
- 回顾对话历史
- 提取关键信息:已做决策、已解决问题、当前项目状态、未决问题、下一步行动
- 按主题/时间线组织,生成简明总结
- 与用户确认,建议携带总结开启新线程
工作流 3:裁剪无关上下文
- 识别可移除内容:已解决的问题、已放弃的方案、临时调试、被取代的信息
- 按重要性分类:可安全移除、可总结、必须保留
- 向用户提出裁剪计划,执行已批准的移除
- 保留关键上下文,裁剪后验证连贯性
工作流 4:优化上下文结构
- 分析当前上下文组织方式
- 识别低效之处:信息分散、解释冗余、缺乏结构
- 重构以提高效率:分组相关信息、建立参考章节、使用简洁格式
- 建议将架构决策、API 规范、配置细节等移至外部文档,以外链代替内联
- 验证效率提升
使用方式
快速参考(触发方式):
| 操作 | 命令/触发词 |
|---|---|
| 检查上下文状态 | “Check context window” 或 “How's our context?” |
| 总结对话 | “Summarize this conversation” |
| 携带总结重新开始 | “Start new thread with summary” |
| 裁剪旧上下文 | “Clear old context” 或 “Prune conversation” |
| 优化上下文结构 | “Optimize our context” |
| 保留关键决策 | “Document key decisions” |
| 估算上下文用量 | “How much context are we using?” |
最佳实践:
- 主动监控:不要等到出现性能问题;在开始大型功能前检查上下文,长时间调试后监控,长期项目每周检查
- 定期总结:在自然断点压缩历史,如功能开发结束、解决重大问题后、切换上下文(开发→部署)前
- 外部化静态信息:将不变内容移至文件,如架构文档、API 规范、代码风格指南、参考资料
- 使用结构化格式:用表格代替长文、用要点代替段落、用代码块代替描述
- 保留决策:始终保留“为什么”,包括为何选择该方案、为何拒绝备选、哪些约束影响了决策
- 积极丢弃:对临时内容果断处理,包括调试探索、失败实验、已解决问题、被取代的计划
- 策略性地重新开始:在重大里程碑后、切换到无关工作时、上下文超过 75% 时、性能下降时开启新对话
- 外部文档化:用文件保存持久知识,如 PIPELINE_STATUS.md(项目状态)、DECISIONS.md(架构选择)、TODO.md(任务清单)、README.md(入门)
上下文优化策略
- 策略 1:分层总结——长对话 → 详细总结(减少 50%)→ 执行摘要(减少 80%)→ 关键决策(减少 95%)
- 策略 2:基于时间的窗口——保留最近 1 小时完整细节、最近 4 小时总结、最近一天仅关键决策、更早内容链接至外部文档
- 策略 3:基于主题的分区——为功能开发、缺陷调查、部署运维、架构讨论分别建立线程,并可按需互相链接
- 策略 4:渐进式披露——仅从当前任务上下文开始,按需添加相关决策、相关代码、背景信息,完成后移除
适用场景
- 复杂、多日的开发项目
- 长时间会话中对话历史持续增长
- 在开始新的大型功能前
- 注意到因上下文膨胀导致性能下降时
- 需要在长会话中保留关键决策与项目状态
限制与注意事项
- 资料未提供该技能的安装命令、代码实现或具体的模型/平台依赖信息
- 资料未说明收费、价格或授权方式
- 资料未提供可量化的效果数据
上下文健康检查清单
开始大型任务前确认:上下文使用 <75%、近期决策已记录、已移除过时信息、当前项目状态清晰、下一步已明确、相关文件/文档已链接、调试痕迹已清理。
上下文问题的警示信号
注意这些指标:回复变慢(处理大量上下文)、信息被忽略(AI 漏掉近期上下文)、重复(AI 重新解释已知信息)、连贯性丧失(AI 忘记早前决策)、token 上限警告(接近硬限制)、准确性下降(此前稳定区域出错)。
外部记忆策略
将以下内容移至文件而非上下文:项目概览→README.md;架构决策→ARCHITECTURE.md 或 ADR;API 契约→OpenAPI 规范或 schema 文件;当前项目状态→PIPELINE_STATUS.md 或 TODO.md;配置→.env、配置文件;代码风格规则→.eslintrc、prettier.config.js;部署流程→DEPLOYMENT.md 或 CI/CD 配置;团队决策→DECISIONS.md 或会议记录。
上下文模板
项目状态摘要模板:
## Project: [Name]
- **Status**: [Current pipeline stage]
- **Current focus**: [What we're working on]
- **Last completed**: [Recent achievement]
- **Next steps**: [Immediate tasks]
- **Blockers**: [What's preventing progress]
- **Key decisions**: [Recent important choices]
决策日志模板:
## Decision: [Topic]
- **Date**: [When]
- **Context**: [Why we needed to decide]
- **Options considered**: [Alternatives]
- **Choice**: [What we decided]
- **Rationale**: [Why this choice]
- **Consequences**: [Trade-offs accepted]
会话摘要模板:
## Session Summary: [Date]
- **Duration**: [How long]
- **Accomplished**: [What we built/fixed]
- **Decisions**: [Choices made]
- **Issues found**: [Problems discovered]
- **Next session**: [Where to continue]
进阶:上下文压缩技巧
面向进阶用户:使用引用(链接到代码而非粘贴,如 “See function processData in /src/utils/data.ts”);利用 AI 记忆(在知识图谱中存储实体间关键关系、项目术语、团队成员角色与专长);创建缩写(定义一次,处处使用,如 “FE”=Frontend、“BE”=Backend、“MR”=Merge Request、“PR”=Pull Request);使用 diff 格式(展示变更而非整个文件,尤其适用于代码评审、前后对比);批量归类相似信息(所有环境变量放一个块、所有 API 端点放一张表、所有依赖放一个列表)。