orchestrate

Superset Orchestration 是一套面向并行编码智能体的协调协议。Superset 提供会话传输层，协调者负责维护任务依赖与完成状态。

用途

当多个编码智能体需要同时工作、彼此存在依赖关系、又要在进度与结果上保持清晰追踪时，使用该协议。协调者可在一个或跨多个 workspace 中分发任务，读取各 worker 的进展，发送补充信息或反馈，并在任务完成或阻塞时推进流程。它适合并行开发、依赖拆解、只读分析与结构化交接等场景。

控制接口校验：通过 superset auth whoami --json 与 superset schema 检查可用命令；缺少命令时运行 superset update 后重新检查，并回退到 terminals read 与 send。
资源解析：用 superset hosts list、agents list、workspaces list 确定目标 workspace、host 与支持终端的智能体；远程主机离线时用 hosts wake 唤醒。
任务规划：以协调者任务表记录任务标识、依赖、workspace、host、terminal sessionId、状态（pending/ready/running/completed/blocked/failed）与结果。
任务分发：用 superset agents create 启动终端智能体，保留返回的 sessionId；需要隔离分支时先创建 workspace。
监控与通信：用 terminals list 重新获取终端 ID，用 terminals read 读取输出，用 terminals send 发送追问（--wait 可等待本轮结束），用 --keys 应答权限提示或中断，用 terminals wait 匹配屏幕正则。
等待与总览：superset agents wait --until settled 等待 worker 结束本轮或需要输入；superset snapshot 一次查看主机上所有 worker 状态；superset agents explain 解释状态原因。
结果交接：要求 worker 以 SUPERSET_WORKER_DONE 或 SUPERSET_WORKER_BLOCKED 标记收尾，协调者核对证据后才更新任务状态。
收尾与通知：用 notifications show 发送桌面通知，用 pages publish 发布运行总结页（需用户同意），用 terminals close 关闭终端。

运行认证与 schema 检查，确认 terminals 的 list、read、send、close 可用。
解析 host、agent 与 workspace；在目标 workspace 内部协调时显式传入 --workspace "$SUPERSET_WORKSPACE_ID"，远程主机统一传 --host。
建立协调者任务表，保持依赖链尽量浅，并行编辑优先使用独立 workspace 或分支。
为每个 worker 编写有界提示：任务 ID 与目标、可修改的文件范围、验收标准与验证命令、依赖或前置结论、不得扩大范围的警告、完成标记格式。
用 superset agents create 启动所有就绪且独立的任务，确认返回 kind 为 terminal 并保存 sessionId。
用 terminals read 或 agents wait 跟踪进度，按需发送追问、依赖结果或评审意见。
仅在读到完成标记并核实证据后标记完成；遇到阻塞标记时先解决需求或询问用户再重新分发。
汇总每个任务的结果、workspace/分支、改动文件、检查项、阻塞与集成顺序，区分 worker 声明与协调者独立执行的检查。

适合需要多个编码智能体并行推进、存在任务依赖、要求结构化回报与交接的工程工作流；也适合只读并行分析，或在桌面应用中以 pane 布局观察多个 worker。

hosts add、terminals send --keys、terminals wait、terminals attach、panes、notifications show 等命令晚于 CLI 1.37.0；更新后仍缺失则跳过并回退。
hosts add 会改动目标机器，须先获用户同意并确认 SSH 可用；远程需 macOS 或 glibc Linux（x64/arm64，非 Alpine 或 Windows）、curl，Linux 还需有效的 /etc/machine-id 与 systemd 用户服务。
不要使用 --agent superset，因为它创建聊天会话，终端读写无法控制。
完成标记是提示约定，不是持久事件；格式错误或缺失时按非结构化输出处理并检查完整快照。
terminals list 只反映会话存在，不能据此推断智能体是否工作或空闲。
Superset 不会自动合并 worker 分支；组织任务不是编排 DAG 节点，除非用户要求否则不应创建或修改。
关闭终端会结束会话，删除 workspace 是独立的破坏性操作，需要明确授权。
页面发布默认对组织可见且持久，发布前须征得用户同意。

暂未提供。