它是什么,不是什么
caveman 是一种腔调,不是破碎的语法。skills/caveman/SKILL.md 要求智能体先给答案,去掉客套(“Sure!”、“Let me”、“Hope this helps”),一句只说一件事,只有在句子仍能一读就懂时才省略冠词;not、never、no、only 从不省略。代码块、命令、路径和报错逐字保留。安全警告、不可撤销的操作、用户困惑时仍用完整句子;写到聊天之外的内容(代码注释、提交、文档、PR)也一样。
同一仓库还提供了一个大得多的 caveman CLI,技能只是其中一部分(README 把各部分称为 “rocks”)。先确认你要的是哪一个:
| 功能 | caveman skill(本页) | 完整 caveman CLI |
|---|---|---|
| 安装 | npx skills add JuliusBrussee/caveman -g | npx @caveman-ai/cli@latest(需 Node.js 22.13+) |
| 回复变短 | 有:/caveman、/ultracave、/megacave | 有,默认开启 |
| 压缩智能体读取的内容(日志、JSON、测试输出) | 没有 | 有(“Read less”) |
| 按问题自动选模型(Auto) | 没有 | 有,需免费注册登录 |
| Blocks、browse、learn、stats | 没有 | 有 |
| 联网 | 在本机运行,不发送任何内容(/caveman-compress 会把文件发给你的模型服务商) | 默认发送使用统计(可 caveman telemetry off 关闭);选用 Auto 后会把提问发送到 Caveman Cloud |
完整安装命令为 npx @caveman-ai/cli@latest。它会查找你的智能体和登录信息,在你按回车前列出将要改动的内容。本页只介绍技能;运行 CLI 前请先阅读 README。
同名不同包:一些技能合集(如 alirezarezvani/claude-skills)也带有自己的 “caveman” 技能。本条目只介绍 JuliusBrussee/caveman。
为你的助手安装
以下命令依据 JuliusBrussee/caveman 的 README 与 INSTALL.md(2026 年 11 月 2 日抓取)。AgentSkillsDir 尚未亲自运行,待我们实测。
skills CLI (skill only)
之后 若未自动开启,输入 /cavemannpx skills add JuliusBrussee/caveman -g只装技能,不带代理。-g 装到用户级技能目录;去掉则只装到当前项目。用 -a 指定智能体(codex、windsurf、cline、kilo 等)。卸载:npx skills remove JuliusBrussee/caveman -g。
Claude Code (plugin)
之后 重启后每个会话自动开启claude plugin marketplace add JuliusBrussee/caveman claude plugin install caveman@caveman每个交互会话自动开启,子智能体也一样。已在 Claude Code 里?依次输入 /plugin marketplace add JuliusBrussee/caveman 和 /plugin install caveman@caveman。更新要写全名:claude plugin update caveman@caveman(只写 caveman 会失败)。自动开启需要 PATH 中有 Node.js 18+;没有则手动输入 /caveman。
Codex (skills + start hook)
之后 运行一次 /hooks,信任 caveman 钩子npx -y github:JuliusBrussee/caveman -- --only codex安装技能和一个 SessionStart 钩子,之后每个新 Codex 会话、/clear 或上下文压缩后都以 caveman 开始。只要技能不要钩子:npx skills add JuliusBrussee/caveman -a codex -g,然后输入 $caveman(Codex 用 $ 调用技能,不是 /)。npm 12 及以上需在 npx 后加 --allow-git=root。
OpenCode
之后 新开会话,默认已开启npx -y github:JuliusBrussee/caveman -- --only opencode添加原生插件,并把常驻规则写入 AGENTS.md。子智能体读取这些固定规则,所以 “stop caveman” 对子智能体无效。npm 12 及以上需在 npx 后加 --allow-git=root。
Cursor (session hook)
之后 新对话以默认模式开始npx -y github:JuliusBrussee/caveman -- --only cursor添加技能、Cavecrew 智能体和一个会话钩子(~/.cursor/hooks.json,你已有的钩子保留)。另一种方式是 Cursor 插件:把仓库克隆到 ~/.cursor/plugins/local/caveman 并重新加载窗口。二选一;两个都装,每次对话会加载两遍规则。
其他智能体
- Gemini CLI
gemini extensions install https://github.com/JuliusBrussee/caveman
自动开启。- Windows (PowerShell 5.1+)
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v4.0.1/install.ps1 | iex
一次装好检测到的全部智能体。若被执行策略拦截:先运行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass 再重试。- Windsurf, Cline, Kilo, Roo, Amp …
npx skills add JuliusBrussee/caveman -a windsurf -g
把 windsurf 换成你的智能体。按会话开启:输入 /caveman 或说 caveman mode。- Claude apps (web, desktop, mobile, Cowork)
Customize > Plugins > Add marketplace: JuliusBrussee/caveman
聊天中没有启动钩子:以 /caveman 开始。上游尚未端到端测试。
完整列表(30 多种智能体)、开发容器、更新与卸载步骤见INSTALL.md。
开启、切换模式、关闭
- 输入
/caveman(Codex 中为$caveman),如果它没有自动开启。问一个真实问题:回复应直接给出答案,没有寒暄或复述。 - 想更短?
/ultracave只留短语。/megacave用文言文作答;上游说明其 token 节省幅度小且不稳定。 - 说
stop caveman或normal mode即可恢复。/caveman status显示当前模式,不做任何改变。
模式按窗口独立。要设定新会话的起始模式,在 ~/.config/caveman/config.json(或项目根目录的 .caveman.json)中写入 {"defaultMode": "ultracave"}(也可为 caveman、megacave、off)。脚本化运行的 Claude Code(claude -p、Agent SDK)默认关闭 caveman。待我们实测。
关于节省比例
上游自己的基线是 “Answer concisely”(新模型本来就会照做)。在十个开发问题上,与之相比 /caveman 的输出 token 中位数少 3%,/ultracave 少 35%。这些数据基于较早的 3.1.0 规则,尚未重测。规则本身约占 1,160 个输入 token;如果按次而非按 token 计费(如 GitHub Copilot),回答变短并不省钱。JetBrains 在 86 个任务上的配对测试显示,输出 token 少 8.5%,质量无可测损失。
仓库页面上更大的百分比来自完整 CLI 或单个示例,并不代表技能在你项目上的效果。它们是上游自称,AgentSkillsDir 未复现。请阅读上游列出的 caveman 失利案例,并在自己的会话中实测。
caveman 与 ponytail
两者都是“行为类”技能,可以叠加使用。ponytail 决定智能体写多少代码;caveman 决定回复怎么说。上游 INSTALL.md 说明两者同时安装时都会生效;某个窗口只想要一个,就在那里说 stop caveman。graphify 则是另一回事:它把代码库整理成智能体可查询的知识图谱。
安装前
- SKILL.md 是纯文字指令,安装前请先在 GitHub 上阅读。
- 插件和安装脚本会添加运行 Node 的会话钩子,并修改智能体配置文件(settings.json、hooks.json、AGENTS.md)。可先用 --dry-run 运行安装脚本,查看所有将执行的命令。
- 完整 CLI 默认发送使用统计,选用 Auto 后会把提问发送到 Caveman Cloud。详见 SECURITY.md。只装技能不发送任何内容。
- 收录不等于安全审查。AgentSkillsDir 没有审查过这些代码。
常见问题
caveman skill 是什么?
JuliusBrussee/caveman(Apache-2.0)中的开源智能体技能。它让编码智能体先给答案、去掉废话:不寒暄、不复述、句子简短。代码、命令、路径、数字和报错原样保留,安全警告仍用完整句子。
这是 caveman 游戏或电影吗?
不是。本页介绍的是名为 caveman 的 AI 编码技能,与任何游戏、电影或其他 “caveman” 品牌无关,AgentSkillsDir 也与 JuliusBrussee 无隶属关系。
如何安装 caveman skill?
只装技能(任意智能体):npx skills add JuliusBrussee/caveman -g。Claude Code 插件:先 claude plugin marketplace add JuliusBrussee/caveman,再 claude plugin install caveman@caveman。Codex、OpenCode、Cursor 用 npx -y github:JuliusBrussee/caveman -- --only <智能体>。2026 年 11 月 2 日抓取;待我们实测。
装了技能就等于装了完整的 caveman CLI 和代理吗?
不等于。技能只改变智能体的回复方式。压缩日志与工具输出、Auto 自动选模型、Blocks 和统计属于独立的 caveman CLI(npx @caveman-ai/cli@latest),它默认还会发送使用统计。
caveman 能帮我省多少?
我们不承诺具体比例,网上流传的 65% 或 75% 也不是保证。上游自己的测试:十个问题中,与 “Answer concisely” 相比,/caveman 的输出 token 中位数少 3%,/ultracave 少 35%(基于旧版规则)。规则本身约占 1,160 个输入 token;按次计费时变短的回答并不省钱。
怎么开启和关闭 caveman?
输入 /caveman 开启(Codex 中为 $caveman),/ultracave 或 /megacave 切换到更强的模式;说 “stop caveman” 或 “normal mode” 恢复。/caveman status 显示当前模式。模式按窗口独立。
caveman 支持 Windows 吗?
上游提供 PowerShell 5.1+ 安装脚本(install.ps1),并建议用它而不是 install.sh,因为钩子会对应配置 PowerShell 版本。装有 Node 时 npx skills add 在 Windows 上同样可用。待我们实测。
为什么 Codex 没有用 caveman 腔调?
只装技能时,要输入 $caveman 才会开启。想要常开,用 --only codex 安装,然后在 Codex 中运行一次 /hooks 并信任 caveman 钩子。若 codex features list 显示 hooks 关闭,在 ~/.codex/config.toml 中加入 [features] hooks = true。
用 caveman 还是 ponytail?
两者分工不同,可以同时使用:ponytail 决定智能体写多少代码,caveman 决定回复怎么说。ponytail 详见其技能页面。
AgentSkillsDir 会替我运行 caveman 吗?
不会。这是附来源链接的目录条目。本页面不会安装或运行任何内容,我们不托管任何代理,收录也不等于安全审查。
