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

context-budget 上下文预算

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

Why / 为什么

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

The three habits / 三个习惯

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

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

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

Install / 安装

npx skills add ChenneyZhuang/context-budget

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