mcpField
C
cco-overhead

cco-overhead

github.com/egorfedorovAgent 工作流12570 次安装1 天前更新
代码仓库

关于 cco-overhead

cco-overhead 是面向使用 Claude Code 的项目会话开销审计 Skill，可测量初始上下文与提示缓存成本、拆分可测开销来源，并检查 MCP 服务的调用记录。

主要功能

  1. 01测量初始上下文大小
  2. 02估算每次会话缓存成本
  3. 03拆分上下文开销来源
  4. 04审计已跟踪的 MCP 工具调用
  5. 05为未使用服务报告移除命令

适用场景

  1. 01查找开始工作前的上下文开销
  2. 02比较不同会话的提示缓存成本
  3. 03检查 MCP 服务是否有调用记录

MCP 相关

该 Skill 根据 30 天的已跟踪工具调用审计 MCP 服务使用情况，并可报告从未调用服务的移除命令。它使用用户提供的服务名称和项目的 .mcp.json。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-overhead

安装后在 Claude Code 中输入/cco-overhead确认已加载。

详细介绍

会话基线开销审计

衡量本项目的每个会话在开始任何工作之前要付出多少 Token，以及有哪些可精简之处。

运行：

node ${CLAUDE_PLUGIN_ROOT}/src/overhead.js

报告会显示：

  1. 基线 — 首次助手响应时的准确上下文大小（根据会话记录中的 API 用量计数），包括最近会话的最新值和平均值，以及占工作预算的百分比。
  2. 每个会话的成本 — 每个会话将该基线写入提示词缓存的成本。
  3. 明细 — 可在本地衡量的部分（项目级和全局 CLAUDE.md、记忆索引、Agent 定义），以及无法归属的剩余部分（系统提示词、工具架构、MCP 服务）。
  4. 建议 — 精简哪些内容以及如何精简（例如，/cco-claudemd、停用未使用的 MCP 服务、精简 Agent 描述）。

然后运行 MCP 使用情况审计 — 它会将 30 天的工具调用记录转化为逐个服务的判断结果，并给出从未调用过的服务的确切移除命令：

node ${CLAUDE_PLUGIN_ROOT}/src/overhead.js mcp --servers <name1>,<name2>

请传入你自己的工具列表中的 MCP 服务名称（mcp__<server>__*，每个服务一项）。该脚本不会读取 ~/.claude.json — 此文件包含账户数据 — 因此它只知道你传入的服务以及项目的 ./.mcp.json。

只有当报告实际打印出 claude mcp remove ... 命令时，才向用户提出是否要运行这些命令（每次移除都能在未来的每个会话中持续节省开销；随时可以用 claude mcp add 恢复）。只有在用户同意后才能运行。

如果某个服务被列为 ? not observed，说明追踪器还没有 MCP 数据 — 这不是判断结果。绝不要建议移除这些服务，也绝不要自行构造报告未打印出的 claude mcp remove 命令。

将输出原样呈现给用户（输出已经排版好）。如果报告称未找到会话记录，请说明审计至少需要本项目的一个已完成交互会话。

向用户说明的核心要点：每个会话都要支付基线开销，因此一次性精简会在之后持续带来回报 — 这通常是能带来最大收益的优化。

评论

支持 Markdown