第16章 并行运行 Agent · Codewhale 文档

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