caveman
专为Claude Code等AI编码助手设计的技能插件,通过让agent用极简原始人风格说话,平均减少65%的输出token,大幅降低API成本。亮点:无需改模型,仅靠提示优化即可实现token节省,支持lite/full/ultra/wenyan等多级压缩,兼顾技术准确性。
README
caveman
少言即可,何须多词
Before/After • 安装 • 功能一览 • 基准测试 • 完整安装指南
一个 Claude Code 技能/插件(同样适用于 Codex、Gemini、Cursor、Windsurf、Cline、Copilot 及 30+ 其他智能体),让 agent 像原始人一样说话——削减 ~75% 的输出 token,同时保持完整的技术准确性。脑子还是那么大,嘴巴变小了。
Before / After
🗣️ 普通 Claude(69 tokens)
|
|
🗣️ 普通 Claude
|
|
同样修复。少 75% 的词。脑子还是那么大。
┌─────────────────────────────────────┐
│ 节省 Token ████████ 75% │
│ 技术准确性 ████████ 100% │
│ 速度提升 ████████ ~3x │
│ 氛围 ████████ 很行 │
└─────────────────────────────────────┘
选择你的咕噜级别——lite(去掉废话)、full(默认原始人)、ultra(电报风格)或 wenyan(文言文,甚至更短)。一条命令切换。成本永久下降。
使用你的语言。 原始人保留你的语言。你写葡萄牙语,原始人就咕噜葡萄牙语。西班牙语、法语亦然。压缩的是风格,不是语言。代码、命令、错误字符串保持原样。
"Novo ref de objeto cada render. Prop inline = novo ref = re-render. Envolva com
useMemo."
|
安装
一行命令。适配每个 agent。为每个安装。
# macOS / Linux / WSL / Git Bash
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash
# Windows(PowerShell 5.1+)
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex
约 30 秒。需要 Node ≥18。跳过你没有的 agent。重新运行安全。
触发: 输入 /caveman 或说"像原始人一样说话"。用"正常模式"停止。
仅限一个 agent、手动命令、或任意 30+ 其他 agent → INSTALL.md。 安装失败?打开 agent,说 "阅读 CLAUDE.md 和 INSTALL.md,为我安装 caveman。" Agent 修复自己的脑子。
功能一览
| 技能 | 功能 |
|---|---|
/caveman [lite|full|ultra|wenyan] |
压缩每次回复。级别在会话结束前持续生效。 |
/caveman-commit |
约定式提交消息,主题 ≤50 字符。强调为什么而不是什么。 |
/caveman-review |
单行 PR 评论:L42: 🔴 bug: user null. Add guard. |
/caveman-stats |
真实会话 token 用量 + 终身节省 + 美元。通过 --share 生成可推文行。 |
/caveman-compress <file> |
重写记忆文件(例如 CLAUDE.md)为原始人语言。每次会话减少约 46% 的输入 token。代码/URL/路径保持字节不变。 |
caveman-shrink |
MCP 中间件。包装任何 MCP 服务器,压缩工具描述。npm。 |
cavecrew-* |
原始人子 agent(调查者/构建者/审查者)。比普通版本少约 60% token,主上下文更持久。 |
状态行徽章 —— Claude Code 显示 [CAVEMAN] ⛏ 12.4k(终身节省 token)。每次运行 /caveman-stats 时更新。设置 CAVEMAN_STATUSLINE_SAVINGS=0 可关闭。
每次会话自动激活:Claude Code、Codex、Gemini(内置)。Cursor / Windsurf / Cline / Copilot 通过 --with-init 获得始终开启的规则文件。其他 agent 每个会话输入 /caveman 触发。完整功能矩阵见 INSTALL.md。
基准测试
来自 Claude API 的真实 token 计数。10 个提示平均减少 65% 输出(范围 22-87%)。
| 任务 | 普通 | 原始人 | 节省 |
|---|---|---|---|
| 解释 React 重新渲染 bug | 1180 | 159 | 87% |
| 修复认证中间件 token 过期 | 704 | 121 | 83% |
| 设置 PostgreSQL 连接池 | 2347 | 380 | 84% |
| 解释 git rebase 与 merge | 702 | 292 | 58% |
| 重构 callback 为 async/await | 387 | 301 | 22% |
| 架构:微服务 vs 单体 | 446 | 310 | 30% |
| 审查 PR 的安全问题 | 678 | 398 | 41% |
| Docker 多阶段构建 | 1042 | 290 | 72% |
| 调试 PostgreSQL 竞态条件 | 1200 | 232 | 81% |
| 实现 React 错误边界 | 3454 | 456 | 87% |
| 平均 | 1214 | 294 | 65% |
原始数据和复现脚本:benchmarks/。三臂评估框架(基线/简洁/技能)位于evals/ —— 原始人对比的是"简洁回答",而不是默认冗长的回答,因此差异是真实的。
caveman-compress 记录(真实记忆文件):
| 文件 | 原始 | 压缩后 | 节省 |
|---|---|---|---|
claude-md-preferences.md |
706 | 285 | 59.6% |
project-notes.md |
1145 | 535 | 53.3% |
claude-md-project.md |
1122 | 636 | 43.3% |
todo-list.md |
627 | 388 | 38.1% |
mixed-with-code.md |
888 | 560 | 36.9% |
| 平均 | 898 | 481 | 46% |
[!IMPORTANT] 原始人仅影响输出 token —— 思考/推理 token 不受影响。原始人不会让脑子变小,只会让嘴巴变小。最大的好处是可读性和速度,成本节省是额外奖励。
2026 年 3 月的一篇论文 "Brevity Constraints Reverse Performance Hierarchies in Language Models" 发现,限制大型模型简略回答可在某些基准测试上将准确率提高 26 个百分点。冗长不一定更好。有时少说反而更正确。
工作原理
- 安装将技能文件放入 agent。
- 技能告诉 agent:去掉废话,保留实质,使用片段。
- 对于 Claude Code,钩子还会在每次会话写入一个小标志文件 —— agent 看到标志,从第一条消息起就以原始人方式说话。无需输入
/caveman。 - Stats 命令读取 Claude Code 会话日志,计算节省的 token 数量,写入状态行。
- Caveman-compress 子技能重写记忆文件(CLAUDE.md、项目笔记),使每次会话从更小的上下文开始。永久节省 token,而不仅限于一次回复。
维护者细节(钩子架构、文件所有权、CI 同步)见 CLAUDE.md。
龙虾,遇见岩石 🦞 
OpenClaw 是自托管网关。一个盒子,多个 agent 在里面(Claude Code、Codex、Pi、OpenCode),连接到你的 Slack / Discord / iMessage / Telegram / 其他。标语:"龙虾之道"。龙虾强壮。龙虾聪明。龙虾话也很多。
原始人教会龙虾简洁 —— 使用相同的规范安装程序,限定于一个 agent:
# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --only openclaw
# Windows(PowerShell):没有 Node?先安装 Node ≥18,然后
npx -y github:JuliusBrussee/caveman -- --only openclaw
只发生两件事,不多不少:
- 技能放置在
~/.openclaw/workspace/skills/caveman/SKILL.md—— 符合规范的 frontmatter(version、always: true),可通过openclaw skills list发现。技能不会自动注入(OpenClaw 按需加载技能)—— 所以我们还有第 2 步。 - SOUL.md 提示。 在
~/.openclaw/workspace/SOUL.md末尾追加一个小的标记围栏块。OpenClaw 会在"项目上下文"中将 SOUL.md 注入每一轮(每个文件 12K,总计 60K —— 该块远低于限制)。龙虾从第一条消息起就简洁。无需每个会话输入/caveman。无需叨扰。
~/.openclaw/workspace/
├── skills/caveman/SKILL.md ← 完整规则集,按需加载
└── SOUL.md ← <!-- caveman-begin --> ... <!-- caveman-end -->
↑ 每轮自动注入
自定义工作区路径?在命令前设置 OPENCLAW_WORKSPACE=/your/path。卸载:同样的一行命令加 --uninstall —— 技能文件夹消失,SOUL.md 块被干净地移除,你的其他工作区内容保持不变。幂等重新运行(frontmatter 不重复附加,标记块不重复)。
龙虾钳依然锋利。龙虾嘴巴现在变小了。脑子还是那么大。
原始人生态系统
五个工具。同一个理念:agent 用更少做更多。
| 仓库 | 说明 |
|---|---|
| caveman (你在这里) | 输出压缩 —— 何须多词,几词即可 |
| caveman-code | 完整终端编码 agent —— 当整个 agent 都能节省时,何必用很多 token |
| cavemem | 跨 agent 记忆 —— 当 agent 能记住时,何必忘记 |
| cavekit | 规范驱动的构建循环 —— 当 agent 能知道时,何必猜测 |
| cavegemma | Gemma 4 31B 在原始人语料对上的微调 —— 当权重能记住时,何必每轮提示 |
组合:cavekit 驱动构建,caveman 压缩 agent说什么,cavemem 压缩 agent记住什么,cavegemma 将压缩烘焙进权重,caveman-code 将这一切打包为一个终端 agent。一块石头。两块石头。三块石头。四块石头。五块石头。就这些。
来自同一洞穴的更多技能
原始人有兄弟姐妹。JuliusBrussee/skills —— 五个技能,一次安装,适用于 Claude Code、Cursor、Gemini、Cline、Copilot 及 40+ 种 agent:
| 技能 | 说明 |
|---|---|
| caveman | 就这个。少说话,多表达。 |
| grill-me | Agent 在你构建错误的东西之前拷问你的计划。首先检查你了解多少 —— 不摆架子,不哄着。 |
| interface-kit | 构建好看、加载快、人人适用的 UI。 |
| junior-to-senior | 对抗式审查流程。输入初级代码,输出高级代码。 |
| loop-factory | 规范驱动的任务循环 —— 收件箱 → 处理中 → 归档,中间有审查门。 |
npx skills@latest add JuliusBrussee/skills
一条命令。五个技能。洞穴存货丰富。
链接
- INSTALL.md —— 完整安装矩阵,所有标志,每个 agent 细节
- CONTRIBUTING.md —— 如何提交补丁
- CLAUDE.md —— 维护者指南(文件所有权、钩子架构、CI)
- docs/ —— 额外指南(Windows 安装等)
- Issues —— 错误、功能、奇怪行为
给这个仓库加星
原始人帮你节省 token,节省钱。加星免费。公平交易。⭐
Julius Brussee 的其他作品
- Revu —— 本地优先的 macOS 学习应用,采用 FSRS 间隔重复。revu.cards
赞助者
原始人永久免费。赞助让石头保持锋利。
Atlas Cloud —— 全模态 AI 推理平台,一个 API。
想让你的石头也在这里?赞助原始人。
许可证
MIT —— 自由如开阔平原上的猛犸象。