用途：通过 wsh 会话启动并驱动其他具备终端界面的 AI 代理（如 Claude Code、Aider、Codex），实现并行运行、任务委派、专业化分工与自动化编排。
主要能力：创建以代理为命令的会话，或先开 shell 再交互式启动代理；识别代理生命周期（启动、思考、工作、审批、等待）与状态；处理审批提示（全自动、选择性批准、拒绝并重定向）；阅读屏幕与回滚内容进行输出审查；多代理轮询监控、结果传递和集成；使用 git worktree 或独立目录/分支做工作区隔离。
使用方式：若有 wsh_* 工具则直接调用（如 send input 对应 wsh_send_input）；若无则进入 HTTP/curl 回退模式，需先加载 skills/core/ 中的 SKILL.md 获取完整 API 参考，不要猜测端点或 CLI 子命令。可用命令示例：create session "agent-auth" with command: claude --print "..."；或 create session "agent-auth"、send: claude、wait for idle、read screen。健康检查：curl -sf --unix-socket ${XDG_RUNTIME_DIR:-/tmp}/wsh/default.http.sock http://localhost/health；失败则执行 wsh server -L agent-$$ --ephemeral & 后重试。代理间不能直接通信，可用文件系统传递产物。
适用场景：需要并行处理多个独立子任务、将大项目拆分为可委派子任务、为不同工作选择不同代理、或构建无人值守工作流时。
限制：思考阶段可能长时间无输出，需用 10-30 秒较长空闲超时并轮询屏幕，避免误判卡死；重复轮询可用 last_generation 或 fresh=true 防止忙循环。不要过度并行，建议从 2-3 个代理起步。同一仓库未隔离会导致代理互相干扰，必须隔离。注意死循环、审批安全（仅在隔离低风险任务使用跳过权限，切勿用于生产系统）以及结束后清理会话、worktree 和临时文件。任务紧密耦合时，单个上下文充分的代理通常优于多代理并行。