🎯 Context Budget Guard

防止AI Agent会话被强制压缩而丢失关键上下文。零依赖，纯markdown skill。

---

🚨 问题

你正在开发一个功能，突然会话被强制压缩：

消息80: "继续实现认证模块..."
系统: "上下文超限，正在压缩..."
消息81: "认证模块是什么？我需要重新了解需求..."

结果：

• ❌ 忘记正在编辑哪些文件
• ❌ 丢失任务进度和关键决策
• ❌ 浪费tokens重新解释需求
• ❌ 工作中断，效率降低

---

✅ 解决方案

Context Budget Guard 在关键预算点主动预警，帮你管理上下文：

┌─────────────────────────────────────────────────┐
│  ⚠️ CONTEXT WARNING: 72% used (72K/100K)       │
│                                                 │
│  建议: 保存关键决策，准备主动压缩               │
│  输入 /context-budget preserve 保存重要项       │
└─────────────────────────────────────────────────┘

---

🚀 快速开始

1. 安装

# 克隆或下载
git clone https://github.com/YOUR_USERNAME/skill-context-budget.git

# 复制到你的skill目录
cp -r skill-context-budget ~/.claude/skills/

2. 设置预算

在会话开始时：

/context-budget set 100K

3. 检查状态

/context-budget status

输出：

📊 Context Budget: 67K/100K (67%) - ✅ HEALTHY

Preserved:
  • Task: implement-auth
  • Decisions: 3
  • Files: 2 pending changes

---

📋 预算建议

场景	推荐预算
快速问答	30K
代码审查	60K
功能开发	100K
大型重构	120K
调试会话	150K

---

🔧 配置

{
  "context_budget": {
    "total": 100000,
    "warning_threshold": 0.70,
    "critical_threshold": 0.90,
    "preserve_patterns": [
      "CURRENT_TASK",
      "KEY_DECISIONS",
      "FILE_CHANGES",
      "ERROR_CONTEXT"
    ]
  }
}

---

💡 为什么用这个？

	Context Budget Guard	context-mode	被动压缩
依赖	✅ 无	❌ Node.js + MCP	✅ 无
主动预警	✅ 有	❌ 无	❌ 无
保护关键上下文	✅ 有	❌ 无	❌ 无
安装复杂度	复制文件	npm install	无

---

🎯 使用场景

• 长时间开发会话 - 保持任务连续性
• 复杂重构 - 需要记住大量变更
• 调试问题 - 保持错误上下文完整
• 代码审查 - 保持审阅进度

---

📄 License

MIT - 使用、修改、分发。

---

主动管理上下文，告别被动压缩。