Agent Skills › JuliusBrussee/caveman › caveman-stats

caveman-stats

GitHub

提供跨平台(Claude Code/Gemini CLI)的会话统计功能,展示token用量、缓存读取及模式分布。严格禁止自行计算或推断节省费用,确保数据报告诚实准确。

plugins/caveman/skills/caveman-stats/SKILL.md JuliusBrussee/caveman

Trigger Scenarios

用户询问当前会话的token使用情况 用户请求查看性能或资源消耗统计 执行 /caveman-stats 命令

Install

npx skills add JuliusBrussee/caveman --skill caveman-stats -g -y
More Options

Non-standard path

npx skills add https://github.com/JuliusBrussee/caveman/tree/main/plugins/caveman/skills/caveman-stats -g -y

Use without installing

npx skills use JuliusBrussee/caveman@caveman-stats

指定 Agent (Claude Code)

npx skills add JuliusBrussee/caveman --skill caveman-stats -a claude-code -g -y

安装 repo 全部 skill

npx skills add JuliusBrussee/caveman --all -g -y

预览 repo 内 skill

npx skills add JuliusBrussee/caveman --list

SKILL.md

Frontmatter
{
    "name": "caveman-stats",
    "description": "Show recorded output and cache-read token usage and mode attribution for the current Claude Code session, or locate the host's native usage report. Trigger: \/caveman-stats."
}

In Claude Code, src/hooks/caveman-mode-tracker.js runs src/hooks/caveman-stats.js on /caveman-stats and supplies its report through hookSpecificOutput.additionalContext. Print that report verbatim inside a fenced code block, as the hook instructs. Do not calculate or add numbers yourself.

In Gemini CLI, direct the user to /stats model for current session token usage or /stats session for session statistics. Gemini custom commands are prompts; they cannot invoke the built-in command or read its live session metrics. Never read Claude Code transcripts as Gemini usage. In other hosts, use a native usage report if one is available; otherwise say that current session usage is unavailable. The Claude reader and its lifetime history apply only to Claude Code. Savings remain unknown in every host without a measured comparison.

The report shows recorded output and cache-read tokens, response counts, and mode attribution where available. Savings are unknown: the transcript has no measured comparison without Caveman. Do not infer saved tokens, percentages, dollars, rule overhead, or a net result from output counts or the current mode.

--all and --since 7d aggregate the latest recorded output count per session. --share reports observed usage with savings unknown. Historical est_saved_* fields are ignored; their original history rows remain on disk. The statusline shows the active mode without the retired savings badge.

Original/current memory-file pairs are reported by their measured byte sizes. Those file-size differences do not establish provider token or billing savings. See docs/HONEST-NUMBERS.md.

Version History

  • 2fd153c Current 2026-09-22 09:51

    移除了对规则开销(rule overhead)和净节省(net savings)的估算输出,不再显示 Est. rule overhead 和 Est. net 行,仅报告测量的字节大小和原始记录。

  • 12aa8cc 2026-08-16 08:53
  • 0d95a81 2026-07-24 17:37

Same Skill Collection

plugins/caveman/skills/cavecrew/SKILL.md
plugins/caveman/skills/caveman-compress/SKILL.md
plugins/caveman/skills/caveman/SKILL.md
skills/cavecrew/SKILL.md
skills/caveman-commit/SKILL.md
skills/caveman-compress/SKILL.md
skills/caveman-discover/SKILL.md
skills/caveman-evidence-review/SKILL.md
skills/caveman-explore/SKILL.md
skills/caveman-help/SKILL.md
skills/caveman-learn/SKILL.md
skills/caveman-manage/SKILL.md
skills/caveman-optimize/SKILL.md
skills/caveman-review/SKILL.md
skills/caveman-setup/SKILL.md
skills/caveman-stats/SKILL.md
skills/caveman/SKILL.md
skills/investigate-first/SKILL.md
skills/lean-build/SKILL.md
skills/migration/SKILL.md
skills/safe-refactor/SKILL.md
skills/surgical-patch/SKILL.md
skills/verify-and-stop/SKILL.md

Metadata

Files
0
Version
2fd153c
Hash
da58b00f
Indexed
2026-07-24 17:37

ホーム - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-29 04:11
浙ICP备14020137号-1