context-budget-auditlisted

## 何时使用 适用： - 会话明显变慢、输出质量下滑，怀疑是上下文被静态组件吃满 - 刚一次性加了很多技能 / Agent / MCP 服务器后做一次体检 - 想知道当前配置还剩多少上下文余量（headroom） - 计划再加组件前，先评估「装得下吗」 - 用户说「上下文预算」「token 占用太高」「帮我瘦身配置」「MCP 是不是太多了」，或触发 `/context-budget` 不该用（负边界）： - 不是用来压缩**单次任务的对话历史**（那是运行期 compaction，另寻方法） - 不做精确逐 token 计费——这里只给**估算**，用于排序决策而非账单 - 缺少可扫描的配置目录（agents/skills/rules/.mcp.json/CLAUDE.md）时，先确认路径再审计 核心洞见：Agent / 技能 / 规则 / MCP 的开销是**每次会话恒定加载**的静态成本，砍掉冗余组件能直接换回上下文空间。 ## 步骤 四阶段流程。token 估算口径：散文用 `单词数 × 1.3`，代码密集文件用 `字符数 / 4`。 **阶段 1 · 盘点（Inventory）** — 扫描各组件目录，估算 token： | 组件 | 路径 | 计量 | 告警阈值 | |---|---|---|---| | Agent | `agents/*.md` | 逐文件行数/token；抽取 `description` frontmatter 长度 | 文件 >200 行（过重）；description >30 词（frontmatter 臃肿） | | 技能 | `skills/*/SKILL.md` | 逐 SKILL.md token；查 `.agents/skills/` 的重复副本，**同名同内容只算一次** | 文件 >400 行 | | 规则 | `rules/**/*.md` | 逐文件 token；检测同语言模块内规则间内容重叠 | 文件 >100 行 | | MCP | `.mcp.json` / 活跃 MCP 配置 | 服务器数 + 工具总数；每工具 schema ≈ **500 token** | 单服务器 >20 工具；包装 `gh`/`git`/`npm`/`supabase`/`vercel` 等简单 CLI 的服务器 | | CLAUDE.md | 项目级 + 用户级 | CLAUDE.md 链逐文件 token | 合计 >300 行 | **阶段 2 · 分类（Classify）** — 每个组件归一个桶： | 桶 | 判据 | 动作 | |---|---|---| | 总是需要 | 被 CLAUDE.md 引用 / 支撑活跃命令 / 匹配当前项目类型 | 保留 | | 偶尔需要 | 领域专用（如某语言模式），CLAUDE.md 未引用 | 改成按需激活 | | 几乎不需要 | 无命令引用、内容重复、与项目无明显匹配 | 删除或延迟加载 | **阶段 3 · 问题检测（Detect）** — 标记以下臃肿模式： - **Agent description 臃肿**：frontmatter 中 >30 词的 description 会在**每次 Task 工具调用**时加载 - **过重 Agent**：>200 行的文件在每次 spawn 时撑大 Task 上下文 - **冗余组件**：复刻 Agent 逻辑的技能、复刻 CLAUDE.md 的规则 - **MCP 过度订阅**：>10 个