技能 context-compression
📦

context-compression

安全

优化长会话中的 AI 上下文压缩

也可从以下获取: ChakshuGautam,muratcankoylan

AI 代理在激进压缩后会浪费 token 重新获取丢失的上下文。此技能教授结构化摘要策略,可在保留关键信息的同时将 token 成本降低高达 98%。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“context-compression”。 具有 178 条消息的代理会话,用于调试身份验证错误

预期结果:

  • 创建了包含 5 个部分的结构化摘要:会话意图、根本原因、已修改文件、测试状态、后续步骤
  • 压缩率:98.6%(89000 token 到 1240 token)
  • 探测评估:技术细节保留准确性 4.2/5

正在使用“context-compression”。 三种编码任务压缩策略的比较

预期结果:

  • 锚定迭代:98.6% 压缩率,3.70 质量分数 - 最适合文件跟踪
  • 再生式:98.7% 压缩率,3.44 质量分数 - 良好平衡
  • 不透明式:99.3% 压缩率,3.35 质量分数 - 最高压缩率,最低质量

安全审计

安全
v1 • 2/24/2026

All 16 static analysis findings are false positives. The skill contains only markdown documentation (SKILL.md, 271 lines) with no executable code. Detected patterns include markdown code block delimiters misidentified as shell execution, documentation URLs misidentified as network calls, and conceptual references misidentified as cryptographic implementations. No security risks identified.

1
已扫描文件
271
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

调试长运行代理会话

在 100+ 消息的调试会话中保持上下文,同时跟踪文件修改、错误消息和决策,而不丢失关键技术细节。

构建企业级编码代理

为处理 500 万 + token 代码库的代理设计上下文管理,实施保留函数签名、类型定义和架构决策的压缩。

评估压缩质量

使用基于探测的评估测试不同的压缩策略,在部署到生产环境之前衡量准确性、工件跟踪和继续能力。

试试这些提示

初学者:设计结构化摘要模板
帮助我为我的编码代理会话设计一个结构化摘要模板。我需要用于跟踪已修改文件、所做决策和后续步骤的部分。我的代理主要使用 TypeScript 和 Redis。
中级:实施压缩触发器
我正在构建一个编码代理,在 50 条消息后会丢失上下文。设计一个使用滑动窗口方法的压缩触发策略。包括何时压缩的标准以及如何增量合并摘要。
高级:评估压缩质量
为我的上下文压缩系统创建一个基于探测的评估框架。生成 20 个探测问题,涵盖召回、工件跟踪、继续和决策类别,以测试我的摘要是否保留了关键信息。
专家:为大型代码库优化
为一个 500 万 token 的代码库迁移项目设计一个三阶段压缩工作流。包括研究阶段压缩到规范、规划阶段到实施细节,以及使用示例工件作为压缩种子的策略。

最佳实践

  • 使用明确的部分来跟踪文件修改、决策和后续步骤,以防止静默信息丢失
  • 在上下文使用率达到 70-80% 时触发压缩,采用增量合并而非完全再生
  • 在部署到生产工作流之前使用探测问题测试压缩质量

避免

  • 针对每请求 token 而非每任务总成本进行优化
  • 在文件跟踪对任务至关重要时使用激进的不透明压缩
  • 在每次压缩时重新生成完整摘要而非增量合并

常见问题

我应该期望编码代理会话的压缩率是多少?
结构化摘要可实现 98.6% 的压缩率同时保持质量。对于 89000 token 的会话,压缩后预计约为 1240 token。不透明方法可达到 99.3%,但会丢失关键技术细节。
我如何知道我的压缩是否丢失了重要信息?
使用基于探测的评估:压缩后向您的代理询问有关文件路径、错误消息和决策的问题。如果答案模糊或不正确,说明您的压缩丢失了信号。跟踪重新获取频率作为质量指标。
编码任务的结构化摘要应该包含哪些部分?
包括会话意图、带有具体更改的已修改文件、所做决策、包含测试结果的当前状态和后续步骤。这些部分作为检查清单,强制摘要器保留关键信息。
我应该在何时压缩我的代理对话上下文?
在上下文使用率达到 70-80% 时触发压缩以获得可预测的行为。任务边界压缩(在逻辑完成点)产生更清晰的摘要,但时间不可预测。避免等到达到上下文限制时才压缩。
压缩能否处理多文件代码库更改?
可以,但工件轨迹跟踪是所有方法中最弱的维度(5.0 分中为 2.2-2.5 分)。在结构化摘要中使用明确的文件部分,并考虑为关键文件状态跟踪使用单独的工件索引。
锚定迭代摘要是否比再生方法更好?
对于长运行编码会话(100+ 消息),锚定迭代方法更优,因为它通过增量合并跨周期保留信息。当无法进行完整上下文审查时,再生方法可能会丢失细节。

开发者详情

文件结构

📄 SKILL.md