mcpField
C
cost-compact-context

cost-compact-context

github.com/ruvnetAgent 工作流80.0k726 次安装今天更新
代码仓库

关于 cost-compact-context

cost-compact-context 是调用 @claude-flow/integration 上下文压缩功能进行成本分析的技能。它报告检索到的记忆、桥接层提供的节省 Token 数、可用性和缓存命中率;agentic-flow 不可用时会回退并正常退出。

主要功能

  1. 01运行上下文压缩查询
  2. 02报告检索到的记忆
  3. 03显示桥接层报告的 Token 节省量
  4. 04报告包可用性和缓存命中率
  5. 05agentic-flow 缺失时正常退出

适用场景

  1. 01查看查询的上下文压缩结果
  2. 02检查检索记忆和 Token 估算
  3. 03确认 agentic-flow 是否可用
  4. 04查看缓存命中率

安装

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

$npx skills add https://github.com/ruvnet/ruflo --skill cost-compact-context

安装后在 Claude Code 中输入/cost-compact-context确认已加载。

详细介绍

Cost Compact Context

针对成本分析查询,封装了 @claude-flow/integration 中的 getTokenOptimizer().getCompactContext()。桥接层会动态导入 agentic-flow,并提供优雅的回退:未安装该软件包时,tokensSaved 为 0,且技能会正常退出。目前没有 MCP 工具封装 getTokenOptimizer(ADR-0002 §"Riskiest assumption");我们改用一行 Node 命令执行。

步骤

  1. 获取查询 — 唯一的参数。

  2. 调用 — 在 v3/ 下的任意位置运行,以便解析 @claude-flow/integration:

    ( cd v3 && node ../plugins/ruflo-cost-tracker/scripts/compact.mjs "<QUERY>" )
    

    脚本会导入 @claude-flow/integration/token-optimizer(规范导出 — 而非 dist/token-optimizer.js,否则 Node 的 ./* 导出规则会导致 .js 扩展名重复),调用 getCompactContext(query),并通过 COMPACT_QUIET=1 输出 Markdown 摘要和一行 JSON。

  3. 报告 — 使用 Markdown 表格列出:检索到的记忆、节省的 token(桥接层报告)、agentic-flow 是否可用、缓存命中率。脚本还会输出免责声明:“由桥接层报告,未与无 RAG 基准进行测量”。桥接层不可用时:输出“未安装 agentic-flow — 桥接层返回空结果。”并正常退出。

注意事项 — 上游声称,尚未验证

根目录的 CLAUDE.md 声称 ReasoningBank retrieval: -32% tokens。桥接层的 tokensSaved 是 query_tokens − compact_prompt_tokens(token-optimizer.ts:141–143)——这是一种启发式估算,并非通过基准测量得出的节省量。token-optimizer.ts:9–10 自身写道:"No fabricated metrics are reported — all stats reflect real measurements"。此技能沿用该免责声明。

没有公开用于检查 Booster 是否可用的 getter — 只能通过 optimizedEdit() 返回 method: 'agent-booster' 来观察。规范的 Tier 1 信号是 [AGENT_BOOSTER_AVAILABLE](参见 cost-booster-route)。

回退

未安装 agentic-flow → getCompactContext 返回 {tokensSaved: 0, memories: []}(第 116–124 行),optimizedEdit 返回 {method: 'traditional'},getOptimalConfig 回退到 anti-drift 默认值。技能会显示“不可用”消息并正常退出。

交叉引用

ADR-0002 Decision #2 + §"Riskiest assumption" · token-optimizer.ts:308(单例导出)· docs/benchmarks/0002-baseline.md(验证结果)。

评论

支持 Markdown