[Design/Prompt] Agent Teams：policy 要求 Lead 必须等 teammate，却没告诉它可以结束本轮并被唤醒（subagent 段落指引相反）

[Pankeyi88]

环境：dsh 0.2.2-rc.1（npm latest），Windows 11，PTC preset；@deepseek-ai/dsh-experimental-tool-agent-team 0.2.2-rc.1；Lead 与 teammate 均为 deepseek-flash。

摘要
注入的 team:policy（dsh-experimental-tool-agent-team/lib/index.js:29）最后一句是：

The Lead must wait for required teammates before giving the final answer.

而 wait_agent 的描述又是"等下一个变化，然后重新列状态"。于是当 teammate 还在运行时，Lead 唯一"合规"的行为就是阻塞在 wait_agent 里。policy 从未提到运行期会在下级结算时唤醒空闲父级；而 subagent 段落写的恰好是相反的指引：

When only waiting for their results remains, end your turn instead of sleeping or polling; the next result starts a new turn.
（dsh-tool-subagent/lib/index.js:507）

运行期事实（prompt 里没有）

• SubagentManager.notifySettlement 会把结算通知投给父级；父级空闲时 sendWaking 会开启一轮（dsh-subagent/lib/index.js:2060-2075）。也就是说，Lead 结束本轮后，teammate 完成时会被叫醒。
• teammate 的状态边也会唤醒 wait_agent（agent/status → activity.notify，dsh-experimental-agent-team/lib/index.js:1477-1480）。

真实会话的代价（脱敏，同一编排会话）

• 3 个 teammate，墙钟约 3 小时，5 turns / 170 steps。
• 50 个含 wait_agent 的 run_code：31 次 timedOut:true（等满）、18 次被某个变化唤醒、1 次撞 PTC deadline。
• 请求等待合计约 4785 秒；timeout 取值明显在贴合 PTC 预算（默认 120s 时用 60/75/80/90/100/110 秒）。
• 第一次等待前，模型自述："Let me check on teammates status and their messages. Let me list agents and wait."

期望

1. 如果"结束本轮、被结算通知唤醒"对 team 也成立，请写进 policy（并把结算通知里的 child session id 换成 teammate 名字；roster 只暴露名字，收到通知的 Lead 无法按名字对应）。
2. 或者明确写："wait_agent 只用于本轮内必须处理的变化；只需要等完成时结束本轮，会被唤醒。"
3. 可以考虑谓词形式 wait_agent({ target, until: "inactive" })，省掉 re-list 轮询。
4. 如果 must wait 是有意设计（Lead 必须同轮汇总），也请在文本里说明理由，并与 subagent 段落保持一致。

相关讨论

• [Bug] PTC: run_code 内嵌套 wait_agent 的超时被执行期限截断，等待结果被丢弃（wait_agent 允许 1h，run_code 上限 10min） #12989：本仓库另一个相关的 PTC 问题——run_code 内嵌套 wait_agent 的超时被执行期限截断
• 【反馈】实测智能体团队会话耗时过长-当前版本：0.2.0-rc.2 #9158：实测团队会话 153 分钟，长杆就是 wait_agent（Lead 72/98 工具分钟），未给根因
• 显式要求「等结果就结束本轮」后，模型仍会反复轮询子代理并把它停掉 #12565：即使用户明确要求"等结果就结束本轮"，模型仍会反复轮询子代理——说明只加一句指引可能不够
• [Bug] wait_agent 阻塞期间用户消息静默排队 26 分钟，无提示也无法让路 #12208、[需求] 等待子智能体时，也应及时处理用户的新消息（wait_agent / Steer） #9214：wait_agent 阻塞期间用户消息无法处理；希望 steer 能结束等待
• Subagent tool description says "returns its result" but the call returns immediately (non-blocking) — and spawn_teammate never says it does not block #10854：subagent 描述宣称同步返回结果；[bug] Agent Teams 与直接委派共存：list_agents 同名冲突、wait_agent 语义错位（附可复现证据与补丁） #9523、[Bug] Agent Teams bundle 在 Web/Desktop 未禁用 subagent：子代理不在 Team roster，list_agents/send_message 找不到也联系不上 #7642：team 与 subagent 工具语义重叠/误配
• [bug][goal机制的设计问题] goal机制在主agent等待subagent时会无脑不断触发唤醒主agent, 根本不管当前subagent在途的情况 #9429：/goal 在 subagent 在途时仍唤醒主 agent