Caveman 是什么:让编程 Agent 少说少读的省 token 套件

Caveman 是 JuliusBrussee 开源的省 token 套件:最早只是一个让编程 Agent「像穴居人一样说话」的 Skill,4.0 起拆成六个模块,还管 Agent 读进去的日志、JSON 和网页。截至 2026-11-07(北京时间),GitHub 118,049 星,Apache-2.0;skills.sh 整包 25 个 Skill、约 470 万次累计安装;今天 11:39 刚发了运行时二进制 bin-v4.1.0。
它是什么
Caveman 的出发点:Agent 回答里大量 token 花在寒暄、复述和「让我来」上。Skill 版只做一件事——规定回答先给结论、一句一个意思、代码和报错原样保留。README 里的例子是同一个 React 重渲染问题,正常回答 63 个 token,caveman 版 20 个。
| 仓库 | github.com/JuliusBrussee/caveman |
|---|---|
| 作者 | Julius Brussee |
| 许可证 | Apache-2.0(整仓;「Caveman」名称和石头 logo 是作者商标) |
| 热度 | GitHub 118,049 星(GitHub API,2026-11-07 约 15:08 北京时间);skills.sh 包页 25 个 Skill、合计 4.7M 次安装,其中 caveman 614.7K(同日抓取);npm @caveman-ai/cli 2026-10-30 至 11-05 下载 25,116 次 |
| 运行要求 | Skill 版任何支持 Agent Skills 的宿主即可;CLI/代理需 Node.js 22.13+,支持 macOS、Linux、Windows |
| 版本 | 主版本 v4.0.1(GitHub Release 2026-10-14 02:34 北京时间,npm 同为 4.0.1);运行时二进制 bin-v4.1.0(2026-11-07 11:39 北京时间) |
解决什么问题
按 README,4.0 起 Caveman 拆成六块「石头」,装完默认全开,每块可单独关:
| 模块 | 干什么 | 官方数字 |
|---|---|---|
| Say less | 回答变短,代码原样 | 63 → 20 token(单例) |
| Read less | 日志、JSON、CSV、测试输出先压再给模型 | 整段会话输入少 33.2% |
| Auto | 每次提问自动选模型和推理档位,需免费账号 | 85 道题成本为 Opus 5.5 xhigh 的 0.46 倍(跑完一半的中期结果) |
| Blocks | Agent 反复手写的脚本存进仓库复用 | 一次 go test 回读 397 → 76 token |
| Waste fixes | 找 token 花在哪,暂停时给 Anthropic 提示缓存保温 | 作者标注尚未测量 |
| Browse | 网页压缩后再给 Agent | 200 行表格页 15,704 → 121 token |
Read less 那组数据作者写得很老实:CSV、日志、YAML 压得最狠,整段会话省 46%–55%;HTML 还没有压缩器,会话反而多花 9.9%;会话测试用的是 2026 年 8 月的旧引擎。站内写过的 Headroom 也是压输入的路子,README 里给了同一套题的对照:Headroom 18 题对 15、token 少 6.7%,Caveman 18 题全对。这组对比由 Caveman 自己跑,不是第三方结果。
只装 Skill,省的是输出;账单大头是输入和缓存重读,这部分得靠代理。
怎么用
# 只要回答变短(不装代理)
npx skills add JuliusBrussee/caveman -g
# 在 Agent 里:/caveman /ultracave /megacave(文言文)
# 说 "stop caveman" 回到正常
# Claude Code 插件
claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman
# 全家桶:本地代理 + 六个模块
npx @caveman-ai/cli@latest
caveman status # 看哪些模块开着
caveman off browse # 单独关一个
caveman shrink -- pnpm test # 压缩嘈杂的命令输出
caveman trial -- claude # 拿自己的任务做 A/B
caveman telemetry off # 关闭 CLI 使用统计
Agent 里还能直接用 /caveman-commit(一行 Conventional Commit)、/caveman-review(一行一个问题)、/caveman-compress <文件>(压缩 CLAUDE.md 这类记忆文件并留备份)、/caveman-stats(看本次会话真实 token)。另有 lean-build、surgical-patch、safe-refactor、verify-and-stop 等少写代码的工作模式 Skill,任务对得上时宿主会自己加载。
上手前看清的几件事
- 别指望 Skill 版大幅省钱:HONEST-NUMBERS 的数字是 claude-opus-5-5 上 10 道题、单次运行,基于 3.1.0 规则,之后没重跑;规则本身约占 1,160 个输入 token,短问答场景可能净亏。
- 数据去向:Skill 本身不发任何数据,唯一例外是
/caveman-compress会把文件发给你配置的模型服务商。CLI 默认上报命令、token 数、随机安装 ID、系统和 IP,不含提示词与代码;caveman telemetry off或DO_NOT_TRACK=1永久关闭。 - Auto 要登录:开 Auto 后,每次提问会把最新问题(连同 Agent 附带的 CLAUDE.md、记忆文件)发到 Caveman Cloud,免费档可能被留作改进路由;
caveman off routing关掉。 - 旧版残留:4.0 之前装过的要带
@latest,不然本机旧副本优先。 - Blocks 仍是预发布(v0.1.0-rc.5),只支持 Python,暂无沙箱。
适合谁,不适合谁
适合:按 token 付费、长时间跑 Claude Code / Codex / OpenCode 的人,尤其是会话里塞满测试输出和日志的;嫌 Agent 啰嗦、想要终端里一眼看完的回答的。
不适合:用 GitHub Copilot 这类按请求计费的宿主;主要读 HTML 页面的工作流;不愿让任何请求经过第三方云的团队(那就只装 Skill,别开 Auto)。只想压输入、不想改回答风格,可以对比站内 Headroom 再选。
最后
先只装 Skill,用 caveman trial -- claude 或自己在服务商账单上对同一任务做一次有无对比;省下来了再上代理,省不下来就按作者自己的建议关掉。