mcpField
C
cavecrew

cavecrew

github.com/karnonsonAgent 工作流147 次安装19 周前更新
代码仓库

关于 cavecrew

cavecrew 提供用于代码调查、小范围编辑和审查的三个子 Agent 预设。它们以结构化的精简结果返回信息,减少委派任务时注入主 Agent 上下文的文本量。

主要功能

  1. 01按文件和行号调查代码
  2. 02执行最多涉及两个文件的定界编辑
  3. 03针对缺陷审查差异和文件
  4. 04返回精简的结构化子 Agent 结果

适用场景

  1. 01查找定义、调用方或符号用法
  2. 02完成范围明确的小型代码修改
  3. 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、分支或文件中的 bugcavecrew-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.。发现按文件 → 行号升序排列。

串联模式

定位 → 修复 → 验证(最常见):

  1. cavecrew-investigator 返回位置列表。
  2. 主线程挑选 1-2 处位置,将路径交给 cavecrew-builder。
  3. 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 会从穴居人风格切换为正常英语。之后恢复穴居人风格。

评论

支持 Markdown