SuperAPI AI 工具集

Context Manager

智能体与模型

查看项目

更新于 10-16 09:10

技能介绍

用途

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 端点放一张表、所有依赖放一个列表)。