Skip to content

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".

FileKindSize
README.mdmarkdown3.0 KB
SKILL.mdskill md4.0 KB
# cavecrew

判断指南。什么时候该把工作委派给 caveman subagent,而不是自己 inline 做完。

## 这个 skill 做什么

告诉主线程什么时候该派 caveman 风格的 subagent、什么时候用原版的对应 agent。收益在于:subagent 的 tool-result 会原封不动塞回主 context,而 caveman 输出大约只有原版散文的 1/3。一个 session 里委派 20 次,这就是“context 爆掉”跟“任务做完”的差别。

三个 subagent:

| Subagent | 工作 | 什么时候用 |
|----------|-----|----------|
| `cavecrew-investigator` | 定位代码(唯读) | “X 定义在哪/谁调用 Y/列出 Z 的所有用处” |
| `cavecrew-builder` | 外科手术式编辑,1-2 个文件 | 范围明确,≤2 个文件。3 个以上直接拒绝。 |
| `cavecrew-reviewer` | 审 diff/单文件 | 一行一个发现,附严重度 emoji |

想要散文、架构评论或推理过程时,用原版的 `Explore` 或 `Code Reviewer`。一行就能回答的问题、以及 3 个文件以上的重构,直接用主线程。

这个 skill 是判断指南,不是 slash command。对话中提到委派时就会激活。

## 怎么调用

由 "delegate to subagent"、"use cavecrew"、"spawn investigator"、"save context"、"compressed agent output" 这类说法触发。

## 串接范例

定位 → 修 → 验(最常用):

1. `cavecrew-investigator` 返回位置清单(`path:line — symbol — note`)
2. 主线程挑 1-2 个位置,把路径交给 `cavecrew-builder`
3. `cavecrew-reviewer` 审计产出的 diff

平行侦察:在同一则消息里同时派 2-3 个 `cavecrew-investigator`,各自负责不同角度(定义、调用端、测试)。在主线程汇整。

## 模型覆写

缺省情况下,`cavecrew-reviewer` 与 `cavecrew-investigator` 的 frontmatter 钉死 `model: haiku`;`cavecrew-builder` 没有 `model:` 这行(沿用 API session 缺省)。启动 Claude Code 前在 shell 设环境变量,即可逐一覆写:

| 环境变量 | Agent |
|---|---|
| `CAVECREW_REVIEWER_MODEL` | `cavecrew-reviewer` |
| `CAVECREW_BUILDER_MODEL` | `cavecrew-builder` |
| `CAVECREW_INVESTIGATOR_MODEL` | `cavecrew-investigator` |

范例——reviewer 跑 sonnet,其余维持缺省:

```sh
export CAVECREW_REVIEWER_MODEL=sonnet
```

模型名称字符串跟你在任何 Claude Code agent frontmatter 里写的一样(例如 `haiku`、`sonnet`、`opus`)。

覆写只会 patch 已安装 agent frontmatter 里的 `model:` 那一行;prompt 本体不动,仍会持续收到上游更新。仅限 plugin 安装方式——纯 hook 安装没有本地 agent 文件可以 patch。未设置或留空 = 不变更。这个 patch 会留在已安装的文件里,直到 plugin 更新或重装为止。

## 延伸阅读

- [`SKILL.md`](./SKILL.md) — 完整决策矩阵与输出契约
- [`agents/cavecrew-investigator.md`](../../agents/cavecrew-investigator.md)
- [`agents/cavecrew-builder.md`](../../agents/cavecrew-builder.md)
- [`agents/cavecrew-reviewer.md`](../../agents/cavecrew-reviewer.md)
- [Caveman README](../../README.md) — repo 总览
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: 472kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall