caveman

话少办事多

改造前/后 • 安装 • 等级 • 技能 • 基准测试 • 评估

🪨 Caveman 生态  ·  caveman 说得更少 _{(你在这里)}  ·  cavemem 记得更多  ·  cavekit 构建更好

一个 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 技能/插件和 Codex 插件，能让 AI 像穴居人一样说话——在保持完整技术准确性的同时，**减少约 75% 的输出 token**。现已支持[文言文模式](#文言文-wenyan-mode)、[极简 commit](#caveman-commit)、[单行代码审查](#caveman-review)，以及一个[压缩工具](#caveman-compress)，每次会话可**减少约 46% 的输入 token**。 基于“穴居人语能大幅减少 LLM token 用量而不丢失技术实质”这一火爆观察，我们把它做成了一行命令即可安装的工具。 ## 改造前 / 后

### 🗣️ 普通 Claude (69 tokens)	### 🪨 Caveman Claude (19 tokens)
### 🗣️ 普通 Claude	### 🪨 Caveman Claude

**同样的修复。少了 75% 的词。大脑依然灵光。** **选择你的咕噜等级：**

#### 🪶 轻量

#### 🪨 完整

#### 🔥 极限

#### 📜 文言文

**同样的答案。字数由你定。** ``` ┌─────────────────────────────────────┐ │ TOKENS SAVED ████████ 75% │ │ TECHNICAL ACCURACY ████████ 100%│ │ SPEED INCREASE ████████ ~3x │ │ VIBES ████████ OOG │ └─────────────────────────────────────┘ ``` - **响应更快** — 生成的 token 更少 = 速度起飞 - **阅读更易** — 没有长篇大论，只有答案 - **准确度不变** — 保留所有技术信息，只去掉废话（[科学如是说](https://arxiv.org/abs/2604.00025)） - **节省金钱** — 输出 token 减少约 71% = 成本更低 - **充满乐趣** — 每一次代码审查都变成喜剧 ## 安装 选择你的智能体。一行命令。大功告成。 | 智能体 | 安装 | |-------|---------| | **Claude Code** | `claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman` | | **Codex** | Clone 仓库 → `/plugins` → 搜索 "Caveman" → 安装 | | **Gemini CLI** | `gemini extensions install https://github.com/JuliusBrussee/caveman` | | **Cursor** | `npx skills add JuliusBrussee/caveman -a cursor` | | **Windsurf** | `npx skills add JuliusBrussee/caveman -a windsurf` | | **Copilot** | `npx skills add JuliusBrussee/caveman -a github-copilot` | | **Cline** | `npx skills add JuliusBrussee/caveman -a cline` | | **其他** | `npx skills add JuliusBrussee/caveman` | 安装一次。之后即可在每次会话中使用。一块石头。就这么多。 ### 你将获得 Claude Code、Gemini CLI 和下文提到的 Codex 仓库本地配置已内置自动激活功能。`npx skills add` 为其他智能体安装了技能，但**不会**安装仓库规则/指令文件，因此除非你添加下文的一劳永逸代码片段，否则 Caveman 不会自动启动。 | 功能 | Claude Code | Codex | Gemini CLI | Cursor | Windsurf | Cline | Copilot | |---------|:-----------:|:-----:|:----------:|:------:|:--------:|:-----:|:-------:| | Caveman 模式 | Y | Y | Y | Y | Y | Y | Y | | 每次会话自动激活 | Y | Y¹ | Y | —² | —² | —² | —² | | `/caveman` 命令 | Y | Y¹ | Y | — | — | — | — | | 模式切换 (轻量/完整/极限) | Y | Y¹ | Y | Y³ | Y³ | — | — | | 状态栏徽章 | Y⁴ | — | — | — | — | — | — | | caveman-commit | Y | — | Y | Y | Y | Y | Y | | caveman-review | Y | — | Y | Y | Y | Y | Y | | caveman-compress | Y | Y | Y | Y | Y | Y | Y | | caveman-help | Y | — | Y | Y | Y | Y | Y |

Claude Code — 详细说明

插件安装会为你提供技能 + 自动加载的 hooks。如果你没有配置自定义的 `statusLine`，Caveman 会在首次会话时提示 Claude 提供徽章设置。 ``` claude plugin marketplace add JuliusBrussee/caveman claude plugin install caveman@caveman ``` **独立 hooks（不使用插件）：** 如果你不想使用插件系统： ``` # macOS / Linux / WSL bash <(curl -s https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.sh) # Windows (PowerShell) irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.ps1 | iex ``` 或者从本地克隆安装：`bash hooks/install.sh` / `powershell -File hooks\install.ps1` 卸载：`bash hooks/uninstall.sh` 或 `powershell -File hooks\uninstall.ps1` **状态栏徽章：** 在你的 Claude Code 状态栏中显示 `[CAVEMAN]`、`[CAVEMAN:ULTRA]` 等。 - **插件安装：** 如果你还没有自定义 `statusLine`，Claude 应该会在首次会话时提供配置选项 - **独立安装：** 由 `install.sh` / `install.ps1` 自动配置，除非你已有自定义状态栏 - **自定义状态栏：** 安装程序会保留你现有的状态栏。请参阅 [`hooks/README.md`](hooks/README.md) 获取合并代码片段

Codex — 详细说明

**macOS / Linux:** 1. Clone 仓库 → 在仓库目录中打开 Codex → `/plugins` → 搜索 "Caveman" → 安装 2. 仓库本地自动启动已通过 `.codex/hooks.json` + `.codex/config.toml` 配置完毕 **Windows:** 1. 首先启用符号链接：`git config --global core.symlinks true`（需要开发者模式或管理员权限） 2. Clone 仓库 → 打开 VS Code → Codex 设置 → 插件 → 在本地市场中找到 "Caveman" → 安装 → 重新加载窗口 3. Codex hooks 目前在 Windows 上被禁用，因此请使用 `$caveman` 手动启动 本仓库还附带了 `.codex/hooks.json` 并在 `.codex/config.toml` 中启用了 hooks，因此在 macOS/Linux 上于此仓库中运行 Codex 时，caveman 会自动激活。安装的插件为你提供了 `$caveman` 命令；如果你想在其他仓库中也实现始终开启，可以复制相同的 `SessionStart` hook 并启用： ``` [features] codex_hooks = true ```

Gemini CLI — 详细说明

``` gemini extensions install https://github.com/JuliusBrussee/caveman ``` 更新：`gemini extensions update caveman` · 卸载：`gemini extensions uninstall caveman` 通过 `GEMINI.md` 上下文文件自动激活。还附带自定义 Gemini 命令： - `/caveman` — 切换强度等级（轻量/完整/极限/文言文） - `/caveman-commit` — 生成极简 commit 信息 - `/caveman-review` — 单行代码审查

Cursor / Windsurf / Cline / Copilot — 详细说明

`npx skills add` 仅安装技能文件——它**不会**安装智能体的规则/指令文件，因此 caveman 不会自动启动。要实现始终开启，请将下方的“想要始终开启？”代码片段添加到你智能体的规则或系统提示词中。 | 智能体 | 命令 | 未安装项 | 模式切换 | 始终开启位置 | |-------|---------|--------------|:--------------:|--------------------| | Cursor | `npx skills add JuliusBrussee/caveman -a cursor` | `.cursor/rules/caveman.mdc` | Y | Cursor 规则 | | Windsurf | `npx skills add JuliusBrussee/caveman -a windsurf` | `.windsurf/rules/caveman.md` | Y | Windsurf 规则 | | Cline | `npx skills add JuliusBrussee/caveman -a cline` | `.clinerules/caveman.md` | — | Cline 规则或系统提示词 | | Copilot | `npx skills add JuliusBrussee/caveman -a github-copilot` | `.github/copilot-instructions.md` + `AGENTS.md` | — | Copilot 自定义指令 | 卸载：`npx skills remove caveman` Copilot 适用于 Chat、Edits 和 Coding Agent。

其他智能体 (opencode, Roo, Amp, Goose, Kiro 等 40+ 种)

[npx skills](https://github.com/vercel-labs/skills) 支持 40 多种智能体： ``` npx skills add JuliusBrussee/caveman # auto-detect agent npx skills add JuliusBrussee/caveman -a amp npx skills add JuliusBrussee/caveman -a augment npx skills add JuliusBrussee/caveman -a goose npx skills add JuliusBrussee/caveman -a kiro-cli npx skills add JuliusBrussee/caveman -a roo # ... 以及更多 ``` 卸载：`npx skills remove caveman` **重要：** 这些智能体没有 hook 系统，因此 caveman 不会自动启动。每次会话时说 `/caveman` 或 "talk like caveman" 即可激活。 **想要始终开启？** 将此内容粘贴到你智能体的系统提示词或规则文件中——caveman 将从每次会话的第一条消息开始处于激活状态： ``` Terse like caveman. Technical substance exact. Only fluff die. Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged. Pattern: [thing] [action] [reason]. [next step]. ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Code/commits/PRs: normal. Off: "stop caveman" / "normal mode". ``` 存放位置： | 智能体 | 文件 | |-------|------| | opencode | `.config/opencode/AGENTS.md` | | Roo | `.roo/rules/caveman.md` | | Amp | 你的工作区系统提示词 | | 其他 | 你的智能体系统提示词或规则文件 |

## 使用 触发方式： - `/caveman` 或 Codex 的 `$caveman` - "talk like caveman" - "caveman mode" - "less tokens please" 停止方式："stop caveman" 或 "normal mode" ### 强度等级 | 等级 | 触发 | 作用 | |-------|---------|------------| | **轻量** | `/caveman lite` | 去除废话，保留语法。专业且无冗余 | | **完整** | `/caveman full` | 默认 caveman。去掉冠词，使用片段，完全咕噜 | | **极限** | `/caveman ultra` | 极限压缩。电报式。缩写一切 | ### 文言文模式 中国古典文学式压缩——技术准确度不变，但使用人类发明过的最省 token 的书面语言。 | 等级 | 触发 | 作用 | |-------|---------|------------| | **轻量文言** | `/caveman wenyan-lite` | 半文半白。语法完整，去除冗余 | | **纯正文言** | `/caveman wenyan` | 纯正文言文。极致古典精炼 | | **极限文言** | `/caveman wenyan-ultra` | 极致。像预算有限的古代书生 | 选定等级在你更改或会话结束前一直有效。 ## Caveman 技能 ### caveman-commit `/caveman-commit` — 极简 commit 信息。遵循 Conventional Commits。标题不超过 50 个字符。重 "为何" 轻 "什么"。 ### caveman-review `/caveman-review` — 单行 PR 评论：`L42: 🔴 bug: user null. Add guard.` 没有任何客套话。 ### caveman-help `/caveman-help` — 快速参考卡。所有模式、技能、命令，一个命令全搞定。 ### caveman-compress `/caveman:compress ` — caveman 让 Claude *说* 更 token。而 **compress** 让 Claude *读* 更少的 token。 你的 `CLAUDE.md` 会在**每次会话开始时**加载。Caveman Compress 会将记忆文件改写为 caveman 语，从而减少 Claude 的阅读量——而你不会丢失人类可读的原始文件。 ``` /caveman:compress CLAUDE.md ``` ``` CLAUDE.md ← compressed (Claude reads this every session — fewer tokens) CLAUDE.original.md ← human-readable backup (you read and edit this) ``` | 文件 | 原始 | 压缩后 | 节省 | |------|----------:|----------:|------:| | `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%** | 代码块、URL、文件路径、命令、标题、日期、版本号——任何技术内容都会原封不动地通过。只有散文会被压缩。详情请参阅完整的 [caveman-compress README](caveman-compress/README.md)。[安全说明](./caveman-compress/SECURITY.md)：Snyk 由于子进程/文件模式将其标记为高风险——这属于误报。 ## 基准测试 来自 Claude API 的真实 token 计数（[亲自复现](benchmarks/)）： | 任务 | 正常 | Caveman (tokens) | 节省 | |------|---------------:|----------------:|------:| | 解释 React 重渲染 bug | 1180 | 159 | 87% | | 修复 auth middleware token 过期 | 704 | 121 | 83% | | 设置 PostgreSQL 连接池 | 2347 | 380 | 84% | | 解释 git rebase 与 merge 的区别 | 702 | 292 | 58% | | 将回调重构为 async/await | 387 | 301 | 22% | | 架构设计：microservices 与 monolith 的对比 | 446 | 310 | 30% | | 为安全问题审查 PR | 678 | 398 | 41% | | Docker 多阶段构建 | 1042 | 290 | 72% | | 调试 PostgreSQL 竞态条件 | 1200 | 232 | 81% | | 实现 React error boundary | 3454 | 456 | 87% | | **平均** | **1214** | **294** | **65%** | *范围：在不同提示词下节省 22%–87% 的 token。* 2026 年 3 月的一篇论文[《Brevity Constraints Reverse Performance Hierarchies in Language Models》](https://arxiv.org/abs/2604.00025)发现，限制大型模型做出简短回复，**在某些基准测试中使准确率提高了 26 个百分点**，并彻底逆转了性能层级。冗长并不总是更好。有时字少 = 更准确。 ## 评估 Caveman 不仅声称能减少 75%。Caveman **证明**了它。 `evals/` 目录中包含一个三臂评估工具，可针对适当的对照组测量真实的 token 压缩率——不仅仅是 "冗长与技能对比"，而是 "简洁与技能对比"。因为将 caveman 与冗长的 Claude 进行比较，会把技能的效果与普通的简洁性混为一谈。那是作弊。Caveman 不作弊。 ``` # 运行 eval (需要 claude CLI) uv run python evals/llm_run.py # 读取结果 (无需 API key，可离线运行) uv run --with tiktoken python evals/measure.py ``` ## 为本仓库加星 如果 caveman 为你节省了大量 token 和金钱——请留下大量的星。⭐ [](https://star-history.com/#JuliusBrussee/caveman&Date) ## 🪨 Caveman 生态系统 三款工具。一个理念：**智能体事半功倍**。 | 仓库 | 是什么 | 一句话描述 | |------|------|-----------| | [**caveman**](https://github.com/JuliusBrussee/caveman) *(你在这里)* | 输出压缩技能 | *why use many token when few do trick* — 跨 Claude Code、Cursor、Gemini、Codex 减少约 75% 的输出 token | | [**cavemem**](https://github.com/JuliusBrussee/cavemem) | 跨智能体持久记忆 | *why agent forget when agent can remember* — 压缩的 SQLite + MCP，默认本地化 | | [**cavekit**](https://github.com/JuliusBrussee/cavekit) | 规格驱动的自主构建循环 | *why agent guess when agent can know* — 自然语言 → kits → 并行构建 → 验证 | 它们可以组合使用：**cavekit** 编排构建，**caveman** 压缩智能体*说*的话，**cavemem** 压缩智能体*记住*的内容。安装一个、几个或全部——它们各自独立运行。 ## Julius Brussee 的其他作品 - **[Revu](https://github.com/JuliusBrussee/revu-swift)** — 本地优先的 macOS 学习应用，具有 FSRS 间隔重复、牌组、考试和学习指南功能。请访问 [revu.cards](https://revu.cards) ## 许可证 MIT — 像开阔平原上的海量猛犸象一样自由。

标签：Anthropic, CIS基准, Claude, Claude Code, Codex, Cutter, CVE检测, DLL 劫持, GitHub开源项目, LLM, SEO, SOC Prime, Token优化, Token压缩, Unmanaged PE, 人工智能, 代码审查, 代码辅助, 大语言模型, 开发工具, 提示词工程, 插件, 文言文模式, 极简主义, 用户模式Hook绕过, 策略决策点, 逆向工具, 降本增效