Hayatelin/caveman-zh-CN / skills/cavecrew
cavecrew
Verified决定何时把工作委派给 caveman 风格 subagent 的判断指南。告诉主线程 什么时候该派 `cavecrew-investigator`(定位代码)、`cavecrew-builder` (改 1-2 个文件)或 `cavecrew-reviewer`(审 diff),而不是自己 inline 做完 或用原版 `Explore`。Subagent 输出经过 caveman 压缩,塞回主 context 的 tool-result 小约 60%—— 长 session 下主 context 撑得更久。 Trigger: "delegate to subagent", "use cavecrew", "spawn investigator/builder/reviewer", "save context", "compressed agent output".
Cavecrew = 三个会输出 caveman 文体的 subagent 缺省组态。工作内容跟 Anthropic 原生的一样(Explore、编辑型 agent、reviewer);差别在它们返回的 tool-result 是压缩过的,所以每次委派吃掉的主 context 更少。
什么时候用 cavecrew、什么时候用别的
| 任务 | 用 |
|---|---|
| “X 定义在哪/谁调用 Y/列出 Z 的所有用处” | cavecrew-investigator |
| 同上,但你还想要建议或架构评论 | Explore(原版) |
| 外科手术式编辑,≤2 个文件,范围明确 | cavecrew-builder |
| 新功能/3 个以上文件/跨层重构 | 主线程或 feature-dev:code-architect |
| 审 diff、branch 或单文件找 bug | cavecrew-reviewer |
| 深度 code review,要理由+替代方案 | Code Reviewer(原版) |
| 你已经知道答案的一行问题 | 主线程,不派 subagent |
判断法则:如果你希望 subagent 的输出只有 1/3 的 token,选 cavecrew。如果你希望看到成篇散文,选原版。
这东西为什么存在(真正的收益)
Subagent 的 tool result 会原封不动塞进主 context。一个原版 Explore 返回 2k token 的散文,就是每次吃掉主 context 预算 2k token。同一个发现交给 cavecrew-investigator,返回约 700 token。一个 session 里委派 20 次,这个差距就是“context 爆掉”跟“任务做完”的差别。
输出契约
主线程可以依赖每个 agent 的这些格式:
cavecrew-investigator
<Header>:
- path:line — `symbol` — short note
totals: <counts>.
或 No match. 一律文件路径在前、行号紧接、symbol 用反引号包住。可以安全地用 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(不同角度:定义 vs 调用端 vs 测试)。在主线程汇整。
单发编辑(位置已经确定时):
跳过 investigator。直接把精确的 path:line 交给 cavecrew-builder。
不要做的事
- 还不知道是哪个文件时,别用
cavecrew-builder。先派 investigator,否则主线程光传脉络就把 token 吃光。 - 别为了 5 个文件的重构去串
cavecrew-investigator → cavecrew-builder。Builder 会回too-big.,你白白浪费一轮。 - 别叫
cavecrew-reviewer给“一般性建议”——它只反馈发现项目,不谈架构意见。那种需求用Code Reviewer。 - 别期待散文。Cavecrew 的输出是结构化的,有时精简到近乎天书。如果要直接给人看,请自行改写。
自动切回清楚模式(继承)
Subagent 遇到安全性警告、不可逆操作的确认,以及任何碎片式表达可能被误读的输出时,会放下 caveman 改用正常英文。之后恢复 caveman。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |