上下文预算管理 ChenneyZhuang/context-budget

context-budget 上下文预算

长任务不是败在开头，是败在 80%——窗口里塞满重读的文件，计划躺在回滚的聊天里。把上下文窗口当预算管。

Why / 为什么

智能体的工作记忆就是上下文窗口，长任务死法有两种：重读（同一份 5000 行文件读了三遍，因为什么都没记）和重推导（三轮前定过的决策重新算一遍）。这都是预算失败：token 花了一次，没买到任何耐用的东西。解法是机械的——分层读取、落盘记笔记、检查点复述。

The three habits / 三个习惯

1. 分层读取。 先读头部（前 ~100 行，摸清结构），再读具体章节，最后定向搜索。完整读取是一次刻意的购买，只有头部读取证明中间部分确实重要时才做。
2. 笔记胜过记忆。 事实、决策、文件路径、坑点，一旦确立就写进工作笔记文件——每条一行。笔记文件能扛过压缩，对话扛不过。
3. 检查点复述。 在阶段边界（长构建之前、重大发现之后），用三行复述计划和当前状态。这是任务中途窗口被压缩时还能活下来的锚点。

What it changes at 80% / 80% 处的差异

没有预算：重读、推翻自己三轮前的决定、最后三分之一靠残血硬撑。有预算：计划只有三行，每个已确立的事实都在笔记文件里，最后一程是读两个小文件，而不是回忆十个。

Honest limitations / 如实说明局限

- 笔记文件有小额写入开销；十步以内的短任务，预算机制得不偿失。
- 压缩行为因运行时而异；检查点到处有益，但确切保证取决于运行时。

Install / 安装

npx skills add ChenneyZhuang/context-budget

各智能体安装路径见 COMPATIBILITY.md。MIT 许可，v0.1.0。