关于 cavecrew
cavecrew 提供用于代码调查、小范围编辑和审查的三个子 Agent 预设。它们以结构化的精简结果返回信息,减少委派任务时注入主 Agent 上下文的文本量。
主要功能
- 01按文件和行号调查代码
- 02执行最多涉及两个文件的定界编辑
- 03针对缺陷审查差异和文件
- 04返回精简的结构化子 Agent 结果
适用场景
- 01查找定义、调用方或符号用法
- 02完成范围明确的小型代码修改
- 03检查分支或差异中的缺陷
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ karnonson/ caveman --skill cavecrew安装后在 Claude Code 中输入/cavecrew确认已加载。
附带文件README.md
详细介绍
Cavecrew = 三个会生成穴居人风格输出的子 Agent 预设。它们与 Anthropic 默认项(Explore、编辑类 Agent、审查者)执行相同的任务;区别在于它们返回的工具结果经过压缩,因此每次委派后主上下文占用更少。
何时使用 cavecrew,何时使用其他选项
| 任务 | 使用 |
|---|---|
| “X 定义在哪里 / Y 由什么调用 / 列出 Z 的用法” | cavecrew-investigator |
| 同上,但还想要建议或架构方面的评论 | Explore(原版) |
| 精准编辑,≤2 个文件,范围明确 | cavecrew-builder |
| 新功能 / 3 个以上文件 / 跨领域重构 | 主线程或 feature-dev:code-architect |
| 审查 diff、分支或文件中的 bug | cavecrew-reviewer |
| 需要理由和替代方案的深入代码审查 | Code Reviewer(原版) |
| 已知的一行答案 | 主线程,不用子 Agent |
经验法则:如果你希望子 Agent 的输出缩短到原来的 1/3,就选 cavecrew。如果你想要一段文字说明,就选原版。
为什么要这样做(真正的收益)
子 Agent 的工具结果会原样注入主上下文。原版 Explore 返回 2k token 的文字说明,每次都会占用主上下文预算中的 2k token。cavecrew-investigator 返回相同发现时只需约 700 token。在一次会话中委派 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审查 diff。
并行侦察(调查范围较广时):
在一条消息中启动 2-3 个 cavecrew-investigator 调用(从不同角度调查:定义、调用方、测试)。在主线程中汇总结果。
单次编辑(位置已知时):
跳过 investigator。直接将确切的路径:行号交给 cavecrew-builder。
不要这样做
- 如果还不知道文件位置,就不要使用
cavecrew-builder。先启动 investigator,否则主线程会浪费 token 来传递上下文。 - 对于涉及 5 个文件的重构,不要串联
cavecrew-investigator → cavecrew-builder。Builder 会返回too-big.,白白浪费一个回合。 - 不要向
cavecrew-reviewer索要“总体反馈”——它只返回发现,不提供架构意见。需要架构意见时使用Code Reviewer。 - 不要期待文字说明。Cavecrew 输出是结构化的,有时简短得近乎晦涩。如果要让人直接阅读,请改述。
自动清晰化(继承而来)
遇到安全警告、不可逆操作确认,以及任何可能因片段含糊而被误读的输出时,子 Agent 会从穴居人风格切换为正常英语。之后恢复穴居人风格。