开源项目

caveman

caveman

专为Claude Code等AI编码助手设计的技能插件,通过让agent用极简原始人风格说话,平均减少65%的输出token,大幅降低API成本。亮点:无需改模型,仅靠提示优化即可实现token节省,支持lite/full/ultra/wenyan等多级压缩,兼顾技术准确性。

README

caveman

少言即可,何须多词

Stars Last Commit License

Before/After • 安装 • 功能一览 • 基准测试 • 完整安装指南


一个 Claude Code 技能/插件(同样适用于 Codex、Gemini、Cursor、Windsurf、Cline、Copilot 及 30+ 其他智能体),让 agent 像原始人一样说话——削减 ~75% 的输出 token,同时保持完整的技术准确性。脑子还是那么大,嘴巴变小了。

Before / After

🗣️ 普通 Claude(69 tokens)

"你的 React 组件重新渲染的原因很可能是你在每次渲染周期中创建了新的对象引用。当你将内联对象作为 prop 传递时,React 的浅比较会将其视为不同的对象,从而触发重新渲染。我建议使用 useMemo 来记忆化该对象。"

岩石 原始人 Claude(19 tokens)

"每次渲染新对象引用。内联对象 prop = 新引用 = 重新渲染。用 useMemo 包一下。"

🗣️ 普通 Claude

"当然!我很乐意帮你解决这个问题。你所遇到的这个现象很可能是由你的认证中间件没有正确验证 token 过期引起的。让我看一下并提出修复方案。"

岩石 原始人 Claude

"认证中间件漏洞。Token 过期检查用的是 < 不是 <=。修复:"

同样修复。少 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——caveman-code

这个技能只缩小 agent 的说辞。caveman-code 缩小一切——完整的终端编码 agent,从头到尾都是原始人风格。在相同任务上比 Codex 节省约 2 倍 token。支持 20+ 提供商·计划模式·自动目标循环·MIT 协议。

npm install -g @juliusbrussee/caveman-code

▶ 立即试用 caveman-code → —— 当整个 agent 都能节省时,何必用很多 token

安装

一行命令。适配每个 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 个百分点。冗长不一定更好。有时少说反而更正确。

工作原理

  1. 安装将技能文件放入 agent。
  2. 技能告诉 agent:去掉废话,保留实质,使用片段。
  3. 对于 Claude Code,钩子还会在每次会话写入一个小标志文件 —— agent 看到标志,从第一条消息起就以原始人方式说话。无需输入 /caveman。
  4. Stats 命令读取 Claude Code 会话日志,计算节省的 token 数量,写入状态行。
  5. 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

只发生两件事,不多不少:

  1. 技能放置在 ~/.openclaw/workspace/skills/caveman/SKILL.md —— 符合规范的 frontmatter(version、always: true),可通过 openclaw skills list 发现。技能不会自动注入(OpenClaw 按需加载技能)—— 所以我们还有第 2 步。
  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,节省钱。加星免费。公平交易。⭐

Star History Chart

Julius Brussee 的其他作品

  • Revu —— 本地优先的 macOS 学习应用,采用 FSRS 间隔重复。revu.cards

赞助者

原始人永久免费。赞助让石头保持锋利。

Atlas Cloud

Atlas Cloud —— 全模态 AI 推理平台,一个 API。

想让你的石头也在这里?赞助原始人。

许可证

MIT —— 自由如开阔平原上的猛犸象。

开源项目JuliusBrussee2026-07-02原文

相关内容