橙研所

context-engineering-kit

用一张 CONTEXT.md,把进入上下文窗口的每样东西按七层管理起来——每层带预算和缓存策略。

实验室 · 已开源约 1 分钟

模型表现差,很多时候不是 prompt 不够好,是这一轮喂进窗口的东西不对:塞太多被噪声淹没、塞太少缺关键事实、塞错了误导、没结构无法缓存、不可控每次都飘。context-engineering-kit 用一张 CONTEXT.md,把单次窗口里装了什么这件事,从隐式变成可审计、可复现的工程。

它解决什么

进入上下文窗口的内容失控时,会以五种方式失败:

失败模式后果
塞太多context rot,关键信息被噪声淹没
塞太少缺关键事实,模型靠猜
塞错了不相关内容误导判断
没结构无法分层缓存,成本与延迟双高
不可控每轮内容飘,行为不可复现

核心机制:七层模型

CONTEXT.md 把进入窗口的东西按「稳定 → 易变」分七层,每层带 token 预算 + 缓存策略:

内容缓存
L1 系统指令角色/规则静态缓存
L2 领域知识业务背景静态缓存
L3 工具定义可调工具静态缓存
L4 记忆长期教训静态缓存
L5 检索内容RAG 召回每轮重建
L6 对话历史多轮上下文每轮重建
L7 当前输入本轮请求每轮重建

L1-L4 稳定可缓存、L5-L7 每轮重建——稳定与易变分离,是缓存能生效的前提。

辨析(这套模型的核心卖点):Prompt Engineering 是 CE 的 L1 子集,RAG 是 CE 的 L5 一层,Harness 管的是项目骨架、CE 管的是单次窗口构成。三者不是竞品,是不同尺度。

四条设计原则:显式优于隐式 / 稳定易变分离 / 可审计 / 可复现。三条反模式:全塞(context rot)、稳定易变混放(缓存全失效)、检索不排序(噪声污染)。

怎么用

git clone 后照 CONTEXT.md 模板,把你的 Agent 这一轮要进窗口的内容逐层填进去,标好每层预算与缓存策略。它既是配置,也是这次窗口装了什么的可审计快照。

一句话

把「这次到底喂了模型什么」从你脑子里搬到一张能 review、能复现的表里。