Codewhale 文档
版本最新发布 v0.10.1 · 2026年10月8日本站文档描述的是尚未发布的 v0.10.2 源码候选版。更新日志 →

并行运行智能体

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 运行。

下一步

运行工作流

把反复使用的计划写成工作流,分阶段执行,每次运行都有记录。

跟踪进度

To-do 列表如何显示已完成、进行中和剩余的工作。

查看改动

在保留之前,先检查这些智能体改了什么。