开发与工程

上下文效率优化

通过缓存、遮蔽、压缩与分区降低上下文成本,同时保护回答质量。

44/ 100
不推荐

当前收益不足以覆盖风险或不确定性。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 18k
最近更新
16 天前
License
MIT
context-optimizationtoken-budgetingkv-cacheobservation-masking
+2context-partitioningretrieval-scoping

这个 Skill 能做什么,适合哪些场景?

这是一个面向智能体系统的上下文优化技能,专注于有限上下文窗口中的令牌预算、检索范围和信息保留。它按优先级介绍 KV 缓存优化、观察结果遮蔽、上下文压缩和上下文分区。技能提供触发阈值、预算策略、性能目标、决策框架和常见故障模式。它适合需要降低令牌成本、改善延迟或延长有效上下文容量的生产智能体系统。

它分析上下文中工具输出、消息历史和检索文档的占比,分配各类令牌预算,并根据利用率、错误状态和质量信号触发优化。它指导用户将稳定内容放在提示词前缀以提高 KV 缓存复用,将已处理的冗余工具输出替换为可检索引用,对超预算上下文进行摘要压缩,并在任务过大时拆分给隔离上下文中的子智能体。它还建议跟踪令牌减少、缓存命中率、质量变化、延迟和分区后的净节省。

适合
  • 构建生产智能体时,工具输出占据大部分上下文,需要在保留可检索性的同时减少令牌消耗。
  • 运行稳定的重复请求时,希望通过固定提示词前缀提升 KV 缓存命中率并降低成本与延迟。
  • 长会话接近上下文上限,需要在保留任务目标、用户约束和关键错误信息的前提下进行压缩。
  • 处理包含多个独立子任务的问题,单一上下文无法容纳全部内容,需要评估是否值得使用多智能体分区。
  • 设计智能体运行策略时,需要为工具输出、检索文档、消息历史和预留缓冲区设置预算与触发条件。

如何安装这个 Skill?

使用前请注意
  • 不要将示例启发式摘要、令牌计数或缓存指标直接用于生产决策;应使用目标模型分词器、真实运行时指标和质量回归测试。
  • 统一70%与80%的压缩触发阈值,并为外部存储、引用淘汰、敏感工具输出和失败恢复定义明确策略。
  • 在采用KV缓存或分区建议前确认运行时支持、数据隔离和成本收益;该材料没有证明中文或大陆网络环境下的可用性。

获取仓库后,将 skills/context-optimization 整个目录复制到目标项目的 Agent Skills 目录,例如:mkdir -p .codex/skills && cp -R skills/context-optimization .codex/skills/。必须保留目录结构和其中的 SKILL.md;不要将文件扁平化为单独的 Markdown 文件。README 未提供该单个技能在所有宿主中的统一安装命令。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/context-optimization" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在支持 Agent Skills 的宿主中,将任务描述为需要上下文效率优化的问题,例如:请分析当前智能体的上下文组成,制定令牌预算,并设计观察结果遮蔽、KV 缓存前缀稳定性和压缩触发策略。 当令牌预算、观察结果遮蔽、前缀缓存、检索范围或上下文分区成为问题时激活该技能。具体宿主的自动激活命令未在来源中说明。

这个 Skill 有哪些优点和局限?

优点
  • 提供明确的优化优先级、触发阈值和预算管理方法。
  • 同时覆盖 KV 缓存、观察结果遮蔽、压缩和多智能体上下文分区。
  • 强调以令牌、质量、延迟和缓存命中率等指标验证优化效果。
  • 明确列出错误信息遮蔽、过早压缩和分区协调成本等风险。
局限
  • 来源未提供该单个技能的独立测试套件或实测基准结果。
  • 性能数字主要是目标值和经验性指导,不能视为在所有模型或运行时中已验证的保证。
  • KV 缓存效果依赖运行时支持前缀缓存;上下文分区还需要可用的多智能体协调机制。
  • 具体的外部存储、检索实现和宿主集成步骤没有详细定义。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
上下文效率优化 本页 44 · 不推荐 ★ 18k 16 天前 MIT
上下文工程基础 55 · 谨慎使用 ★ 18k 16 天前 MIT
潜在简报 55 · 谨慎使用 ★ 18k 16 天前 MIT
LeanCTX 本地上下文智能层 61 · 推荐 ★ 3.9k 13 天前 Apache-2.0
LeanCTX 本地上下文控制 59 · 推荐 ★ 3.9k 13 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
不推荐
44/ 100 五分制 2.2 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全9 / 25 · 1.8/5

技能主要提供上下文压缩、遮蔽、预算和缓存优化建议,没有凭据读取、外部写入或破坏性默认操作,并提醒生产环境使用模型专用分词器;但未明确敏感数据处理、权限边界、外部存储隔离、用户确认、回滚策略或来源归因,因此扣分。

2可靠稳定7 / 20 · 1.8/5

SKILL.md、参考文档和脚本覆盖主要路径并提供异常场景提示,但阈值存在不一致(正文多处使用70%,脚本在80%才触发),分类逻辑较脆弱,令牌估算和摘要依赖启发式,ObservationStore存在容量淘汰导致引用失效的路径;静态评估且缺少针对该脚本的测试,因此受限于10分上限并进一步扣分。

3适用触发10 / 15 · 3.3/5

激活条件、非适用范围、四类策略和部分平台/runtime前提描述较清楚,适用于上下文受限的智能体系统;但缺少明确输入输出契约、模型/运行时兼容矩阵、中文场景说明及大陆网络环境适配证据,且部分建议依赖可控推理基础设施,因此扣分。

