SuperAPI AI 工具集

sw/analytics

数据与分析

查看项目

更新于 10-15 19:57

技能介绍

用途:sw/analytics 是 SpecWeave 的用量分析与指标技能,用于统计 SpecWeave 使用情况,包括 token 消耗、缓存效率和智能体(agent)启动次数。

主要能力:

  1. 缓存统计(--cache-stats):显示当前会话中各技能的提示缓存命中率,输出包含每个技能的命中率与来自缓存的 token 数,以及整体命中率。
  2. 启动计数(--spawn-count):报告每个团队会话的智能体启动次数,可用于验证 Opus 4.7 的扇出削减是否生效(目标为不高于 1.1.0 之前基线的 50%)。
  3. Token 用量(--token-usage):报告会话中各技能的总 token 消耗。

使用方式:命令为 sw:analytics [--cache-stats] [--spawn-count] [--token-usage]。该技能通过读取指标快照、增量历史与配置来计算分析结果,并通过 Bash 运行 specweave metrics CLI 命令采集实时遥测数据。

限制与要求:使用 --cache-stats 需启用缓存(配置中 cache.staticContextFiles 非空),且每个技能至少调用 2 次才能得到有意义的命中率;如需持久化指标,需在 .specweave/config.json 中设置 analytics.cacheMetrics.enabled: true。其他参数的具体限制资料未提供。