关于 cost-compact-context
cost-compact-context 是调用 @claude-flow/integration 上下文压缩功能进行成本分析的技能。它报告检索到的记忆、桥接层提供的节省 Token 数、可用性和缓存命中率;agentic-flow 不可用时会回退并正常退出。
主要功能
- 01运行上下文压缩查询
- 02报告检索到的记忆
- 03显示桥接层报告的 Token 节省量
- 04报告包可用性和缓存命中率
- 05agentic-flow 缺失时正常退出
适用场景
- 01查看查询的上下文压缩结果
- 02检查检索记忆和 Token 估算
- 03确认 agentic-flow 是否可用
- 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 命令执行。
步骤
-
获取查询 — 唯一的参数。
-
调用 — 在
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。 -
报告 — 使用 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(验证结果)。