用途
本技能用于借助 Superset 的 workspace、agent 与 terminal 命令,协调多个终端编码代理并行工作。它采用“协调者驱动”的协议:Superset 只负责会话传输,任务的依赖关系与完成状态由协调者自己维护。
主要能力
- 建立控制面:通过
superset auth whoami --json检查登录状态,通过 schema 或--help确认terminals下的 list、read、send、close 命令可用;缺失时先superset update再复查,不自行编造不支持的编排命令。 - 解析目标:用
superset hosts list --json、superset agents list --local --json、superset workspaces list --local --json确定工作区、主机和可用的终端代理。远程主机离线时可用hosts wake唤醒;对可通过 SSH 访问的机器可用hosts add安装并登录 CLI(需用户同意,且在远端满足 macOS 或 glibc Linux、curl、Linux 需有效/etc/machine-id与 systemd 用户服务等条件)。 - 规划工作:维护一张协调者表格,字段包括任务标识、依赖、工作区、主机、终端 sessionId、状态(pending、ready、running、completed、blocked、failed)和结果。建议使用独立任务与浅依赖链;并行编辑时各 worker 使用独立工作区或分支。
- 定义 worker 协议:给每个 worker 一个有边界的提示,包含任务 ID 与目标、可改动范围、验收标准与验证命令、依赖或先前结论、不得扩大范围或覆盖无关改动的警告,以及完成信封(
SUPERSET_WORKER_DONE/SUPERSET_WORKER_BLOCKED)。这些标记只是提示约定,不是 Superset 的持久事件。 - 派发 worker:用
superset agents create启动终端代理并保留 sessionId;需要隔离分支时先用superset workspaces create。 - 监控与沟通:用
terminals list重新获取终端 ID,用terminals read读取最近输出,用terminals send发送追问、依赖结果或评审意见;权限提示可用--keys enter批准,--keys esc中断;可用terminals wait --match等待屏幕上的特定内容,用agents wait --until settled等待代理回合结束,或用superset snapshot一次查看所有 worker。桌面应用中可用panes命令布局查看。 - 推进流程:仅在读取到 DONE 信封并核实证据后标记完成;收到 BLOCKED 时解决需求或询问用户后再派发;依赖全部完成才把 pending 提升为 ready;失败任务需先调整提示、输入或 worker 选择再重派,反复失败则上报。
- 收尾:汇总各任务结果、工作区/分支、改动文件、检查项、阻塞与集成顺序,区分 worker 声明与协调者独立验证的结果;可用
notifications show发送桌面通知,经用户同意后可用pages publish发布运行摘要页面;仅在需要清理时用terminals close关闭终端。
使用方式
以协调者身份按上述顺序操作:先检查认证与命令可用性,解析工作区和主机,建立任务表,为每个 worker 编写有边界的提示并派发,然后轮流等待各运行中的 worker 并读取输出,依据信封更新状态,最后汇总并清理。协调者自身应保留任务到终端的映射,避免只凭终端是否存在推断完成状态。
适用场景
适合需要把较大改动拆分成多个相对独立任务、并行推进的编程工作,例如同时修改互不重叠的文件、并行分析、以及带依赖顺序的多步实现流程。
限制
- 需要特定版本的 Superset CLI;部分较新命令(如 hosts add、terminals send --keys、terminals wait、terminals attach、panes、notifications show)在旧版本中不可用,只能回退到读取与发送。
--agent superset会创建聊天会话,终端读取/发送无法控制。- Superset 不会自动合并各 worker 的分支。
- 完成与阻塞信封只出现在终端快照中,不是持久事件,格式异常时需人工检查完整输出。
- 页面默认持久且组织可见,发布前需征得用户同意。