SuperAPI AI 工具集

remote-environments

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:该技能用于在非软件工程场景下发现可用任务环境,并在用户指定环境或计算机、或提到其电脑上的文件与应用时创建或继续任务。软件工程相关工作(代码库调查、编码、调试、测试、产品 QA、PR/CI)不应使用本技能,应改用 $orbit:software-engineering。

主要能力:通过 cloud_threads.list_environments 读取两类集合——environments 中已有的用户计算机与已注册远程,以及 codingEnvironments 中个人与工作区共享的已保存编码配置。dot 云计算机独立存在,不包含在该列表中。

选择位置:除非用户指定环境或计算机、提到其电脑上的文件或应用、或浏览器工具文档要求本地浏览器回退,否则默认使用 dot 云计算机。仅请求云任务不会选择其他计算机。

创建任务:使用简短标题与自包含提示,包含目标结果、上下文、仓库或目录、约束与验证内容。子任务不继承当前对话。已有用户计算机或已注册远程需传非空 environmentId 且状态为 connected;已保存编码配置传其 id 作为 environmentConfigId,而非 version_id;用户计算机默认路径需省略两个选择器与 cwd,且恰好一台用户计算机已附加并连接。最多传一个环境选择器。

后续:创建成功即已附加任务,无需再次 attach。需要结果时用 cloud_threads.read,并用子任务完成通知跟踪进度,不要持续轮询。继续相关工作用 cloud_threads.send_message 保持同一 threadId。

限制:发现环境不会附加或连接计算机;连接状态不代表浏览器或应用能力,需让子任务先检查所需工具。请求的环境缺失、离线或不可用时,应说明具体阻塞原因并继续不依赖它的工作,不要静默切换环境。空编码目录仅表示未返回配置,不代表不存在。不要自动重复不确定的创建操作。