mcpField
C
context-engineering

context-engineering

github.com/mrgoonieAgent 工作流2.2k499 次安装30 周前更新
代码仓库

关于 context-engineering

context-engineering 是为 LLM 任务筛选高信号上下文的技能,面向 Agent 系统设计、调试与优化。它提供关于压缩、记忆、多 Agent 协作、工具设计和评估的参考指南及分析脚本。

主要功能

  1. 01筛选并压缩任务上下文
  2. 02规划跨会话记忆系统
  3. 03设计多 Agent 上下文隔离
  4. 04改进工具描述与组织
  5. 05分析上下文健康度和压缩质量

适用场景

  1. 01排查上下文限制导致的性能问题
  2. 02降低 LLM 工作流的成本或延迟
  3. 03设计多 Agent 协作与记忆机制
  4. 04评估上下文压缩对质量的影响

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mrgoonie/claudekit-skills --skill context-engineering

安装后在 Claude Code 中输入/context-engineering确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
context-compression.md
context-degradation.md
context-fundamentals.md
context-optimization.md
evaluation.md
memory-systems.md
multi-agent-patterns.md
project-development.md
tool-design.md
scripts/
compression_evaluator.py
context_analyzer.py
tests/
01-basic-context-optimization.md
02-debug-lost-in-middle.md
03-multi-agent-coordination.md
04-edge-case-context-poisoning.md
05-advanced-memory-architecture.md

详细介绍

上下文工程

上下文工程会为大模型任务筛选出信号最强、规模最小的词元集合。目标:在尽量减少词元用量的同时,最大限度提升推理质量。

何时启用

  • 设计/调试 Agent 系统
  • 上下文限制影响性能
  • 优化成本/延迟
  • 构建多 Agent 协作
  • 实现记忆系统
  • 评估 Agent 性能
  • 开发大模型驱动的管线

核心原则

  1. 上下文质量 > 数量 - 高信号词元胜过穷举内容
  2. 注意力有限 - U 形曲线表明,开头和结尾位置更有利
  3. 渐进式披露 - 按需及时加载信息
  4. 隔离可防止性能退化 - 在子 Agent 之间划分工作
  5. 先衡量,再优化 - 了解基准水平

快速参考

主题适用场景参考资料
基础知识了解上下文结构、注意力机制context-fundamentals.md
性能退化调试故障、信息遗失于中间位置、投毒context-degradation.md
优化压缩、屏蔽、缓存、划分context-optimization.md
压缩长会话、摘要策略context-compression.md
记忆跨会话持久化、知识图谱memory-systems.md
多 Agent协作模式、上下文隔离multi-agent-patterns.md
评估测试 Agent、LLM-as-Judge、指标evaluation.md
工具设计工具整合、描述设计tool-design.md
管线项目开发、批处理project-development.md

关键指标

  • 词元利用率:达到 70% 时发出警告,达到 80% 时触发优化
  • 词元变化:可解释 80% 的 Agent 性能差异
  • 多 Agent 成本:约为单 Agent 基准成本的 15 倍
  • 压缩目标:减少 50-70%,质量损失低于 5%
  • 缓存命中率目标:稳定工作负载下达到 70%+

四类策略

  1. 写入:在外部保存上下文(草稿区、文件)
  2. 筛选:仅提取相关上下文(检索、过滤)
  3. 压缩:在保留信息的同时减少词元(摘要)
  4. 隔离:在子 Agent 之间拆分(划分)

反模式

  • 使用穷举式上下文,而非精选上下文
  • 将关键信息放在中间位置
  • 达到限制前没有设置压缩触发条件
  • 可并行处理的任务却只用单个 Agent
  • 工具缺少清晰的描述

指南

  1. 将关键信息放在上下文的开头或结尾
  2. 在利用率达到 70-80% 时执行压缩
  3. 使用子 Agent 隔离上下文,而非角色扮演
  4. 使用四问框架设计工具(用途、时机、输入、返回值)
  5. 优化每项任务的词元数,而非每次请求的词元数
  6. 使用基于探测的评估进行验证
  7. 在生产环境中监控 KV-cache 命中率
  8. 从最简方案开始,仅在证明必要时增加复杂度

脚本

评论

支持 Markdown