4规范维护9 / 15 · 3.0/5

文档结构清晰,包含渐进式参考文档、示例、指标、故障陷阱、集成说明、版本、更新时间和MIT许可证;但维护责任、变更记录、依赖安装说明、引用来源和该技能脚本的正式测试覆盖不完整,因此未满分。

5有效结果6 / 15 · 2.0/5

内容能直接指导预算、遮蔽、压缩、缓存和分区设计,脚本也提供可复用的演示API;但核心摘要只是规则提取或截断,令牌估算不精确,缓存指标是示意性计算,缺少针对该技能的代表性验证和与替代方案的比较,按静态校准不超过7分。

6证据核验3 / 10 · 1.5/5

脚本、参考资料、示例和仓库级CI提供一定可审计材料,但CI列出的编译与测试路径不覆盖skills/context-optimization/scripts/compaction.py,性能目标主要是未附实验数据的声明,外部研究也未在该技能内给出具体可核验出处;因此仅给有限静态证据分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 c578e85e40fe 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能会自动执行压缩或遮蔽吗?
来源将其描述为指导智能体系统进行优化的技能,提供策略、阈值和示例代码;没有证据表明它自身包含可直接执行的优化程序。
什么时候应该优先使用哪种策略?
稳定前缀存在且运行时支持缓存时先做 KV 缓存优化;工具输出占主导时先遮蔽;上下文利用率超过约 70% 时考虑压缩;预计任务上下文超过窗口约 60% 且至少有多个独立子任务时评估分区。
它适合正在调试的智能体吗?
适合用于优化调试中的上下文,但应保留最近的错误输出、堆栈和主动推理所需信息,避免过度遮蔽破坏调试循环。

同仓库的其他 Skills

均来自 muratcankoylan/Agent-Skills-for-Context-Engineering

开发与工程

上下文工程基础

用注意力预算和上下文质量原则,理解并设计更可靠的智能体上下文。

★ 18k FS 55 谨慎使用 16 天前
开发与工程

潜在简报

通过任务引导的 KV 缓存压缩,在可控运行时高效共享编排器与工作器之间的上下文状态。

★ 18k FS 55 谨慎使用 16 天前
开发与工程

上下文压缩策略

在长期代理会话中压缩上下文,同时保留文件变更、决策和后续行动。

★ 18k FS 50 谨慎使用 16 天前
开发与工程

上下文退化诊断

定位并缓解长上下文中的注意力丢失、污染、干扰、混淆与冲突。

★ 18k FS 51 谨慎使用 16 天前
开发与工程

推理轨迹优化器

通过分析智能体的推理轨迹,定位上下文、工具和指令问题,并迭代优化提示词。

★ 18k FS 38 不推荐 16 天前
开发与工程

自我改进循环

让智能体系统在受控评估中迭代自身的上下文、工作流与代码。

★ 18k FS 58 推荐 16 天前
开发与工程

多智能体架构模式

帮助你设计具备上下文隔离、协调协议和可靠交接机制的多智能体系统。

★ 18k FS 55 谨慎使用 16 天前
开发与工程

持久语义记忆架构

帮助智能体设计可扩展、可检索且能处理时间变化的持久记忆系统。

★ 18k FS 53 谨慎使用 16 天前
开发与工程

Agent 评估方法

为智能体流水线建立可重复的评估、回归检测与质量门禁。

★ 18k FS 46 谨慎使用 16 天前
开发与工程

文件系统上下文工程

将大型、持久或共享的代理上下文移入文件,按需检索以减少上下文压力。

★ 18k FS 45 不推荐 16 天前
开发与工程

上下文工程与智能体系统指南

帮助团队设计、优化和评估具备可靠上下文管理能力的生产级智能体系统。

★ 18k FS 44 不推荐 16 天前
开发与工程

Agent Skill 蓝图模板

为上下文工程技能提供可复用的结构、边界和质量检查框架。

★ 18k FS 40 不推荐 16 天前
开发与工程

长程智能体提示设计

为长期自主运行和并行多智能体任务设计可验证、抗近似交付的启动提示。

★ 18k FS 57 谨慎使用 16 天前
开发与工程

高级 LLM 评测

为 LLM 输出构建可审计、可校准并能缓解评测偏差的自动化评估流程。

★ 18k FS 56 谨慎使用 16 天前
开发与工程

智能体工具设计指南

帮助你设计清晰、可路由、可恢复的智能体工具接口。

★ 18k FS 51 谨慎使用 16 天前
开发与工程

项目级智能体开发方法论

帮助你判断是否该用大语言模型,并设计可迭代、可解析、可控成本的智能体项目流水线。

★ 18k FS 50 谨慎使用 16 天前
开发与工程

BDI 心智状态建模

把 RDF 上下文转化为可解释的信念、愿望与意图链。

★ 18k FS 49 谨慎使用 16 天前
开发与工程

自主智能体控制台

为自主智能体设计可控、可恢复、可审计的运行框架。

★ 18k FS 49 谨慎使用 16 天前
开发与工程

严谨研究代理

为多步骤研究建立验证、故障恢复与来源追踪流程。

★ 18k FS 45 不推荐 16 天前
效率与协作

数字大脑个人操作系统

用结构化文件和 AI 管理内容、关系、知识与目标。

★ 18k FS 38 不推荐 16 天前

相关 Skills