ㅤ	s06 子智能体	s15 智能体团队	本文的 Supervisor
手下是谁	临时工，干完就散	一直在的同事	临时工，干完就散
怎么交流	只回传最后一句结论	文件收件箱，发消息 = 追加一行	只回传最后一句结论
同时干几个	一个	多个线程并行	一个，排队派
能不能再往下派	不能	只有 Lead 能招人	不能
代码量	303 行，7 个工具	786 行，14 个工具	88 行，2 个工具

所以本文的 Supervisor = s06 的派活方式 + s15 的 Lead 角色，砍掉并行和收件箱。

s06 里有个比方：子智能体就像开一个新终端去追一件事，追完关掉，结论写进笔记。

主管拿到的只有那条笔记，不是整个终端的滚动记录。

回传整个对话列表，等于没隔离。

手下的每一条命令输出都会塞进主管的上下文，派不了几次活就装不下了。

二、动手：88 行写个最小 Supervisor

要什么：

Python 3.10 以上（最新版 anthropic SDK 要求 3.10）

一个 Anthropic API Key，在 console.anthropic.com 申请

一个空目录（worker 会在里面真的写文件、跑命令）

下面的命令按 Mac 写，一行一行贴进终端：

.venv 是隐藏目录，ls 看不到，不影响 worker 干活。

export 只对当前这个终端窗口有效。

关掉窗口再开，要重新 cd sv-demo、source .venv/bin/activate、export 一遍。

走中转或者国内兼容服务的，再加两行：

地址和模型名去哪找：learn-claude-code 仓库的 .env.example 里列了 GLM、Kimi、DeepSeek、MiniMax 几家。

兼容服务在工具调用的细节上可能和官方有出入。想要最稳，用官方的。

然后建文件，推荐用 VS Code：新建一个文件，存到 sv-demo 目录，文件名 supervisor.py。

用 Mac 自带的「文本编辑」也行，先按 ⇧⌘T 转成纯文本再存，不然存出来是富文本，Python 读不了。

代码如下，整段粘进去（需修改密钥 deepseek为例）：

一共五块，对着系列看：

① WORKERS

手下就是一段岗位说明。加一个人，加一行。

② 两个工具

对应 s02。工具 = 一份说明书（给模型看）+ 一个函数（给代码跑）。

handlers 这个字典，就是把工具名和真正要跑的函数对应起来。

③ agent_loop

就是 s01 那个循环，多了一个 max_turns 上限。

主管和 worker 都调它，只是传进去的岗位说明、工具不一样。

④ run_worker

s06 的三个要点都在这：

每次派活，都是全新的 messages

只把最后一句文字结论回给主管

worker 的工具里没有 delegate，不会一层套一层往下派

⑤ SUPERVISOR

主管的工具只有 delegate。

不给它 bash，它就只能派活。

整份代码最关键的，是 run_worker 里那个 [BASH]——它决定了谁能干活、谁只能管人。

三、跑起来

先确认三件事：人在 sv-demo 目录里，提示符前有 (.venv)，ls 能看到 supervisor.py。

中途想停，按 Ctrl + C。

提示符出来后，给一个有「写」有「测」的目标：

fizzbuzz.py 脚本解释：

FizzBuzz 就是一个口头报数游戏，现在则是计算机编程领域最经典的初级面试编程题之一

游戏与题目规则

从 1 开始依次往下数数（通常数到 100）：

当数字是 3 的倍数时，不读数字，改读 "Fizz"；

当数字是 5 的倍数时，不读数字，改读 "Buzz"；

当数字同时是 3 和 5 的倍数（即 15 的倍数）时，读 "FizzBuzz"；

如果以上条件都不满足，就直接读出这个数字本身。

输出示例

从 1 数到 15 的部分结果如下：

1, 2, Fizz, 4, Buzz, Fizz, 7, 8, Fizz, Buzz, 11, Fizz, 13, 14, FizzBuzz

屏幕上会交替出现两种行：

[派活] coder: ……——主管把活拆好，派了出去

[汇报] coder: ……——worker 干完回的那一两句话

最后一行 [交差]，是主管给你的总结。

每次跑，拆法和措辞都不一样，这是正常的。

要看的是流程：先派 coder，再派 tester，tester 说没过就再派回 coder。

跑完 ls 一下，fizzbuzz.py 会真的在目录里。

