Skip to content

Agent Collaboration zh CN

ChrAlpha edited this page Nov 12, 2026 · 11 revisions
🇬🇧English | 🇨🇳中文

Agent 协作

Agents 从各自的 tools 中运行相同的 CLI 命令。tmag 通过 process table 识别调用者,与识别 pane 对应 session 的方式一致:如果命令的祖先进程包含某个 agent 进程,调用者就是该 agent。

具体 session 则从该进程承载的 sessions 中确定:使用 agent 为 tools 设置的变量(CLAUDE_CODE_SESSION_ID、CODEX_THREAD_ID,Pi 和 oh-my-pi 中为 PI_SESSION_ID)区分,或在只有一个 session 时直接确定。环境变量本身不能作为证明。无法确定 session 时,tmag 只能确认 agent 身份。tmag list 会标记调用者自己的 session;--json 通过 caller 返回调用者信息。

每个 Send、Halt、Answer 都记录来源:from 表示调用命令的 pane,by 表示调用命令的 agent。Agent 对自己的 session 执行控制命令会被拒绝,代码为 self,因为要发送 prompt、中断或回应的 turn 正是当前运行命令的 turn。

回应请求相当于代用户作决定,因此只有 @tmag-answer 为 agents 时,agent 才能回应;否则返回 agent。这避免 agent 意外批准自己或其他 agents 的请求,日志也会记录每次决定。这不是 security boundary:agent 仍可通过 tmux 本身向任意 pane 输入。

Agent 需要先知道这些命令,才会使用它们。缺少相关说明时,收到“联系另一个 agent”的要求,它们可能用 tmux send-keys 输入,并从屏幕判断状态。tmag-peers 插件负责提供这部分说明。

它的 peers skill 说明何时查看和操作另一个 agent、可用命令,并要求只通过 tmag 与 agents 对话:tmux 负责开窗口,tmag 负责与 agent 对话。Agent 在用户要求它让另一个 agent 参与时查看 peers,或在出现 peer 与自己共享工作的信号时查看:出现了不是它做的改动,或它即将切换分支、改写历史、停止进程。它从不例行检查 peers。它在用户要求时、在 peer 于用户授权的工作范围内发来请求时操作 peer,或主动解决与同一仓库中 peer 的冲突:保留 peer 的改动,告知用户,仅当一条简短消息就能解决冲突时才向它发送消息(tmag send)。拒绝或出错后该怎么做由 tmag 自己给出,在错误之后以 next: 开头的那一行。Claude Code 插件会将 tmag 加入 agent 的 PATH;Codex、Pi 和 oh-my-pi 的 skill 则从自身目录运行 launcher。无论哪种方式,最终调用的都是 hooks 使用的同一个 binary。

用户要求的 peer 尚未运行时,agent 会在一个独立的 tmux window 中启动它——用户可以随时查看和接管——之后像对待其他 peer 一样与它协作:

pane=$(command tmux new-window -d -P -F '#{pane_id}' -c "$PWD" claude)
tmag wait "$pane" --for idle --timeout 2m
tmag send "$pane" --reply - <<'EOF'
Review the parser in internal/parse.go and list the bugs you find.
EOF

对该 pane 执行 tmag wait 会一直等到新 agent 显示出自己的 session;Claude Code、Pi 和 oh-my-pi 启动时即会显示。Codex 从第一个 prompt 起才显示 session,因此以任务作为参数启动它,待其 idle 后发送方用 tmag read --last 读取回答。

Prompt 本身不带可信的发送者信息。因此 agent 发送 prompt 时,tmag 根据已证明的调用者身份写入第一行,说明发送它的 agent、session 及回复方式。没有 skill 的 agent 也能遵循:

[tmag] From claude 1787a44e-…, another agent. Answer in your final message.
[tmag] From claude 1787a44e-…, another agent. When done, send your answer on stdin to: tmag reply 1787a44e-… -
[tmag] From claude 1787a44e-…, another agent. No answer needed.
[tmag] Reply from codex 01a19fda-…, another agent, to your prompt. Do not reply to it.

第一种由 send --wait 写入:发送方等待该 turn,再用 read --last 读取回复。第二种由 send --reply 写入:发送方结束自己的 turn,将回复作为下一个 prompt 接收。第三种由不带参数的 send 写入:用于 peer 现在就该知道的事,不要求回复。第四种由 tmag reply 写入。

传给 send 或 reply 的 prompt 不能以 [tmag] 开头,否则是 usage error。因此,经 tmag 投递且第一行以该标记开头的 prompt,其发送者信息由 tmag 根据已证明的 agent 身份生成。用户发送的 prompt 不加这一行。装有 skill 的 agent 会将其视为同事的请求;对以 No answer needed. 结尾的第一行,会将其纳入考虑但不作回复;也不再回复一条 reply。这套保证只适用于 tmag 投递的 prompts;它不构成对其他输入方式的 security boundary。

不带参数的 send 会通过 peer 自己的渠道——inbox,或 Codex daemon 的 control socket——立即送达,无论其状态如何:idle agent 会用它启动一个 turn,working agent 会在下一个步骤读到该 prompt。仅当 session idle 且无法证明其 inbox 时,才回退到 pane。按需要的回应方式选择:tmag send ID - 用于 peer 现在就该知道的事,会收到 No answer needed. 第一行;send --reply 用于长时间工作,回复稍后作为 prompt 到达;send --wait 用于简短问题,要求 peer 处于 idle,并启动一个属于它自己的 turn。Claude Code 会把每条 inbox 消息标记为来自另一个 session,并应用自己的 inbound 控制:绕过 permission prompts 的 session 会把已发送的 prompt 暂留给用户,除非其 crossSessionInbound 为 accept;tmag 只报告消息已写入。

tmag reply 写入 reply 行,并通过请求方自己的渠道——inbox,或 Codex daemon 的 control socket——立即送出,无论其状态如何。只有 pane 的请求方会在 idle 时通过其 pane 接收;该请求方忙碌时,tmag reply 仅针对 busy 拒绝重试,直到 --timeout(默认一分钟)。超时以 4 退出,并说明是否已投递:拒绝或渠道明确未接收都证明什么都没投递,可以再次运行;其他错误则结果未知,不得再次发送。只有 tmag 能证明其 session 身份的 agent,才可以发送 reply。

Clone this wiki locally