Compress Long Agent Context Reliably — 长会话上下文的结构化压缩与质量评估 Skill 技能

技能简介

Compress Long Agent Context Reliably 是面向 Claude / Codex / Claude Code 的长上下文压缩工程助手。它解决 Agent 在多轮长任务中「压缩太狠丢文件、丢决策、丢下一步」的痛点，提供锚定迭代摘要、不透明压缩、再生摘要三种策略，按 context 利用率与任务边界推荐触发时机，并把压缩结果组织成「会话意图 / 文件 / 决策 / 当前状态 / 下一步」五段式结构。该 Skill 由 ChakshuGautam 维护，质量分 80 分（银级），audit status complete，下载量 101、收藏 4，是 Skillstore 上少有的「带 Python 评估器」的上下文工程 Skill。

核心能力

1. 三种压缩策略：锚定迭代摘要、不透明压缩、再生式摘要，按场景推荐最优组合。
2. 触发时机建议：基于 context 利用率与任务边界双重信号判断何时压缩，避免「过早压缩丢信息、过晚压缩超限」。
3. 结构化五段输出：每次压缩都按 intent / files / decisions / state / next steps 五段组织，便于 Agent 后续回读。
4. probe 评测体系：定义 recall / artifact / continuation / decision 四类探针，给压缩质量打分。
5. Python 评估器：内置启发式评分 + summarizer 工具，可在 CI / 离线实验中验证压缩策略。

安装配置

1. 命令行安装：npx skillstore add chakshugautam/context-compression，需 npx 与 Node.js 18+。
2. Python 依赖：评估器需要 Python 3.10+，仅使用标准库，无外部依赖。
3. Agent 集成点：把压缩触发器嵌入 Agent runtime 的 context utilization 监控，建议阈值 60% / 80% 双档。
4. probe 库建设：把 recall / artifact / continuation / decision 四类探针存为版本化 JSONL，便于回归。

使用步骤

1. 会话意图压缩：使用 Summarize Current Session 模板，把当前会话压成五段结构化输出。
2. 压缩策略规划：使用 Plan Compression Strategy 模板，让 Claude 选触发阈值与摘要结构，并解释 token 与连续性取舍。
3. 探针设计：使用 Build Evaluation Probes 模板为压缩策略配探针，覆盖召回 / 产物 / 续接 / 决策四维。
4. 漂移审计：使用 Audit Compression Drift 模板对比多次压缩结果，识别「丢的事实 / 漏的文件 / 改的决策」，并给出改进动作。
5. 评估器闭环：在 Python 评估器里跑启发式评分，把分数作为压缩策略 AB 实验的依据。

适用场景

• 长调试会话留存：错误、修改文件、未跑测试在压缩后仍可见，避免 Agent 失忆导致重复劳动。
• Agent 记忆摘要：跨多轮运行的 Agent 维护结构化记忆摘要，供后续 turn 拉取。
• 压缩质量对比：用探针与评分维度客观比较不同压缩策略的优劣。
• 多 Agent 协同：在主-子 Agent 架构里，子 Agent 的状态摘要需要严格结构化，主 Agent 才能正确路由。

适用人群

• Agent 框架开发者：把压缩策略从「一个魔法阈值」升级为「结构化 + 可评估」系统。
• 长任务 Agent 操作员：在编码 / 研究 / 调试类长 session 中保持上下文连续性。
• AI 工程研究人员：用 probe + rubric 做压缩策略的离线对比实验。
• 多 Agent 系统架构师：在主-子 Agent 协同场景下设计可序列化的状态摘要。

工作原理

Skill 核心是一套结构化压缩协议。每次压缩都先按 context utilization 与任务边界判定触发，再按五段结构（intent / files / decisions / state / next）生成锚定摘要，关键决策与文件路径被显式「钉死」而非「隐式概括」。评估器通过 probe（recall / artifact / continuation / decision）量化压缩后的事实保留率、产物可还原率、续接准确率、决策一致率。审计确认 16 条静态告警均为 Markdown 文档示例或 probe 用例的误判，无 prompt 注入、外泄意图或隐式执行钩子。

官方链接

• Skillstore 页面：https://skillstore.io/skills/chakshugautam-context-compression
• 源码仓库：https://github.com/ChakshuGautam/games/tree/main/.claude/skills/context-compression
• Manifest：https://skillstore.io/api/skills/chakshugautam-context-compression/manifest
• 安装命令：npx skillstore add chakshugautam/context-compression