并行运行智能体
Codewhale 可以把一块聚焦的工作交给子智能体,自己继续往下做。当一个任务能拆成彼此独立的几部分——梳理代码库、审查改动、跑测试——时,用这种方式让它们同时进行。
直接提出来
启动子智能体不需要命令,用平常的话提出来就行。在 Operate 模式下,Codewhale 会自己把独立的步骤分派出去;在 Work 模式下,说清楚你想怎么拆分:
Use three explore agents in parallel: one maps the auth code,
one maps the billing code, one lists the tests that cover both.
Then summarize what would break if we changed the session format.每个子智能体都在后台启动,完成后回报结果。你的输入框始终可用,主回合会接着处理这些结果。
选择角色
角色决定了子智能体如何做事。你可以在请求里点名,也可以让 Codewhale 自己选。子智能体拿到的权限永远不会超过你当前会话的权限。
general- 按任务说明做事,可以修改文件、运行命令。默认角色。
explore- 只读。快速梳理相关代码——比如“找出这个函数的所有调用方”。
planner- 设计方案,不做任何改动。
reviewer- 阅读并评估一处改动,为每个发现标注严重程度。
implement- 用最小的修改落实一项具体改动。
test- 运行测试和检查,报告通过或失败。不修改代码。
advisor- 针对需要判断的问题,给出简短而审慎的第二意见。不运行命令。
custom- 只能使用你列出的工具,适合权限需要严格收紧的任务。
想让某个角色固定使用某个模型,用 /fleet setup 保存——见运行工作流。
让并行修改互不干扰
如果两个子智能体会修改同一个仓库,请让它们各自在自己的工作树里工作。Codewhale 会在你的仓库旁边的 .codewhale-worktrees/ 下,为该智能体创建新的 git 工作树和分支;在你合并之前,你的工作副本保持干净。
工作树只是隔离,不代表授权:需要写入的智能体仍然要有可写的角色,以及允许修改的路径。两个智能体如果声明要改同一批文件,会在任何一方动手之前就被拦下。
查看进度并回应它们
/subagents/subagents(与 /fleet workers 是同一个视图)会列出挂在本次会话上的智能体,以及每个智能体正在做什么。选中一个即可阅读它的对话记录。
子智能体遵循你的审批设置。在 Ask 下,需要审批的调用会像普通提示一样出现在你的会话里,智能体则在一旁等待;在 Auto-Review 下,每个被拦下的调用都会经过同样的独立审查,不会打扰你。凡是不是由你亲自做出的决定,都会写进该智能体的对话记录。
了解上限
- 同时运行
- 默认 64 个。可在
~/.codewhale/config.toml中设置max_subagents(最多 128)。 - 排队加运行
- 最多 1,024 个;超出的启动请求会排队等待。
- 嵌套
- 子智能体也可以再启动子智能体,默认最多三层,绝不超过八层。
这些只是上限,不是目标。少量边界清晰的智能体加一份清楚的汇总,胜过一大堆彼此重叠的智能体。如果工作需要在重启或笔记本休眠后继续,请改用 Fleet 运行。