关于 cavecrew
cavecrew 是三个子 Agent 预设，以 ultracave 风格返回工具结果，用于压缩主上下文的占用。适合需要结构化结果的定位、小范围编辑和审查任务，大范围的功能开发不适用。
主要功能
- 01cavecrew-investigator 返回 path:line 格式的定位结果
- 02cavecrew-builder 处理小范围、范围明确的编辑
- 03cavecrew-reviewer 仅输出代码问题的审查结果
- 04子 Agent 输出压缩以减少主上下文占用
适用场景
- 01查找符号定义、调用方或某模式的全部使用位置
- 02在已知文件中做小范围修改后交由审查
- 03并行从定义、调用和测试等角度收集信息
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/cavecrew确认已加载。
附带文件README.md
详细介绍
Cavecrew = 3 个以超穴居人风格作答的子 Agent 预设（工具运行时：输入一行状态信息，输出一行；常规调用之间不插入任何内容）。工作内容与 Anthropic 默认项（Explore、编辑型 Agent、审查者）相同；区别在于它们返回的工具结果经过压缩，因此每次委派都会减少主上下文的占用。
何时使用 cavecrew，何时使用其他选项
| 任务 | 使用 |
|---|---|
| “X 定义在哪里／Y 被什么调用／列出 Z 的使用位置” | cavecrew-investigator |
| 同上，但还需要建议／架构评论 | 原版 Explore |
| 精确修改，≤2 个文件，范围明确 | cavecrew-builder |
| 新功能／3 个以上文件／跨领域重构 | 主线程，或在已安装时使用 feature-dev:code-architect |
| 审查差异、分支或文件中的错误 | cavecrew-reviewer |
| 深入代码审查，提供理由和替代方案 | 在已安装时使用原版 Code Reviewer，否则使用主线程 |
| 已知答案的一行回复 | 主线程，不使用子 Agent |
经验法则：如果你希望子 Agent 的输出只有原来的 1/3 token，就选 cavecrew。如果你想要完整文字说明，就选原版。
为什么要这样做（真正的收益）
子 Agent 的工具结果会原封不动地注入主上下文。原版 Explore 返回 2k token 的文字说明，每次都会占用主上下文预算中的 2k token。cavecrew-investigator 返回相同发现时，则会以压缩的 path:line 表格呈现。在一次会话中委派 20 次，这就是上下文耗尽与完成任务之间的区别。
输出约定
主线程可以依赖各 Agent 提供以下输出：
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.（首个 token 为终止状态）。
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 调用（分别从不同角度调查：定义、调用方、测试）。在主线程中汇总。
单次修改（已知位置时）：
跳过 investigator。直接将确切的 path:line 交给 cavecrew-builder。
注意事项
- 如果还不知道文件位置，不要使用
cavecrew-builder。先启动 investigator，否则主线程会浪费 token 来传递上下文。 - 不要为了 5 个文件的重构串联
cavecrew-investigator → cavecrew-builder。Builder 会返回too-big.，白白浪费一次调用。 - 不要向
cavecrew-reviewer请求“总体反馈”——它只返回发现，不提供架构意见。若已安装，请使用Code Reviewer获取这类意见。 - 不要期待完整文字说明。Cavecrew 的输出是结构化的，有时简短到近乎难以理解。如果要直接给人阅读，请改述。
自动清晰化（继承而来）
遇到安全警告、不可逆操作确认，以及任何可能因片段歧义而被误读的输出时，子 Agent 会从穴居人风格切换为正常英语。之后再恢复穴居人风格。