想看「验收打回」这一步，就故意给个容易写错的要求。比如「15 的倍数打印 FizzBuzz，但 30 要打印 Thirty」。

本人运行文件输出效果如下：

一次运行，背后发生了什么

对着代码走一遍：

你输入目标，supervise() 把它当成主管对话的第一句

主管问模型。模型手里只有 delegate，就回一个派活请求：派给 coder，附上一段任务说明

代码执行 run_worker，屏幕打出 [派活]

coder 拿到一段全新的对话，里面只有那句任务说明。它在自己的循环里调 bash：写文件、跑文件、看输出

coder 不再要 bash，最后那段文字就是汇报。屏幕打出 [汇报]，这段话塞回主管的对话

主管再问模型。这次多半派给 tester，流程同上

tester 说没过，主管把失败原因写进新的 task，再派给 coder

主管不再调 delegate，最后那段文字就是 [交差]

主管从头到尾只看到三样东西：你的目标、它自己派出去的 task、worker 的汇报。

worker 跑过的每条命令、每段输出，主管一条都看不到。

跑通之后，先做这三件事

第一件：看 worker 到底敲了哪些命令。

在 run_bash 函数的第一行加一句：

再跑一次，[派活] 和 [汇报] 中间会多出 worker 敲过的每条命令。

第二件：加一个手下。

在 WORKERS 里加一行：

delegate 能派的 worker 列表（代码里那个 enum），是从 WORKERS 自动生成的，加人不用改它。

但 SUPERVISOR 第一句写着「手下有两个 worker」，要一起改成三个，写上 reviewer 是干嘛的。不改，主管多半想不起来派给它。

第三件：换个目标再跑。

比如「写一个 word_count.py，统计一段英文里每个词出现几次，再让 tester 验证」。

看主管怎么拆：先写还是先定测试，tester 打回几次。

四、常见坑

坑一、worker 不记得上一次。

每次派活都是全新的 messages，这是隔离的代价。

tester 打回后，主管如果只说「再改改」，coder 根本不知道改什么、改哪个文件。

所以 SUPERVISOR 里那句「把失败原因转给 coder」不能省。每次派活写的那段说明，要写成一个新人也看得懂的样子：文件名、哪里错、期望什么。

坑二、worker 回了一句空话。

worker 最后一轮只调了工具、没留文字，主管就收到一个空字符串，接着瞎猜。

代码里用 "(worker 没留话)" 兜了底，岗位说明里也要求「做完用一两句话汇报」。

两头都要有。

坑三、不设轮数上限。

模型偶尔会绕圈：改一下，跑一下，再改一下。

没有上限，它会一直跑，一直扣钱。

主管 10 轮、worker 20 轮，按任务大小调。s06 的教学代码给子智能体设的是 30 轮。

坑四、给主管也配了 bash。

图省事给主管加个 bash，它多半就自己下场写代码了——派活要写说明、等汇报，不如自己动手快。

Supervisor 之所以是 Supervisor，靠的是手里没有干活的工具，不是 prompt 里写一句「你不要干活」。

坑五、DANGER 黑名单挡不住所有危险命令。

rm -rf 拦住了，rm -r -f 就没拦住。

字符串黑名单只是演示 s03 那道门长什么样，不是安全方案。

一定在空目录里跑。要放进真项目，至少上容器，或者看 s18 的工作树隔离。

坑六、钱是按调用次数一次次算的。

主管每派一次活，worker 那边就是一整个循环。每一轮都是一次完整的 API 调用，对话越长，每次带的上下文越多。

最坏情况：主管 10 轮 × worker 20 轮，一个目标能跑出上百次调用。

练手可以换便宜的模型：export MODEL_ID=claude-sonnet-5。

报错速查

跑不起来，先对一下这张表：

屏幕上看到的	原因	怎么办
`zsh: command not found: python`	Mac 默认只有 python3	先 `source .venv/bin/activate`，或者改用 `python3`
`ModuleNotFoundError: No module named 'anthropic'`	SDK 没装，或装进了别的 Python	确认提示符前有 `(.venv)`，再 `pip install anthropic`
`Could not resolve authentication method`	没设 key，或者换了新的终端窗口	重新 `export ANTHROPIC_API_KEY=…`
`Error code: 401`，带 `authentication_error`	key 填错，或者 key 和 BASE_URL 不是同一家	去控制台重新复制 key
报错里提到 model	对方不认这个模型名	`export MODEL_ID=对方支持的模型`