cavecrew

原文：🇺🇸 英文

已翻译

委托给穴居人风格子代理（subagent）的决策指南。指导主线程何时生成`cavecrew-investigator`（定位代码）、`cavecrew-builder`（1-2个文件编辑）或`cavecrew-reviewer`（差异审查），而非直接执行任务或使用原生`Explore`。子代理的输出经过穴居人式压缩，因此注入到主上下文的工具结果大小约减少60%——主上下文在长会话中能维持更久。触发词：“delegate to subagent”、“use cavecrew”、“spawn investigator/builder/reviewer”、“save context”、“compressed agent output”。

270.7k次下载

来源juliusbrussee/caveman

添加于2026-05-01

NPX安装

npx skill4agent add juliusbrussee/caveman cavecrew

SKILL.md 内容（中文）

查看翻译对照 →

Cavecrew = 三个生成穴居人风格输出的子代理预设。其功能与Anthropic的默认代理（

Explore

、编辑风格代理、审查代理）相同；区别在于它们返回的工具结果经过压缩，因此每次委托都会减小主上下文的体积。

何时使用Cavecrew vs 替代方案

任务	使用对象
"X定义在哪里/什么调用了Y/列出Z的用法"	`cavecrew-investigator`
上述任务，但还需要建议/架构评论	`Explore` （原生）
精准编辑，≤2个文件，范围明确	`cavecrew-builder`
新功能开发 / 3个及以上文件修改 / 跨模块重构	主线程或 `feature-dev:code-architect`
审查差异、分支或文件中的Bug	`cavecrew-reviewer`
包含理由和替代方案的深度代码审查	`Code Reviewer` （原生）
你已知答案的单行问题	主线程，无需子代理

经验法则：如果希望子代理的输出占用1/3的tokens，选择cavecrew；如果需要完整 prose（散文式表述），选择原生代理。

为什么存在这个工具（真正的优势）

子代理的工具结果会原封不动地注入主上下文。一个返回2k tokens散文内容的原生

Explore

，每次都会消耗2k tokens的主上下文预算。而

cavecrew-investigator

得出相同结论仅需返回约700 tokens。在一个会话中进行20次委托时，这就是上下文耗尽与完成任务的区别。

输出约定

主线程可依赖各代理的输出规范：

cavecrew-investigator

<Header>:
- path:line — `symbol` — short note
totals: <counts>.

或返回

No match.

始终以文件路径优先，附带行号，符号用反引号包裹。可使用

path:\d+

安全地进行grep检索。

cavecrew-builder

<path:line-range> — <change ≤10 words>.
verified: <re-read OK | mismatch @ path:line>.

或返回以下其中一项：

too-big.

/

needs-confirm.

/

ambiguous.

/

regressed.

（首词为终端标识）。

cavecrew-reviewer

path:line: <emoji> <severity>: <problem>. <fix>.
totals: N🔴 N🟡 N🔵 N❓

或返回

No issues.

结果按文件→行号升序排列。

链式模式

定位 → 修复 → 验证（最常见）：

```
cavecrew-investigator
```
返回目标位置列表。
主线程选择1-2个位置，将路径交给
```
cavecrew-builder
```
。
```
cavecrew-reviewer
```
审查差异。

并行侦察（当调查范围较广时）：在一条消息中发起2-3次

cavecrew-investigator

调用（不同角度：定义 vs 调用方 vs 测试）。在主线程中汇总结果。

单次编辑（当已知目标位置时）：跳过调查环节，直接将精确的path:line交给

cavecrew-builder

。

禁止操作

当你不知道目标文件时，不要使用
```
cavecrew-builder
```
。先调用调查代理，否则主线程会因传递上下文消耗大量tokens。
不要为5个文件的重构链式调用
```
cavecrew-investigator → cavecrew-builder
```
。Builder会返回
```
too-big.
```
，浪费一次调用机会。
不要让
```
cavecrew-reviewer
```
提供“通用反馈”——它仅返回问题结果，不提供架构意见。此类需求请使用
```
Code Reviewer
```
。
不要期望散文式输出。Cavecrew的输出是结构化的，有时简洁到近乎晦涩。如果需要人类直接阅读，请自行转述。

自动清晰化（继承特性）

当涉及安全警告、不可逆操作确认，以及任何可能因片段歧义导致误读的输出时，子代理会从穴居人风格切换为标准英文表述。完成相关内容后恢复穴居人风格输出。