Caveman

Установка

npx skills add JuliusBrussee/caveman

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Caveman состоит из двух частей. Скилл заставляет агента отвечать коротко, при этом код, команды, пути и тексты ошибок остаются без изменений, уровни задаются командой /caveman lite, full или ultra. Прокси работает на вашей машине между агентом и провайдером, сжимает логи, вывод тестов и диффы перед отправкой и хранит оригиналы в локальной SQLite. CLI также умеет анализировать историю сессий командой caveman learn и сжимать вывод команд через caveman shrink.

Для кого. Разработчики, которые платят за токены и хотят сократить расходы на длинных сессиях.

Пример запроса к агенту

/caveman full, почему этот React-компонент перерисовывается на каждый рендер

Ограничения

Скилл сокращает только выходные токены, а его правила добавляют около 1-1,5 тыс. входных токенов на каждый ход, поэтому на лаконичной работе можно потерять. CLI по умолчанию отправляет анонимную статистику. Движок и прокси распространяются под BSL-1.1, скилл и CLI под MIT.

Как отключить. Скажите /caveman off или normal mode. Удаление: npx -y github:JuliusBrussee/caveman -- --uninstall. Телеметрия отключается командой caveman telemetry off или переменной DO_NOT_TRACK=1.

Проверка безопасности

• Прокси перехватывает трафик между агентом и провайдером
• Полный установщик ставит хуки Claude Code и запускается через curl | bash
• CLI по умолчанию отправляет анонимную телеметрию

Коротко о README

README объясняет разницу между скиллом и прокси и приводит бенчмарки с оговорками, включая случаи без выигрыша. Скилл ставится через npx skills или как плагин Claude Code, прокси через npm-пакет @caveman-ai/cli. Описаны команды CLI, режим конвертации скиллов в изображения, обертки для разных агентов и MCP-инструменты. Отдельный раздел посвящен телеметрии и раздельной лицензии.

SKILL.md

---
name: cavecrew
description: >
  When to delegate to `cavecrew-investigator` (locate code), `cavecrew-builder`
  (1-2 file edit) or `cavecrew-reviewer` (diff review) instead of working inline
  or using `Explore`. Their output is compressed, so main context lasts longer.
---

Cavecrew = three subagent presets that emit caveman output. Same job as Anthropic defaults (`Explore`, edit-style agents, reviewer); difference is the tool-result they return is compressed, so main context shrinks per delegation.

## When to use cavecrew vs alternatives

| Task | Use |
|---|---|
| "Where is X defined / what calls Y / list uses of Z" | `cavecrew-investigator` |
| Same but you also want suggestions/architecture commentary | `Explore` (vanilla) |
| Surgical edit, ≤2 files, scope obvious | `cavecrew-builder` |
| New feature / 3+ files / cross-cutting refactor | Main thread or `feature-dev:code-architect` |
| Review diff, branch, or file for bugs | `cavecrew-reviewer` |
| Deep code review with rationale + alternatives | `Code Reviewer` (vanilla) |
| One-line answer you already know | Main thread, no subagent |

Rule of thumb: **if you'd want the subagent's output in 1/3 the tokens, pick cavecrew. If you'd want prose, pick vanilla.**

## Why this exists (the real win)

Subagent tool results get injected into main context verbatim. A vanilla `Explore` that returns 2k tokens of prose costs 2k tokens of main-context budget every time. The same finding from `cavecrew-investigator` returns ~700 tokens. Across 20 delegations in one session that's the difference between context exhaustion and finishing the task.

## Output contracts

What main thread can rely on per agent:

**`cavecrew-investigator`**
```
<Header>:
- path:line — `symbol` — short note
totals: <counts>.
```
Or `No match.` Always file-path-first, line-number-attached, backticked symbols. Safe to grep with `path:\d+`.

**`cavecrew-builder`**
```
<path:line-range> — <change ≤10 words>.
verified: <re-read OK | mismatch @ path:line>.
```
Or one of: `too-big.` / `needs-confirm.` / `ambiguous.` / `regressed.` (terminal first token).

**`cavecrew-reviewer`**
```
path:line: <emoji> <severity>: <problem>. <fix>.
totals: N🔴 N🟡 N🔵 N❓
```
Or `No issues.` Findings sorted file → line ascending.

## Chaining patterns

**Locate → fix → verify** (most common):
1. `cavecrew-investigator` returns site list.
2. Main thread picks 1-2 sites, hands paths to `cavecrew-builder`.
3. `cavecrew-reviewer` audits the diff.

Похожие