用途:Cavecrew 提供三个子代理预设,功能对应 Anthropic 默认的 Explore、编辑型代理和审查代理,区别在于返回的工具结果经过压缩,每次委派都能减少主上下文占用。
主要能力与输出契约:cavecrew-investigator 负责定位代码,输出以文件路径开头、附行号与反引号符号,格式形如 path:line — symbol — 简短说明 与 totals 计数,结尾可为 No match;cavecrew-builder 负责不超过 2 个文件的小范围外科手术式编辑,输出 path:line-range — 改动描述 与 verified 结果,终止词可为 too-big.、needs-confirm.、ambiguous.、regressed.;cavecrew-reviewer 负责审查 diff、分支或文件中的 bug,输出按文件与行号升序排列的发现,带严重度与修复建议,结束于 totals 统计或 No issues。
使用方式:常见链路为 investigato 定位、主线程挑选 1-2 处交给 builder、再由 reviewer 审计 diff;调查面较广时可在一条消息中并行启动 2-3 个 investigator 从不同角度侦察,主线程汇总;已知确切位置时可跳过 investigator 直接把 path:line 交给 builder。判断原则是若希望输出缩到三分之一 token 选 cavecrew,若需要叙述性文字则选原版代理。
适用场景:查询 X 定义位置、Y 的调用方、Z 的使用列表;范围明确的小型编辑;对 diff 或分支做 bug 审查。
限制:不要在不清楚文件位置时使用 builder,否则主线程会浪费 token 传上下文;不要用 investigator→builder 链路做 5 个文件的重构,builder 会返回 too-big.;reviewer 只给发现、不提供架构意见;输出为结构化、有时极简,若给人直接阅读需改写。遇到安全警告、不可逆操作确认等场景会临时切换为正常英语表达后再恢复。