Sub-Agents

“小帮手”就像你派出去的一个小机器人，它从主助手那里领一个任务，然后自己悄悄去完成。它有自己的小房间（叫做会话），干完活后会回到主助手这里，把结果“报告”出来。

怎么指挥小帮手？

在聊天的地方输入 /subagents 这个魔法口令，后面加上不同的词，就能指挥小帮手了。这些口令只对当前这个主助手有用哦。

1. 看看有哪些小帮手：输入 /subagents list，就像点名一样，看看谁在干活。
2. 让小帮手停下来：输入 /subagents kill，后面加上小帮手的编号，或者 # 号，或者 all（全部）。小心哦，停掉一个小帮手，它派出去的小小帮手也会一起停掉。
3. 看看小帮手在做什么：输入 /subagents log，后面加上小帮手的编号，就能看到它最近说了什么、用了什么工具。
4. 了解小帮手的信息：输入 /subagents info，后面加上小帮手的编号，就能知道它的状态、什么时候开始、什么时候结束这些信息。
5. 给小帮手发消息：输入 /subagents send，后面加上小帮手的编号和你想说的话。
6. 给小帮手指方向：输入 /subagents steer，后面加上小帮手的编号和你的指示。
7. 派一个新小帮手去干活：输入 /subagents spawn，这是最重要的口令！后面要告诉它用哪个助手（<agentId>）和做什么任务（<task>）。你还可以加 --model 让它用更便宜的“大脑”，或者加 --thinking 调整它想问题的仔细程度。

怎么派一个小帮手出去？

用 /subagents spawn 这个口令。派它出去后，你马上就能拿到它的编号，然后可以继续聊天，不用等它。

• 小帮手干完活后，会回到你派它出去的聊天窗口，报告一个结果总结。
• 报告里会告诉你任务结果是成功还是失败了，用了多长时间，花了多少“脑力”（token）。
• 你可以用 --model 和 --thinking 让这个小帮手用和主助手不一样的设置。
• 派出去的小帮手只干一次活（mode: "run"）。如果你想让它在一个专门的“小房间”（线程）里一直待命，需要用另一个工具 sessions_spawn。

要记住的事情：

• 每个小帮手都要用自己的“脑力”（token），这是要花钱的。所以可以让小帮手用便宜一点的“大脑”（模型），让主助手用聪明但贵一点的。
• 小帮手默认是“隔离”的，它不能直接用主助手的工具，这样更安全。

让小帮手待在专门的“小房间”里（线程绑定）

在一些聊天软件里（比如 Discord），你可以让小帮手待在一个专门的“小房间”（线程）里，这样你在这个小房间里说的话，都会自动发给这个小帮手。

1. 怎么创建：需要用 sessions_spawn 这个工具，并且告诉它 thread: true。
2. 怎么管理：在小房间里可以用这些口令：
   • /focus <目标>：把这个小房间绑定到一个小帮手或会话上。
   • /unfocus：取消绑定。
   • /agents：看看有哪些助手在活动，以及它们绑在哪个小房间。
   • /session idle 和 /session max-age：设置小帮手多久不活动就自动离开，或者最多能待多久。

小帮手能再派小小帮手吗？（嵌套）

默认不行，一个小帮手不能自己再派小帮手。但你可以打开一个开关，允许“两层”结构：主助手 → 指挥员小帮手 → 干活的小小帮手。

• 怎么打开：需要在设置里把 maxSpawnDepth 改成 2。
• 它们怎么报告：小小帮手干完活，报告给指挥员小帮手；指挥员小帮手汇总后，再报告给主助手。
• 谁能派小帮手：只有主助手和指挥员小帮手（深度1）可以派。小小帮手（深度2）不能派。
• 数量限制：每个助手会话最多只能有5个活跃的小帮手（可以改这个数字）。
• 一起停止：如果停止一个指挥员小帮手，它派的所有小小帮手也会一起被停止。

小帮手能做什么？（工具策略）

默认情况下，小帮手不能使用管理会话的工具（比如 sessions_spawn）。 但是，如果你打开了“两层”嵌套，那么指挥员小帮手（深度1）就可以使用 sessions_spawn、subagents 等工具来管理它的小小帮手了。

一些限制和要注意的

• 小帮手的报告是“尽力而为”的。如果系统重启，正在路上的报告可能会丢失。
• 小帮手和主助手在同一个地方干活，所以别派太多，系统会忙不过来。默认最多同时有8个小帮手在跑。
• 小帮手最多只能嵌套5层，但通常用2层就够啦。
• 小帮手有自己的“记忆”文件（只注入 AGENTS.md 和 TOOLS.md），没有主助手那么全。