SuperAPI AI 工具集

orchestrate

编程与开发

查看项目

更新于 10-30 16:30

技能介绍

用途

本技能用于借助 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 的分支。
  • 完成与阻塞信封只出现在终端快照中,不是持久事件,格式异常时需人工检查完整输出。
  • 页面默认持久且组织可见,发布前需征得用户同意。