GitHub - JuliusBrussee/caveman: [特殊字符] 少用词何必多用词——像穴居人说话,削减65%token的Claude Code技能
caveman
为何用多词,少词已够用
使用前/后 • 安装 • 功能介绍 • 基准测试 • 完整安装指南
一款 Claude Code 技能/插件(同样支持 Codex、Gemini、Cursor、Windsurf、Cline、Copilot 等 30+ 款工具),让 Agent 像原始人一样说话——削减 约 75% 的输出 token,同时保持完整的技术准确性。大脑依然强大,嘴巴变得精简。
使用前 / 使用后
| ### 🗣️ 普通 Claude(69 个 token) "你的 React 组件反复重渲染的原因,很可能是你在每次渲染周期中都创建了新的对象引用。当你将内联对象作为 prop 传入时,React 的浅比较每次都会将其视为不同的对象,从而触发重渲染。建议使用 useMemo 来对该对象进行缓存。" | ### 穴居人 Claude(19 个 token) "每次渲染新对象引用。内联对象 prop = 新引用 = 重渲染。用 useMemo 包裹。" |
| ### 🗣️ 普通 Claude "当然!很乐意帮你解决这个问题。你遇到的这个问题,很可能是由于你的认证中间件没有正确校验 token 过期时间所导致的。让我看一看,并给出修复建议。" | ### 穴居人 Claude "auth 中间件有 Bug。token 过期检查用 ` |
同样的修复。少了 75% 的废话。大脑依然强大。
┌─────────────────────────────────────┐ │ TOKENS SAVED ████████ 75% │ │ TECHNICAL ACCURACY ████████ 100%│ │ SPEED INCREASE ████████ ~3x │ │ VIBES ████████ OOG │ └─────────────────────────────────────┘
选择你的咕哝等级——lite(去掉废话)、full(默认穴居人风格)、ultra(电报体)或 wenyan(文言文,更精简)。一条命令即可切换。成本永久降低。
说你自己的语言。 穴居人保留你的语言。你用葡萄牙语写,穴居人就用葡萄牙语咕哝。西班牙语、法语,同理。压缩的是风格,不是语言。代码、命令、错误字符串原样保留。
"Novo ref de objeto cada render. Prop inline = novo ref = re-render. Envolva com
useMemo."
| ### 喜欢这个技巧?现在来体验完整 Agent——caveman-code 这个技能只压缩 Agent 说的话。caveman-code 压缩一切——完整的终端编码 Agent,从头到尾都是穴居人风格。相同任务下比 Codex 少用约 2× 的 token。支持 20+ 个 provider · 计划模式 · 自动驾驶目标循环 · MIT 协议。npm install -g @juliusbrussee/caveman-code ▶ 立即体验 caveman-code → — 为何用多 token,当整个 Agent 都能节省 |
安装
一行命令。自动找到所有 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 或说"talk like caveman"。说"normal mode"恢复正常。
仅安装单个 Agent、手动命令,或 30+ 款其他 Agent → INSTALL.md。安装出问题?打开 Agent,说 "Read CLAUDE.md and INSTALL.md, install caveman for me." Agent 会自行修复。
功能介绍
| 技能 | 说明 |
| /caveman [lite\|full\|ultra\|wenyan] | 压缩每一条回复。等级在会话结束前持续生效。 |
| /caveman-commit | 规范的 Conventional Commit 消息,主题行 ≤50 字符。说明为何,而非说明做了什么。 |
| /caveman-review | 单行 PR 评论:L42: 🔴 bug: user null. Add guard. |
| /caveman-stats | 实时会话 token 使用量 + 累计节省量 + 美元金额。可通过 --share 生成一行可发推的摘要。 |
| /caveman-compress | 将记忆文件(如 CLAUDE.md)重写为穴居人风格。每次会话减少约 46% 的输入 token。代码/URL/路径字节级保留。 |
| caveman-shrink | MCP 中间件。包装任意 MCP server,压缩工具描述。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% |
| 修复 auth 中间件 token 过期问题 | 704 | 121 | 83% |
| 配置 PostgreSQL 连接池 | 2347 | 380 | 84% |
| 解释 git rebase 与 merge 的区别 | 702 | 292 | 58% |
| 将回调重构为 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 与 Answer concisely. 对比,而非与默认冗长输出对比,因此差值是真实可信的。
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
Caveman 仅影响输出 token——思考/推理 token 不受影响。Caveman 不让大脑变小。Caveman 让嘴巴变小。最大的收益在于可读性和速度,节省成本只是额外的收获。
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 / 任意平台。口号:"龙虾之道。" 龙虾强大。龙虾聪明。龙虾也话太多。
Caveman 教龙虾言简意赅——使用同一标准安装器,作用域限定为单个 Agent:
# macOS / Linux / WSL curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --only openclaw # Windows (PowerShell): no Node? install Node ≥18 first, then 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 注入到"Project Context"下(每文件 12K,总计 60K——该块远低于上限)。龙虾从第一条消息起就言简意赅。无需每次会话输入/caveman。无需反复提醒。
~/.openclaw/workspace/ ├── skills/caveman/SKILL.md ← full ruleset, on-demand load └── SOUL.md ← ... ↑ auto-inject every turn
自定义工作区路径?在命令前设置 OPENCLAW_WORKSPACE=/your/path。卸载:同一行命令加 --uninstall——技能文件夹删除,SOUL.md 块干净移除,你的其他工作区内容保持不变。幂等重复运行(frontmatter 不会重复追加,标记块不会重复添加)。
龙虾的爪依然锋利。龙虾的嘴现在精简。大脑依然强大。
Caveman 生态
五款工具。一个理念:Agent 以更少实现更多。
| 仓库 | 说明 |
| caveman (就是这里) | 输出压缩——为何用多词,少词已够用 |
| caveman-code | 完整终端编码 Agent——为何用多 token,当整个 Agent 都能节省 |
| cavemem | 跨 Agent 记忆——为何让 Agent 遗忘,当 Agent 可以记住 |
| cavekit | 规范驱动的构建循环——为何让 Agent 猜测,当 Agent 可以知晓 |
| cavegemma | 基于穴居人对话对微调的 Gemma 4 31B——为何每轮提示,当权重已记住 |
组合使用:cavekit 驱动构建,caveman 压缩 Agent 说的内容,cavemem 压缩 Agent 记住的内容,cavegemma 将压缩能力烘焙进权重,caveman-code 将一切打包为一个终端 Agent 交付。一块石头。两块石头。三块石头。四块石头。五块石头。就这些。
来自同一山洞的更多技能
Caveman 还有同门兄弟。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 — Bug、功能请求、异常行为反馈
给这个仓库点个 Star
Caveman 帮你省 token,省钱。Star 零成本。公平交易。⭐
Julius Brussee 的其他作品
- ** Revu ** — 本地优先的 macOS 学习应用,内置 FSRS 间隔重复算法。revu.cards
赞助商
caveman 永久免费。赞助商让石头保持锋利。
Atlas Cloud — 全模态 AI 推理平台,统一一个 API。
也想把你的石头放在这里?赞助 caveman。
许可证
MIT — 自由如猛犸象驰骋开阔平原。
更多推荐



所有评论(0)