上下文预算守卫
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4b08597e/context-budget-guard。
技能介绍
要解决的问题
长任务的上下文溢出通常不是突然发生的,而是工具返回大段结果、子代理产出累积之后才被发现,等报错再处理往往已经晚了。另一种极端是对小任务也套用全套压缩策略,白白消耗 token 和注意力。这个技能把「要不要优化」从凭感觉变成有依据的判断。
核心机制:预算 + 层级
- 每个阶段设定 token 预算(例如 200k 窗口里的 80k),子代理还要单独设定
max_turns/model预算。 scripts/budget_check.py把当前估算用量映射到三个行动层级:GREEN、YELLOW、RED。- 层级决定调用
token-context-optimizer里的哪些技巧:充裕时轻量处理,接近上限时才激进压缩(子代理卸载、定期压缩、外化到记忆、丢弃过时信息、稳定前缀缓存)。
标准工作流
- 设定上限:选定阶段预算或子代理预算。
- 估算:对即将摄入的文件或结果运行
scripts/estimate_tokens.py,或直接budget_check.py --current <n> --limit <n>。 - 分类:脚本打印所属层级和推荐行动列表。
- 执行:只应用该层级对应的技巧,不过度压缩。
- 复查:大型操作之后再次检查,用量上升就提升层级。
使用边界
- 估算是启发式的(英文约 4 字符/token,中文约 1.6 字符/token),层级只能当参考。
- 图像等多模态内容远大于估算值,涉及时要么放宽预算,要么只按路径引用。
- 子代理预算与主上下文预算相互独立,两者都要设。
- 三条质量不变式:预算触发的是压缩而非省略决策相关信息;函数体、确切错误信息等编辑目标始终留在上下文里;小任务(GREEN)不产生任何优化开销。
使用场景
- 多步骤重构任务开始前:需要在 200k 窗口里规划 80k 预算,并用 budget_check.py 逐阶段追踪用量。
- 子代理协作时:需要为其单独设定 max_turns 和模型预算,防止子代理无限消耗主上下文。
- 工具返回大段 JSON 或文件内容时:需要先用 estimate_tokens.py 估算体积,再决定是否继续带入。
- 长对话中响应变慢时:需要先测量实际用量而非凭感觉猜测,判断是否触发 YELLOW 或 RED 压缩。
适合人员
- 使用 Claude Code 做多文件重构的开发者:需要避免长会话上下文溢出导致任务中断。
- 编排多步 Agent 工作流的技术工程师:需要在子代理和主上下文之间合理分配 token 预算。
- 处理大量工具返回数据的自动化脚本维护者:需要在工具结果进入上下文前检查其体积。
- 在有限窗口内运行长任务的 AI 应用开发者:需要精确控制上下文使用以最大化任务完成率。